在Android应用开发中，Activity之间传递复杂数据结构，特别是自定义对象的`ArrayList`，是一个常见需求。本文将详细介绍如何利用流行的Gson库，通过JSON序列化和反序列化机制，简洁高效地实现将自定义对象列表从一个Activity传递到另一个Activity，避免了手动实现`Parcelable`或`Serializable`的繁琐。
引言：Activity间数据传递的挑战
Android的Intent机制允许在Activity之间传递基本数据类型或实现了Serializable或Parcelable接口的对象。然而，当需要传递一个包含自定义对象的ArrayList时，如果自定义对象没有实现这两个接口，直接传递会变得复杂。虽然可以通过让自定义对象实现Parcelable接口来解决，但这通常需要编写额外的模板代码，增加了开发负担。
为了简化这一过程，我们可以借助强大的JSON处理库——Gson。Gson能够将Java对象转换为JSON字符串，反之亦然，从而使复杂对象可以通过Intent以字符串形式进行传递。
核心工具：Gson库
Gson是Google提供的一个Java库，用于在Java对象和JSON数据之间进行序列化和反序列化。它的优点在于使用简单、功能强大，能够自动处理大多数Java对象的转换。
1. 添加Gson依赖
首先，在您的Android项目的app/build.gradle文件中添加Gson库的依赖：
dependencies {
implementation 'com.google.code.gson:gson:2.10.1' // 使用最新版本
}然后同步项目，使依赖生效。
2. 定义自定义对象类
假设我们有一个名为ListeJoueurs的自定义对象，它包含多个字段，如姓名、年龄、许可证号等。这个类不需要实现Serializable或Parcelable接口，Gson会直接处理它。
import java.io.Serializable; // 尽管Gson不需要，但如果将来有其他序列化需求，可以考虑添加
public class ListeJoueurs {
String Nom;
String Prenom;
Long Licence;
String Cat;
String Select;
String dteN;
int imageClick;
// 构造函数
public ListeJoueurs(String Nom, String Prenom, Long Licence, String Cat, String Select, String dteN, int imageClick) {
this.Nom = Nom;
this.Prenom = Prenom;
this.Licence = Licence;
this.Cat = Cat;
this.Select = Select;
this.dteN = dteN;
this.imageClick = imageClick;
}
// Getter方法 (可选，但推荐添加，方便数据访问)
public String getNom() { return Nom; }
public String getPrenom() { return Prenom; }
public Long getLicence() { return Licence; }
public String getCat() { return Cat; }
public String getSelect() { return Select; }
public String getDteN() { return dteN; }
public int getImageClick() { return imageClick; }
// toString方法 (用于调试或打印对象信息)
@Override
public String toString() {
return "ListeJoueurs{" +
"Nom='" + Nom + '\'' +
", Prenom='" + Prenom + '\'' +
", Licence=" + Licence +
", Cat='" + Cat + '\'' +
", Select='" + Select + '\'' +
", dteN='" + dteN + '\'' +
", imageClick=" + imageClick +
'}';
}
}传递数据：从发送Activity到接收Activity
1. 在发送Activity中序列化并传递数据
在源Activity中，我们将创建ArrayList<ListeJoueurs>，然后使用Gson将其转换为JSON字符串，并通过Intent传递。
import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import com.google.gson.Gson;
import java.util.ArrayList;
public class SenderActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_sender); // 假设您有一个布局文件
Button sendButton = findViewById(R.id.send_data_button); // 假设有一个按钮触发发送
sendButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
// 1. 创建 ArrayList<ListeJoueurs> 实例
ArrayList<ListeJoueurs> joueursList = new ArrayList<>();
joueursList.add(new ListeJoueurs("Messi", "Lionel", 10L, "Forward", "Active", "1987-06-24", R.drawable.ic_launcher_foreground));
joueursList.add(new ListeJoueurs("Ronaldo", "Cristiano", 7L, "Forward", "Active", "1985-02-05", R.drawable.ic_launcher_background));
// 添加更多对象...
// 2. 使用 Gson 将 ArrayList 转换为 JSON 字符串
Gson gson = new Gson();
String jsonJoueursList = gson.toJson(joueursList);
// 3. 创建 Intent 并将 JSON 字符串放入 extra
Intent intent = new Intent(SenderActivity.this, ReceiverActivity.class);
intent.putExtra("KEY_JOUEURS_LIST", jsonJoueursList); // "KEY_JOUEURS_LIST" 是一个自定义的键
// 4. 启动目标 Activity
startActivity(intent);
}
});
}
}2. 在接收Activity中接收并反序列化数据
在目标Activity中，我们将从Intent中获取JSON字符串，然后使用Gson将其反序列化回ArrayList<ListeJoueurs>。
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.ArrayList;
public class ReceiverActivity extends AppCompatActivity {
private TextView receivedDataTextView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_receiver); // 假设您有一个布局文件
receivedDataTextView = findViewById(R.id.received_data_text_view); // 假设有一个TextView显示数据
// 1. 获取 Intent
Intent intent = getIntent();
if (intent != null && intent.hasExtra("KEY_JOUEURS_LIST")) {
// 2. 从 Intent extra 中获取 JSON 字符串
String jsonJoueursList = intent.getStringExtra("KEY_JOUEURS_LIST");
// 3. 使用 Gson 将 JSON 字符串反序列化回 ArrayList<ListeJoueurs>
Gson gson = new Gson();
Type listType = new TypeToken<ArrayList<ListeJoueurs>>(){}.getType(); // 关键：指定泛型列表的类型
ArrayList<ListeJoueurs> joueursList = gson.fromJson(jsonJoueursList, listType);
// 4. 处理接收到的数据
if (joueursList != null && !joueursList.isEmpty()) {
StringBuilder sb = new StringBuilder("接收到的球员列表:\n");
for (ListeJoueurs joueur : joueursList) {
sb.append(joueur.toString()).append("\n");
}
receivedDataTextView.setText(sb.toString());
} else {
receivedDataTextView.setText("未接收到球员数据或列表为空。");
}
} else {
receivedDataTextView.setText("Intent中没有找到球员列表数据。");
}
}
}注意事项：
- 在反序列化泛型集合（如ArrayList<ListeJoueurs>）时，必须使用TypeToken来获取正确的Type，否则Gson可能无法正确解析泛型信息。
- 传递的数据量过大可能会导致TransactionTooLargeException。虽然JSON字符串通常比直接传递对象占用空间小，但如果列表包含成千上万个复杂对象，仍需考虑此限制。对于超大数据量，建议使用数据库、文件存储或单例模式等方式进行传递。
- 务必在接收Activity中对Intent和其extra进行空值检查，以避免NullPointerException。
总结
通过引入Gson库，我们能够以一种优雅且高效的方式解决Android Activity间传递自定义对象ArrayList的问题。这种方法避免了为每个自定义类手动实现Parcelable或Serializable接口的复杂性，大大简化了开发流程。在实际项目中，Gson因其简洁性和强大功能，成为处理JSON数据和对象序列化/反序列化的首选工具之一。
