在 Android 开发中,Activity 之间的通信是非常常见且核心的功能之一,常见的方式包括:
- 使用显式 Intent 传递数据
- 使用隐式 Intent 实现跨组件调用
- 使用 startActivityForResult(或新版 Activity Result API)回传数据
- 传递复杂数据(如 Serializable/Parcelable 对象)
下面将结合代码和具体使用场景,详细讲解这几种方式。
1. 使用显式 Intent 传递数据
场景说明
假设有两个界面:登录界面(LoginActivity)和主界面(MainActivity)。在登录成功后,LoginActivity 需要将用户信息传递给 MainActivity。
示例代码
LoginActivity.java:
public class LoginActivity extends AppCompatActivity {
// 模拟登录成功后传递数据
private void loginSuccess() {
// 假设我们获得了用户的用户名和ID
String username = "JohnDoe";
int userId = 123;
Intent intent = new Intent(LoginActivity.this, MainActivity.class);
// 将数据存入 Intent 的 Extras 里,Key-Value 方式
intent.putExtra("EXTRA_USERNAME", username);
intent.putExtra("EXTRA_USER_ID", userId);
// 启动 MainActivity
startActivity(intent);
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_login);
// 模拟登录按钮点击后进行登录操作
}
}
MainActivity.java:
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取启动该 Activity 的 Intent
Intent intent = getIntent();
if (intent != null) {
// 使用 getStringExtra、getIntExtra 等方法获取传递的数据
String username = intent.getStringExtra("EXTRA_USERNAME");
int userId = intent.getIntExtra("EXTRA_USER_ID", -1); // -1 为默认值
// 根据获得的数据执行后续逻辑,比如显示欢迎信息
TextView welcomeTextView = findViewById(R.id.welcomeTextView);
welcomeTextView.setText("欢迎 " + username + ", 你的用户ID是:" + userId);
}
}
}
原理说明
- Intent:用于启动另一个 Activity。通过
putExtra()
方法,可以将数据以键值对(Key-Value)的形式传递。 - Extras:在目标 Activity 中,通过
getIntent()
获取传递过来的 Intent,再通过相关的getXXXExtra()
方法获取数据。
2. 使用 startActivityForResult 回传数据
场景说明
有两个界面:A 页面和 B 页面。A 页面需要启动 B 页面获取用户的选择或输入,并在 B 页面关闭后拿到返回的数据。
示例代码
ActivityA.java:
public class ActivityA extends AppCompatActivity {
private static final int REQUEST_CODE = 1001;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_a);
Button openBButton = findViewById(R.id.openBButton);
openBButton.setOnClickListener(v -> {
// 启动 ActivityB 并等待返回结果
Intent intent = new Intent(ActivityA.this, ActivityB.class);
intent.putExtra("EXTRA_MESSAGE", "来自ActivityA的消息");
startActivityForResult(intent, REQUEST_CODE);
});
}
// 接收返回结果
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
// 从 data 中取出 B 页面回传的数据
String resultMessage = data.getStringExtra("RESULT_MESSAGE");
Toast.makeText(this, "返回信息:" + resultMessage, Toast.LENGTH_LONG).show();
}
}
}
ActivityB.java:
public class ActivityB extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_b);
// 获取 A 页面传递过来的数据
Intent intent = getIntent();
String message = intent.getStringExtra("EXTRA_MESSAGE");
// 显示 A 页面传过来的数据
TextView tvMessage = findViewById(R.id.tvMessage);
tvMessage.setText(message);
// 假设用户在此页面进行选择或输入
Button sendResultButton = findViewById(R.id.sendResultButton);
sendResultButton.setOnClickListener(v -> {
// 在退出当前页面之前,回传数据给 ActivityA
Intent data = new Intent();
data.putExtra("RESULT_MESSAGE", "这是来自ActivityB的回传数据");
setResult(RESULT_OK, data);
finish(); // 结束当前 Activity
});
}
}
原理说明
- startActivityForResult:在 ActivityA 中启动 ActivityB,同时传递一个请求码。
- setResult():在 ActivityB 中设置返回数据以及结果状态,然后调用
finish()
关闭当前 Activity。 - onActivityResult():ActivityA 重写该方法接收 B 页面返回的数据,其中请求码和结果码用来判断返回数据的合法性。
注意: 从 AndroidX 开始,官方推荐使用 Activity Result APIs 替代传统的
startActivityForResult
,该 API 更容易管理并能有效防止内存泄漏和其他生命周期相关问题。
3. 使用 Activity Result API(新版方式)
场景说明
与上面的例子类似,假设在 A 页面启动 B 页面获取用户数据,不过采用新版 API。
示例代码
ActivityA.java:
public class ActivityA extends AppCompatActivity {
// 注册 ActivityResultLauncher 用于启动另一个 Activity 并接收结果
private ActivityResultLauncher<Intent> launcher = registerForActivityResult(
new ActivityResultContracts.StartActivityForResult(),
result -> {
if (result.getResultCode() == Activity.RESULT_OK) {
Intent data = result.getData();
if (data != null) {
String resultMessage = data.getStringExtra("RESULT_MESSAGE");
Toast.makeText(ActivityA.this, "返回信息:" + resultMessage, Toast.LENGTH_LONG).show();
}
}
}
);
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_a);
Button openBButton = findViewById(R.id.openBButton);
openBButton.setOnClickListener(v -> {
Intent intent = new Intent(ActivityA.this, ActivityB.class);
launcher.launch(intent);
});
}
}
ActivityB.java:
代码与使用 startActivityForResult
的版本相同,设置结果并调用 finish()
完成返回操作。
4. 传递复杂数据(Serializable/Parcelable)
在实际应用中,有时需要传递不只是基本数据类型,而是自定义对象。这时可以让对象实现 Serializable
或 Parcelable
接口。
使用 Serializable 示例
User.java:
public class User implements Serializable {
private String name;
private int age;
// 构造器、getter 与 setter
public User(String name, int age) {
this.name = name;
this.age = age;
}
public String getName() { return name; }
public int getAge() { return age; }
}
传递数据示例:
// ActivityA 中
User user = new User("Alice", 28);
Intent intent = new Intent(ActivityA.this, ActivityB.class);
intent.putExtra("EXTRA_USER", user);
startActivity(intent);
// ActivityB 中
User user = (User) getIntent().getSerializableExtra("EXTRA_USER");
if (user != null) {
Log.d("ActivityB", "User Name: " + user.getName() + ", Age: " + user.getAge());
}
使用 Parcelable 示例
相比于 Serializable,Parcelable 的效率更高,因为它是专门为 Android 设计的序列化方案。编写 Parcelable 需要实现更多接口方法,但可以使用 Android Studio 插件自动生成代码。
public class User implements Parcelable {
private String name;
private int age;
// 构造器
public User(String name, int age) {
this.name = name;
this.age = age;
}
protected User(Parcel in) {
name = in.readString();
age = in.readInt();
}
public static final Creator<User> CREATOR = new Creator<User>() {
@Override
public User createFromParcel(Parcel in) {
return new User(in);
}
@Override
public User[] newArray(int size) {
return new User[size];
}
};
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel dest, int flags) {
dest.writeString(name);
dest.writeInt(age);
}
// getter 方法
public String getName() { return name; }
public int getAge() { return age; }
}
传递 Parcelable 对象:
// ActivityA 中传递对象
User user = new User("Bob", 35);
Intent intent = new Intent(ActivityA.this, ActivityB.class);
intent.putExtra("EXTRA_USER", user);
startActivity(intent);
// ActivityB 中接收对象
User user = getIntent().getParcelableExtra("EXTRA_USER");
if (user != null) {
Log.d("ActivityB", "User Name: " + user.getName() + ", Age: " + user.getAge());
}
5. 小结与使用建议
-
明确场景需求:
如果只是简单数据传递,使用基本类型的 extra 即可;如果需要回传结果,则采用 startActivityForResult 或新版 Activity Result API。 -
注意数据安全与优化:
大量数据或复杂对象传递时,尽量使用 Parcelable 来提升性能,同时避免在 Intent 中传递过大的数据(如大图片、文件等),推荐使用全局单例、数据库或文件方式传递数据。 -
代码维护和扩展:
将通信逻辑和数据传输封装成统一的工具类或使用第三方库(如 EventBus)可以降低耦合度,便于维护和扩展。