java里json传值怎么传

Java中JSON传值的完整指南：从基础到实战

在Java开发中，JSON（JavaScript Object Notation）因其轻量级、易读、跨语言的特点，已成为前后端数据交互的主流格式，无论是前端向后端发送请求参数，还是后端向前端返回响应数据，都离不开JSON传值的操作，本文将系统介绍Java中JSON传值的实现方式，包括常用库的选择、数据转换方法、实战场景及注意事项,帮助开发者这一核心技能。

为什么选择JSON传值？

在Java中，传统传值方式可能存在以下痛点：

• XML：冗余标签多，解析复杂，传输效率低；
• Properties：仅支持键值对，无法表示复杂数据结构；
• 自定义序列化：需要手动处理二进制流，可维护性差。

JSON通过键值对（"key": value）和嵌套结构灵活表示对象、数组、字符串等数据，且可直接被JavaScript解析,完美契合前后端分离架构的需求。

选择合适的JSON处理库

Java生态中，主流的JSON库有 Jackson、Gson、Fastjson（阿里巴巴开源），三者各有优劣：

推荐：若使用Spring Boot，优先选择Jackson；若需简单易用的工具，选Gson；Fastjson需谨慎使用（建议使用最新版并做好安全防护）。

核心操作：Java对象与JSON的互转

JSON传值的核心是将Java对象序列化为JSON字符串（传给前端），或将JSON字符串反序列化为Java对象（接收前端数据），以下以最常用的Jackson和Gson为例,说明具体操作。

使用Jackson实现互转

Jackson是Spring Boot默认的JSON库，通过ObjectMapper类完成转换。

（1）添加依赖（Maven）

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

（2）Java对象转JSON字符串（序列化）

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
// 定义Java对象（POJO）
class User {
    private String name;
    private int age;
    private String[] hobbies;
    // 必须提供无参构造器（反序列化时需要）
    public User() {}
    // getter/setter
    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[] getHobbies() { return hobbies; }
    public void setHobbies(String[] hobbies) { this.hobbies = hobbies; }
}
public class JacksonExample {
    public static void main(String[] args) throws JsonProcessingException {
        User user = new User();
        user.setName("张三");
        user.setAge(25);
        user.setHobbies(new String[]{"篮球", "编程"});
        ObjectMapper mapper = new ObjectMapper();
        String jsonString = mapper.writeValueAsString(user);
        System.out.println(jsonString); 
        // 输出：{"name":"张三","age":25,"hobbies":["篮球","编程"]}
    }
}

（3）JSON字符串转Java对象（反序列化）

String jsonString = "{\"name\":\"李四\",\"age\":30,\"hobbies\":\"阅读,旅行\"}";
ObjectMapper mapper = new ObjectMapper();
User user = mapper.readValue(jsonString, User.class);
System.out.println(user.getName()); // 输出：李四
System.out.println(user.getAge());  // 输出：30

使用Gson实现互转

Gson由Google开发，API更简洁,适合快速开发。

（1）添加依赖（Maven）

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

（2）Java对象转JSON字符串（序列化）

import com.google.gson.Gson;
public class GsonExample {
    public static void main(String[] args) {
        User user = new User();
        user.setName("王五");
        user.setAge(28);
        user.setHobbies(new String[]{"音乐", "摄影"});
        Gson gson = new Gson();
        String jsonString = gson.toJson(user);
        System.out.println(jsonString); 
        // 输出：{"name":"王五","age":28,"hobbies":["音乐","摄影"]}
    }
}

（3）JSON字符串转Java对象（反序列化）

String jsonString = "{\"name\":\"赵六\",\"age\":22,\"hobbies\":\"游戏,动漫\"}";
Gson gson = new Gson();
User user = gson.fromJson(jsonString, User.class);
System.out.println(user.getName()); // 输出：赵六
System.out.println(user.getAge());  // 输出：22

处理复杂数据结构（嵌套对象、List、Map）

实际开发中，数据往往更复杂（如嵌套对象、集合）。

class Address {
    private String city;
    private String street;
    // getter/setter
}
class UserProfile {
    private User user;
    private List<String> tags;
    private Map<String, Object> extraInfo;
    // getter/setter
}

序列化示例（Jackson）：

UserProfile profile = new UserProfile();
profile.setUser(user); // user为上述User对象
profile.setTags(Arrays.asList("VIP", "活跃用户"));
profile.setExtraInfo(new HashMap<>() {{
    put("registerTime", "2023-01-01");
    put("score", 95.5);
}});
ObjectMapper mapper = new ObjectMapper();
String json = mapper.writeValueAsString(profile);
// 输出：{"user":{"name":"张三","age":25...},"tags":["VIP","活跃用户"],"extraInfo":{"registerTime":"2023-01-01","score":95.5}}

反序列化时，只需目标类字段与JSON键名一致,即可自动映射。

实战场景：前后端JSON传值

后端接收前端JSON数据（Spring Boot示例）

前端通过POST请求发送JSON数据，后端用@RequestBody注解接收：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
    @PostMapping("/user")
    public String createUser(@RequestBody User user) {
        // 处理user数据（如保存到数据库）
        System.out.println("接收到用户：" + user.getName());
        return "用户创建成功，ID：" + System.currentTimeMillis();
    }
}

请求示例（Postman）：

• Method: POST
• URL: http://localhost:8080/user
• Body: raw → JSON

  {
      "name": "张三",
      "age": 25,
      "hobbies": ["篮球", "编程"]
  }

后端向前端返回JSON数据

后端直接返回Java对象，Spring Boot会自动通过Jackson序列化为JSON：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
    @GetMapping("/user/1")
    public User getUser() {
        User user = new User();
        user.setName("李四");
        user.setAge(30);
        user.setHobbies(new String[]{"阅读", "旅行"});
        return user; // 自动序列化为JSON
    }
}

响应结果：

{
    "name": "李四",
    "age": 30,
    "hobbies": ["阅读", "旅行"]
}

注意事项与最佳实践

1. 字段命名规范
   JSON默认使用驼峰命名（如userName），若Java字段是下划线（user_name），可通过注解解决：

   • Jackson: @JsonProperty("user_name")
   • Gson: @SerializedName("user_name")

2. 日期处理
   默认日期格式可能不符合需求（如输出时间戳），需自定义格式：

   // Jackson全局配置
   ObjectMapper mapper = new ObjectMapper();
   mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm