江帅帅：精通 Spring Boot 系列 05

关注
发布于: 2020 年 06 月 17 日
Spring Boot 处理 JSON 数据JSON 是目前主流的前后端数据传输方式，当 Controller 中返回的是一个 Java 对象或 List 集合时，Spring Boot 将自动把它转换成 JSON 数据。
Spring Boot 中内置了 JSON 解析功能，当你在项目中，添加了 spring-boot-starter-web 模块之后，即可看到默认包含 Jackson 解析器，也可以换成 Fastjson 等其他解析器。
1. 编辑 Book 类
public class Book {
﻿
﻿
﻿
    private Integer id;
﻿
    private String name;
﻿
    private String author;
﻿
    @JsonIgnore
﻿
    private Float price;
﻿
    @JsonFormat(pattern = "yyyy-MM-dd")
﻿
    private Date bookPublicationDate;
﻿
﻿
﻿
    // getter 和 setter 方法
﻿
}
2. 编辑 BookController 返回数据的时候，需要使用 @ResponseBody 注解。如果经常使用 @Controller 和 @ResponseBody 注解，则可以使用 @RestController 组合注解来替代。
@RestController
﻿
public class BookController {
﻿
﻿
﻿
    @GetMapping("/book")
﻿
    public Book book(){
﻿
        Book book = new Book();
﻿
        book.setId(1);
﻿
        book.setName("《码农翻身：用故事给技术加点料》");
﻿
        book.setAuthor("刘欣");
﻿
        book.setPrice(69f);
﻿
        book.setBookPublicationDate(new Date());
﻿
﻿
﻿
        return book;
﻿
    }
﻿
}
运行之后，直接地址栏中访问 http://localhost:8080/book，即可看到返回的 JSON 数据。
﻿
3. 转换集合数据添加 getBooks() 方法，创建一个 List 集合，存放三本书。具体源码如下：
@RequestMapping("/getBooks")
﻿
public List<Book> getBooks() {
﻿
﻿
﻿
    List<Book> bookList = new ArrayList<>();
﻿
﻿
﻿
    Book book1 = new Book();
﻿
    book1.setId(1);
﻿
    book1.setName("《码农翻身：用故事给技术加点料》");
﻿
    book1.setAuthor("刘欣");
﻿
    book1.setPrice(69f);
﻿
    book1.setBookPublicationDate(new Date());
﻿
﻿
﻿
    Book book2 = new Book();
﻿
    book2.setId(2);
﻿
    book2.setName("《漫画算法：小灰的算法之旅（全彩）》");
﻿
    book2.setAuthor("魏梦舒");
﻿
    book2.setPrice(79f);
﻿
    book2.setBookPublicationDate(new Date());
﻿
﻿
﻿
    Book book3 = new Book();
﻿
    book3.setId(3);
﻿
    book3.setName("《未来架构》");
﻿
    book3.setAuthor("张亮");
﻿
    book3.setPrice(99f);
﻿
    book3.setBookPublicationDate(new Date());
﻿
﻿
﻿
    bookList.add(book1);
﻿
    bookList.add(book2);
﻿
    bookList.add(book3);
﻿
﻿
﻿
    return bookList;
﻿
}
运行之后，直接地址栏中访问 http://localhost:8080/getBooks，即可看到 getBooks() 方法创建多个 Book 对象封装在 List 集合中并将 JSON 数据返回到客户端。
﻿
4. 更换转换器1）使用 GsonGson 是 Google 的开源 JSON 解析器，添加依赖的时候先要去除默认的 jackson，具体如下：
﻿
﻿
<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>
在 Gson 转换时，如果需要格式化日期数据，则需要自定义 HttpMessageConverter，接着提供一个 GsonHttpMessageConverter 即可，具体如下：
@Configuration
﻿
public class GsonConfig {
﻿
﻿
﻿
    @Bean
﻿
    GsonHttpMessageConverter gsonHttpMessageConverter() {
﻿
        GsonHttpMessageConverter converter = new GsonHttpMessageConverter();
﻿
        GsonBuilder builder = new GsonBuilder();
﻿
        builder.setDateFormat("yyyy-MM-dd");
﻿
        builder.excludeFieldsWithModifiers(Modifier.PROTECTED);
﻿
        Gson gson = builder.create();
﻿
        converter.setGson(gson);
﻿
﻿
﻿
        return converter;
﻿
    }
﻿
}
修改 Book 类，具体如下：
public class Book {
﻿
﻿
﻿
    private Integer id;
﻿
    private String name;
﻿
    private String author;
﻿
    protected Float price;
﻿
    private Date bookPublicationDate;
﻿
﻿
﻿
    // getter 和 setter 方法
﻿
}
运行之后，直接地址栏中访问 http://localhost:8080/getBooks，效果如图：
﻿
2）使用 fastjsonfastjson 是阿里巴巴的开源 JSON 解析器，也是目前速度最快的 JSON 解析器，整合之后需要提供相应的 HttpMessageConverter 才能使用，添加依赖，具体如下：
﻿
﻿
<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.alibaba</groupId>
﻿
    <artifactId>fastjson</artifactId>
﻿
</dependency>
接着，添加 fastjson 的 HttpMessageConverter，具体如下：
@Configuration
﻿
public class NXFastJsonConfig {
﻿
﻿
﻿
    @Bean
﻿
    FastJsonHttpMessageConverter fastJsonHttpMessageConverter() {
﻿
        FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
﻿
        FastJsonConfig config = new FastJsonConfig();
﻿
        config.setDateFormat("yyyy-MM-dd");
﻿
        config.setCharset(Charset.forName("UTF-8"));
﻿
        config.setSerializerFeatures(
﻿
                SerializerFeature.WriteClassName,
﻿
                SerializerFeature.WriteMapNullValue,
﻿
                SerializerFeature.PrettyFormat,
﻿
                SerializerFeature.WriteNullListAsEmpty,
﻿
                SerializerFeature.WriteNullStringAsEmpty
﻿
        );
﻿
        converter.setFastJsonConfig(config);
﻿
        return converter;
﻿
    }
﻿
}
再来 application.properties 中配置一个响应编码，具体如下：
﻿
运行之后，直接地址栏中访问 http://localhost:8080/getBooks，效果如图：
﻿
更多技术资料及视频
﻿
本文来源于：奈学开发者社区-江帅帅
﻿