Java中如何用json传值

Java中如何用JSON传值：从基础到实践的完整指南

在Java开发中,JSON（JavaScript Object Notation）因其轻量级、易读性和跨语言特性，已成为前后端数据交互、API通信、配置文件存储等场景的主流数据格式，Java中JSON数据的处理方法，是开发者必备的技能，本文将从JSON的基础概念出发，详细讲解Java中如何使用JSON传值，包括常用库的选择、数据序列化与反序列化的实现、以及实际应用场景中的注意事项。

JSON与Java：为什么选择JSON？

JSON是一种基于文本的数据交换格式,以键值对（Key-Value）的形式组织数据，结构清晰（支持对象、数组、字符串、数字、布尔值和null），与XML相比，JSON更简洁，解析效率更高；与二进制格式（如Protocol Buffers）相比，JSON可读性更强，便于调试和日志记录。

在Java中,前后端交互时，后端通常将Java对象转换为JSON字符串返回给前端，前端再将JSON字符串解析为JavaScript对象；后端接收前端数据时，也需要将JSON字符串反序列化为Java对象，这个过程的核心就是序列化（Java对象→JSON字符串）和反序列化（JSON字符串→Java对象）。

Java中处理JSON的常用库

Java生态中有多个成熟的JSON处理库,以下是几个最常用的选择：

Jackson

特点：高性能、功能丰富，是Spring Framework默认的JSON处理库，支持注解自定义序列化/反序列化行为。

依赖引入（Maven）：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

Gson

特点：Google开发，API简洁易用，无需注解即可完成基本序列化/反序列化，支持复杂对象映射。

依赖引入（Maven）：

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

org.json

特点：轻量级，API直观，适合处理简单JSON数据，但功能相对前两者较弱。

依赖引入（Maven）：

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20231013</version>
</dependency>

推荐选择：

企业级应用或Spring项目：优先选Jackson（与Spring生态无缝集成）。
简单场景或需要快速开发：Gson（API友好）。
轻量级需求或无复杂依赖：org.json。

核心操作：序列化与反序列化

序列化：将Java对象转为JSON字符串

序列化是将Java对象转换为JSON字符串的过程,便于网络传输或存储。

（1）Jackson实现

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
// 定义Java类（POJO）
class User {
    private String name;
    private int age;
    private String email;
    // 无参构造器（Jackson反序列化时需要）
    public User() {}
    // 有参构造器
    public User(String name, int age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }
    // Getter和Setter（Jackson序列化/反序列化需要）
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
    @Override
    public String toString() {
        return "User{" + "name='" + name + '\'' + ", age=" + age + ", email='" + email + '\'' + '}';
    }
}
public class JacksonSerialization {
    public static void main(String[] args) {
        User user = new User("张三", 25, "zhangsan@example.com");
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 序列化为JSON字符串
            String jsonString = objectMapper.writeValueAsString(user);
            System.out.println("Jackson序列化结果：" + jsonString);
            // 输出：{"name":"张三","age":25,"email":"zhangsan@example.com"}
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

（2）Gson实现

import com.google.gson.Gson;
public class GsonSerialization {
    public static void main(String[] args) {
        User user = new User("李四", 30, "lisi@example.com");
        Gson gson = new Gson();
        // 序列化为JSON字符串
        String jsonString = gson.toJson(user);
        System.out.println("Gson序列化结果：" + jsonString);
        // 输出：{"name":"李四","age":30,"email":"lisi@example.com"}
    }
}

（3）org.json实现

import org.json.JSONObject;
public class OrgJsonSerialization {
    public static void main(String[] args) {
        // 直接通过JSONObject构建JSON
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("name", "王五");
        jsonObject.put("age", 28);
        jsonObject.put("email", "wangwu@example.com");
        // 转为JSON字符串
        String jsonString = jsonObject.toString();
        System.out.println("org.json序列化结果：" + jsonString);
        // 输出：{"name":"王五","age":28,"email":"wangwu@example.com"}
    }
}

反序列化：将JSON字符串转为Java对象

反序列化是将JSON字符串解析为Java对象的过程,便于后端处理前端或API传入的数据。

（1）Jackson实现

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Map;
public class JacksonDeserialization {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"赵六\",\"age\":35,\"email\":\"zhaoliu@example.com\"}";
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 反序列化为User对象
            User user = objectMapper.readValue(jsonString, User.class);
            System.out.println("Jackson反序列化结果：" + user);
            // 输出：User{name='赵六', age=35, email='zhaoliu@example.com'}
            // 反序列化为Map（适用于动态JSON结构）
            Map<String, Object> map = objectMapper.readValue(jsonString, new TypeReference<Map<String, Object>>() {});
            System.out.println("反序列化为Map：" + map);
            // 输出：反序列化为Map：{name=赵六, age=35, email=zhaoliu@example.com}
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

（2）Gson实现

import com.google.gson.Gson;
public class GsonDeserialization {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"钱七\",\"age\":40,\"email\":\"qianqi@example.com\"}";
        Gson gson = new Gson();
        // 反序列化为User对象
        User user = gson.fromJson(jsonString, User.class);
        System.out.println("Gson反序列化结果：" + user);
        // 输出：User{name='钱七', age=40, email='qianqi@example.com'}
    }
}

（3）org.json实现

import org.json.JSONObject;
public class OrgJsonDeserialization {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"孙八\",\"age\":45,\"email\":\"sunba@example.com\"}";
        JSONObject jsonObject = new JSONObject(jsonString);
        // 从JSONObject中获取字段值（需手动转换类型）
        String name = jsonObject.getString("name");
        int age = jsonObject.getInt("age");
        String email = jsonObject.getString("email");
        System.out.println("org.json解析结果：" + 
            "name=" + name + ", age=" + age + ", email=" + email);
        // 输出：org.json解析结果：name=孙八, age=45, email=sunba@example.com"
    }
}

进阶：复杂JSON结构的处理

实际开发中,JSON结构往往更复杂，如嵌套对象、数组、集合等，以下是处理复杂场景的示例：

嵌套对象与数组

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.List;
// 定义嵌套类
class Address {
    private String city;
    private String street;
    public Address(String city, String street) {
        this.city = city;
        this.street = street;
    }
    // Getter和Setter
    public String getCity() {

正文

Java中如何用json传值