当前位置：首页 > 文章列表 > 文章 > java教程 > Gson传递自定义对象列表教程详解

Gson传递自定义对象列表教程详解

2025-12-13 20:54:36 0浏览收藏

从现在开始，我们要努力学习啦！今天我给大家带来《Gson高效传递自定义对象列表教程》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

利用Gson在Android Activity间高效传递自定义对象列表

在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，然后使用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。

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）时，必须使用TypeToken来获取正确的Type，否则Gson可能无法正确解析泛型信息。
传递的数据量过大可能会导致TransactionTooLargeException。虽然JSON字符串通常比直接传递对象占用空间小，但如果列表包含成千上万个复杂对象，仍需考虑此限制。对于超大数据量，建议使用数据库、文件存储或单例模式等方式进行传递。
务必在接收Activity中对Intent和其extra进行空值检查，以避免NullPointerException。

总结

通过引入Gson库，我们能够以一种优雅且高效的方式解决Android Activity间传递自定义对象ArrayList的问题。这种方法避免了为每个自定义类手动实现Parcelable或Serializable接口的复杂性，大大简化了开发流程。在实际项目中，Gson因其简洁性和强大功能，成为处理JSON数据和对象序列化/反序列化的首选工具之一。

以上就是《Gson传递自定义对象列表教程详解》的详细内容，更多关于的资料请关注golang学习网公众号！