首页 > Java > java教程 > 正文

Android Activity间传递自定义对象列表:使用Gson库实现

聖光之護
发布: 2025-11-30 17:40:31
原创
513人浏览过

android activity间传递自定义对象列表:使用gson库实现

本教程详细介绍了如何在Android应用中,利用Gson库在不同Activity之间高效传递`ArrayList`。文章首先阐述了Intent直接传递复杂对象时面临的挑战,随后深入讲解了Gson的工作原理和具体实现步骤,包括添加依赖、数据类的准备、发送Activity中的序列化以及接收Activity中的反序列化,并提供了完整的示例代码和注意事项,旨在帮助开发者掌握一种简洁可靠的复杂数据传递方案。

在Android应用开发中,Activity之间的数据传递是常见的需求。对于基本数据类型,Intent的putExtra()方法可以直接处理。然而,当需要传递复杂数据结构,如自定义对象的ArrayList时,直接使用Intent会遇到一些限制。本文将详细介绍如何利用流行的Gson库,以一种高效且易于维护的方式,在不同Activity间传递ArrayList<自定义对象>。

Android Activity间复杂对象传递的挑战

Intent在传递非基本数据类型时,通常要求对象实现Serializable或Parcelable接口。Serializable是Java标准接口,实现简单但效率较低,因为它使用反射进行序列化。Parcelable是Android特有的接口,性能更优,但实现起来相对复杂,需要手动写入和读取Parcel数据。

对于ArrayList<自定义对象>这种集合类型,如果自定义对象本身实现了Serializable或Parcelable,Intent可以传递ArrayList。然而,为了避免为每个自定义类都手动实现这些接口,特别是当类结构复杂或数量众多时,寻找一种更通用的序列化方案变得尤为重要。

使用Gson库进行对象序列化与反序列化

Gson是由Google提供的一个Java库,用于在Java对象和JSON数据之间进行序列化和反序列化。它的主要优势在于使用简单、性能良好,并且能够处理复杂的嵌套对象和集合类型,而无需自定义类实现特定的序列化接口。

Gson的工作原理是将Java对象转换为JSON格式的字符串,或者将JSON字符串转换回Java对象。这种方式非常适合在Activity之间传递数据,因为JSON字符串可以作为普通的String类型通过Intent进行传递。

实现步骤详解

以下是使用Gson在Activity之间传递ArrayList<自定义对象>的具体步骤。

步骤一:添加Gson依赖

首先,在您的Android项目的app/build.gradle文件中添加Gson库的依赖。

dependencies {
    implementation 'com.google.code.gson:gson:2.10.1' // 使用最新稳定版本
}
登录后复制

添加后,同步Gradle项目。

步骤二:定义自定义数据类

确保您的自定义数据类(例如ListeJoueurs)是标准的Java类,包含您需要传递的字段和相应的构造函数。对于Gson而言,您无需让此类实现Serializable或Parcelable接口。

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和setter方法,Gson在反序列化时通常会使用无参构造函数和setter,
    // 但如果只有带参构造函数且字段名与JSON匹配,Gson也能良好工作。
    // 为了更好的实践,建议提供无参构造函数和getter/setter。
    public String getNom() { return Nom; }
    public void setNom(String nom) { Nom = nom; }
    // ... 其他字段的getter/setter

    @Override
    public String toString() {
        return "ListeJoueurs{" +
               "Nom='" + Nom + '\'' +
               ", Prenom='" + Prenom + '\'' +
               ", Licence=" + Licence +
               ", Cat='" + Cat + '\'' +
               ", Select='" + Select + '\'' +
               ", dteN='" + dteN + '\'' +
               ", imageClick=" + imageClick +
               '}';
    }
}
登录后复制

步骤三:在发送Activity中传递ArrayList<自定义对象>

在发送数据的Activity中,您需要将ArrayList<ListeJoueurs>转换为JSON字符串,然后通过Intent的putExtra()方法传递。

讯飞开放平台
讯飞开放平台

科大讯飞推出的以语音交互技术为核心的AI开放平台

讯飞开放平台 152
查看详情 讯飞开放平台
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("张", "三", 1001L, "青年", "是", "2000-01-01", 0));
                joueursList.add(new ListeJouurs("李", "四", 1002L, "成年", "否", "1990-05-15", 1));
                joueursList.add(new ListeJoueurs("王", "五", 1003L, "老年", "是", "1960-11-20", 0));

                // 2. 初始化 Gson 对象
                Gson gson = new Gson();

                // 3. 将 ArrayList 转换为 JSON 字符串
                String jsonJoueursList = gson.toJson(joueursList);

                // 4. 创建 Intent 并将 JSON 字符串放入其中
                Intent intent = new Intent(SenderActivity.this, ReceiverActivity.class);
                intent.putExtra("JOUER_LIST_KEY", jsonJoueursList); // "JOUER_LIST_KEY" 是自定义的键

                // 5. 启动目标 Activity
                startActivity(intent);
            }
        });
    }
}
登录后复制

步骤四:在接收Activity中获取ArrayList<自定义对象>

在接收数据的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; // 引入 TypeToken
import java.lang.reflect.Type; // 引入 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);

        // 1. 从 Intent 中获取 JSON 字符串
        String jsonJoueursList = getIntent().getStringExtra("JOUER_LIST_KEY");

        if (jsonJoueursList != null && !jsonJoueursList.isEmpty()) {
            // 2. 初始化 Gson 对象
            Gson gson = new Gson();

            // 3. 定义 ArrayList<ListeJoueurs> 的 Type
            // 这是反序列化泛型集合的关键步骤
            Type listType = new TypeToken<ArrayList<ListeJoueurs>>(){}.getType();

            // 4. 将 JSON 字符串反序列化回 ArrayList<ListeJoueurs>
            ArrayList<ListeJoueurs> receivedList = gson.fromJson(jsonJoueursList, listType);

            // 5. 处理接收到的数据
            if (receivedList != null && !receivedList.isEmpty()) {
                StringBuilder sb = new StringBuilder("接收到的玩家列表:\n");
                for (ListeJoueurs joueur : receivedList) {
                    sb.append(joueur.toString()).append("\n");
                }
                receivedDataTextView.setText(sb.toString());
            } else {
                receivedDataTextView.setText("接收到的列表为空或解析失败。");
            }
        } else {
            receivedDataTextView.setText("未接收到玩家列表数据。");
        }
    }
}
登录后复制

示例代码

为了完整演示,我们假设有以下布局文件:

activity_sender.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center">

    <Button
        android:id="@+id/send_data_button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="发送玩家列表到另一个Activity" />

</LinearLayout>
登录后复制

activity_receiver.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <TextView
        android:id="@+id/received_data_text_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:textSize="16sp"
        android:text="等待接收数据..." />

</LinearLayout>
登录后复制

注意事项与最佳实践

  1. 性能考量:

    • 对于非常大的数据集(例如包含数千个复杂对象的列表),将它们序列化为JSON字符串并放入Intent可能会导致性能问题,因为Intent的传输大小有限制,且字符串处理本身有开销。在这种情况下,可以考虑其他方案,如将数据存储在单例对象、Application类、数据库或共享偏好设置中,然后在目标Activity中直接访问。
    • Parcelable通常比Serializable和Gson(对于Activity间直接传输而言)在Android上性能更好,因为它避免了反射并且针对Android的IPC机制进行了优化。如果性能是关键因素,且数据结构稳定,可以考虑实现Parcelable。
  2. 错误处理:

    • 在接收Activity中,务必对从Intent获取的JSON字符串进行空值检查。
    • Gson的fromJson()方法在JSON格式不正确或与目标Java对象结构不匹配时可能会抛出JsonSyntaxException。在实际应用中,建议使用try-catch块捕获此类异常,以增强应用的健壮性。
  3. 数据类设计:

    • 为了Gson的良好工作,自定义数据类中的字段名应与JSON键名匹配。
    • 建议为数据类提供一个无参构造函数,尽管Gson在某些情况下可以处理只有带参构造函数的情况,但无参构造函数能提供更好的兼容性。
    • 为字段提供公共的getter和setter方法是一个好习惯,这有助于Gson进行序列化和反序列化。
  4. 键值管理:

    • 用于Intent.putExtra()和getIntent().getStringExtra()的键(例如"JOUER_LIST_KEY")应定义为常量,以避免拼写错误和提高代码的可维护性。

总结

通过Gson库,Android开发者可以非常方便地在Activity之间传递复杂的自定义对象列表。这种方法避免了手动实现Serializable或Parcelable的繁琐,使得数据传递逻辑更加简洁和易于理解。在大多数场景下,Gson提供的JSON序列化方案是处理Activity间复杂数据传递的有效且推荐的方式。然而,在面对极端性能要求或超大数据集时,开发者也应考虑其他替代方案。

以上就是Android Activity间传递自定义对象列表:使用Gson库实现的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号