spring如何把json

Spring框架中JSON数据的处理：从序列化到反序列化的全面解析**

在现代Web开发中,JSON（JavaScript Object Notation）已成为前后端数据交换的事实标准，Spring框架作为Java生态中最流行的开发框架之一，对JSON的处理提供了强大而灵活的支持，无论是将Java对象转换为JSON响应给前端，还是将前端传来的JSON请求体转换为Java对象，Spring都能轻松应对，本文将探讨Spring框架中处理JSON的多种方式，从传统的注解到现代化的响应式编程，帮助开发者全面理解和应用。

核心概念：序列化与反序列化

在了解Spring如何处理JSON之前,我们首先需要明确两个核心概念：

序列化（Serialization）：将Java对象转换为JSON字符串的过程，这样，对象就可以在网络中传输或存储在文本文件中。
反序列化（Deserialization）：将JSON字符串转换回Java对象的过程，这使得后端能够接收前端发送的JSON数据，并将其转换为业务逻辑可用的Java对象。

Spring框架主要通过集成Jackson、Gson或JSON-B等库来实现这些功能，其中Jackson是Spring Boot默认且最常用的JSON处理库。

Spring Boot中的默认JSON支持：Jackson

Spring Boot Starter Web依赖自动包含了jackson-databind库，这使得我们无需额外配置即可在Spring应用中使用JSON。

将Java对象序列化为JSON响应（@ResponseBody）

当Controller方法需要返回一个Java对象,并且希望该对象被直接转换为JSON格式作为HTTP响应体时，可以使用@ResponseBody注解（在Spring 4.0后，推荐使用@RestController，它默认包含了@ResponseBody的功能）。

示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class UserController {
    @GetMapping("/users/1")
    public User getUser() {
        User user = new User(1L, "张三", "zhangsan@example.com");
        return user; // Spring会自动将user对象转换为JSON
    }
}
// 假设User类如下
class User {
    private Long id;
    private String name;
    private String email;
    // 构造方法、getter和setter省略
    // 为了序列化成功，通常需要无参构造方法
}

当访问/users/1接口时，Spring会自动调用Jackson的ObjectMapper将User对象序列化为类似{"id":1,"name":"张三","email":"zhangsan@example.com"}的JSON字符串。

将JSON请求体反序列化为Java对象（@RequestBody）

当Controller方法需要接收HTTP请求体中的JSON数据,并将其转换为Java对象时，可以使用@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("/users")
    public String createUser(@RequestBody User user) {
        // 处理user对象，例如保存到数据库
        System.out.println("收到用户创建请求：" + user.getName());
        return "用户创建成功，ID: " + user.getId();
    }
    // User类同上
}

当客户端发送POST请求到/users，并在请求体中携带JSON数据如{"id":2,"name":"李四","email":"lisi@example.com"}时，Spring会自动调用Jackson将JSON字符串反序列化为User对象，并传递给createUser方法。

Jackson常用注解定制JSON处理

虽然Jackson默认的序列化和反序列化行为已经能满足大部分需求,但有时我们需要对JSON的格式进行定制，Jackson提供了丰富的注解来实现这一点。

常用注解包括：

@JsonProperty: 用于指定Java对象属性与JSON字段之间的映射关系，可以解决命名不一致（如下划线转驼峰）的问题。
@JsonIgnore: 用于在序列化或反序列化时忽略某个属性。
@JsonIgnoreProperties: 用于在类级别上忽略一组未知的属性或指定的属性。
@JsonFormat: 用于指定日期、时间等类型的格式化方式。
@JsonView: 用于实现多视图序列化，根据不同场景返回不同的JSON数据。

示例：

import com.fasterxml.jackson.annotation.*;
@JsonInclude(JsonInclude.Include.NON_NULL) // 为null的属性不参与序列化
public class Product {
    @JsonProperty("product_id") // 指定JSON字段名为product_id
    private Long id;
    @JsonProperty("product_name")
    private String name;
    @JsonIgnore // 忽略price属性
    private Double price;
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss") // 格式化日期
    private Date createTime;
    // 构造方法、getter和setter省略
}

配置Jackson ObjectMapper

Spring Boot允许我们通过配置文件或Java代码来定制ObjectMapper的行为，例如修改日期格式、设置属性命名策略等。

通过application.properties/yml配置：

# 设置日期格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
# 属性命名策略，下划线转驼峰
spring.jackson.property-naming-strategy=SNAKE_CASE
# 空值不参与序列化
spring.jackson.default-property-inclusion=non_null

通过Java Bean配置：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;
@Configuration
public class JacksonConfig {
    @Bean
    public ObjectMapper objectMapper(Jackson2ObjectMapperBuilder builder) {
        ObjectMapper objectMapper = builder.createXmlMapper(false).build();
        // 自定义配置
        // objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
        // objectMapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
        return objectMapper;
    }
}

使用其他JSON库

虽然Jackson是默认选择,但Spring也支持Gson和JSON-B（如Yasson）等其他JSON库。

使用Gson：

排除Jackson依赖,添加Gson依赖：

<!-- pom.xml -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
</dependency>

配置Spring使用Gson：

import com.google.gson.Gson;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.GsonHttpMessageConverter;
@Configuration
public class GsonConfig {
    @Bean
    public GsonHttpMessageConverter gsonHttpMessageConverter() {
        GsonHttpMessageConverter converter = new GsonHttpMessageConverter();
        converter.setGson(new Gson());
        return converter;
    }
}

配置完成后,@ResponseBody和@RequestBody就会使用Gson进行JSON处理。

Spring WebFlux中的JSON处理

在Spring WebFlux（响应式编程模型）中，JSON处理方式与传统的Spring MVC类似，但底层使用的是reactor-core或RxJava等响应式流，并且默认的JSON库也是Jackson。

@ResponseBody和@RequestBody同样适用，只不过方法返回值可能是Mono<T>或Flux<T>，参数也可能被包装在响应式类型中。

示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;
@RestController
public class ReactiveUserController {
    @GetMapping("/reactive/users/1")
    public Mono<User> getReactiveUser() {
        User user = new User(1L, "王五", "wangwu@example.com");
        return Mono.just(user); // 返回Mono<T>，Spring会自动序列化
    }
}

Spring框架对JSON的支持是全面且强大的,通过集成Jackson等库，并结合@ResponseBody、@RequestBody以及丰富的Jackson注解，开发者可以轻松实现Java对象与JSON数据之间的双向转换，Spring Boot的自动配置大大简化了初始设置，而灵活的配置选项又满足了各种定制化需求，无论是传统的Spring MVC应用，还是现代化的响应式Web应用，Spring都能提供高效、便捷的JSON处理方案，这些技巧，将能显著提升开发效率和应用性能。

快连

快连下载

快连官网

快连电脑版

快连下载

快连登录