21 网络访问之解析JSON数据

在上一章中，我们学习了如何使用Retrofit进行网络请求，这为我们的安卓应用提供了一种简单而强大的解决方案。现在，我们将深入了解如何解析从服务端获取的JSON数据，以便将其转换为我们可以在应用中使用的对象。

JSON数据结构简介

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，易于人类阅读和编写，同时也易于机器解析和生成。一般来说，JSON数据的结构是基于键值对的，示例结构如下：

{
  "user": {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com"
  },
  "posts": [
    {
      "id": 1,
      "title": "Hello World",
      "content": "This is my first post."
    },
    {
      "id": 2,
      "title": "Another Post",
      "content": "This is another post."
    }
  ]
}

在本章中，我们将讨论如何使用Gson库来解析以上格式的JSON数据。

添加依赖

首先，我们需要在项目的build.gradle文件中添加Gson库的依赖。在dependencies块中添加以下内容：

implementation 'com.google.code.gson:gson:2.8.9'

确保您同步了项目以下载这个库。

创建数据模型

解析JSON数据时，我们需要对应的Java类来映射JSON结构。上述示例中的user和posts可以定义如下模型：

public class User {
    private int id;
    private String name;
    private String email;

    // Getters和Setters
}

public class Post {
    private int id;
    private String title;
    private String content;

    // Getters和Setters
}

public class ResponseData {
    private User user;
    private List<Post> posts;

    // Getters和Setters
}

解析JSON数据

接下来，我们将展示如何使用Gson解析从Retrofit请求获取的JSON数据。我们假定已经配置了Retrofit并可以获取JSON响应。

示例

以下是一个从Retrofit获取数据并解析JSON的完整示例：

import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;
import com.google.gson.Gson;

public class ApiService {

    // Retrofit基础设置
    private static final String BASE_URL = "https://api.example.com/";
    private Retrofit retrofit;

    public ApiService() {
        retrofit = new Retrofit.Builder()
                .baseUrl(BASE_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
    }

    public void getUserData() {
        MyApi api = retrofit.create(MyApi.class);
        Call<ResponseData> call = api.getUserData();
        call.enqueue(new Callback<ResponseData>() {
            @Override
            public void onResponse(Call<ResponseData> call, Response<ResponseData> response) {
                if (response.isSuccessful()) {
                    ResponseData data = response.body();
                    if (data != null) {
                        User user = data.getUser();
                        List<Post> posts = data.getPosts();
                        // 处理数据
                        System.out.println(user.getName());
                        for (Post post : posts) {
                            System.out.println(post.getTitle());
                        }
                    }
                }
            }

            @Override
            public void onFailure(Call<ResponseData> call, Throwable t) {
                t.printStackTrace();
            }
        });
    }
}

在这个例子中，我们首先通过Retrofit发起了一个网络请求，获得了ResponseData对象。然后，我们可以直接调用getUser()和getPosts()方法来访问User和Post数据。

小结

在本章节中，我们学习了如何使用Gson库解析从网络请求返回的JSON数据。通过一个具体的案例，我们演示了如何将JSON数据映射到我们的数据模型上，以及如何在应用中使用这些数据。理解JSON的结构和如何将其映射到对象是后续使用OkHttp进行网络请求时将要涉及的关键知识。

接下来章节将讨论如何使用OkHttp库进行网络请求，以及如何处理类似的JSON数据解析过程。