江帥帥：精通 Spring Boot 系列 05

Spring Boot 處理 JSON 資料

JSON 是目前主流的前後端資料傳輸方式，當 Controller 中返回的是一個 Java 物件或 List 集合時，Spring Boot 將自動把它轉換成 JSON 資料。

Spring Boot 中內建了 JSON 解析功能，當你在專案中，新增了 spring-boot-starter-web 模組之後，即可看到預設包含 Jackson 解析器，也可以換成 Fastjson 等其他解析器。

1. 編輯 Book 類

 {
     Integer id;
     String name;
     String author;
    
     Float price;
    (pattern = )
     Date bookPublicationDate;
    
}

2. 編輯 BookController 

返回資料的時候，需要使用 @ResponseBody 註解。如果經常使用 @Controller 和 @ResponseBody 註解，則可以使用 @RestController 組合註解來替代。

 {
    ()
    {
        Book book =  Book();
        book.setId();
        book.setName();
        book.setAuthor();
        book.setPrice();
        book.setBookPublicationDate( Date());
         book;
    }
}

執行之後，直接位址列中訪問 ，即可看到返回的 JSON 資料。

3. 轉換集合資料

新增 getBooks() 方法，建立一個 List 集合，存放三本書。具體原始碼如下：

()
{
    List<Book> bookList =  ArrayList<>();
    Book book1 =  Book();
    book1.setId();
    book1.setName();
    book1.setAuthor();
    book1.setPrice();
    book1.setBookPublicationDate( Date());
    Book book2 =  Book();
    book2.setId();
    book2.setName();
    book2.setAuthor();
    book2.setPrice();
    book2.setBookPublicationDate( Date());
    Book book3 =  Book();
    book3.setId();
    book3.setName();
    book3.setAuthor();
    book3.setPrice();
    book3.setBookPublicationDate( Date());
    bookList.add(book1);
    bookList.add(book2);
    bookList.add(book3);
     bookList;
}

執行之後，直接位址列中訪問 ，即可看到 getBooks() 方法建立多個 Book 物件封裝在 List 集合中並將 JSON 資料返回到客戶端。

4. 更換轉換器

1）使用 Gson

Gson 是 Google 的開源 JSON 解析器，新增依賴的時候先要去除預設的 jackson，具體如下：

    org.springframework.boot
    spring-boot-starter-web
    
        
            com.fasterxml.jackson.core
            jackson-databind
        
    
    com.google.code.gson
    gson

在 Gson 轉換時，如果需要格式化日期資料，則需要自定義 HttpMessageConverter，接著提供一個 GsonHttpMessageConverter 即可，具體如下：

 {
    
    {
        GsonHttpMessageConverter converter =  GsonHttpMessageConverter();
        GsonBuilder builder =  GsonBuilder();
        builder.setDateFormat();
        builder.excludeFieldsWithModifiers(Modifier.PROTECTED);
        Gson gson = builder.create();
        converter.setGson(gson);
         converter;
    }
}

修改 Book 類，具體如下：

 {
     Integer id;
     String name;
     String author;
     Float price;
     Date bookPublicationDate;
    
}

執行之後，直接位址列中訪問 ，效果如圖：

2）使用 fastjson

fastjson 是阿里巴巴的開源 JSON 解析器，也是目前速度最快的 JSON 解析器，整合之後需要提供相應的 HttpMessageConverter 才能使用，新增依賴，具體如下：

    org.springframework.boot
    spring-boot-starter-web
    
        
            com.fasterxml.jackson.core
            jackson-databind
        
    
    com.alibaba
    fastjson

接著，新增 fastjson 的 HttpMessageConverter，具體如下：

 {
    
    {
        FastJsonHttpMessageConverter converter =  FastJsonHttpMessageConverter();
        FastJsonConfig config =  FastJsonConfig();
        config.setDateFormat();
        config.setCharset(Charset.forName());
        config.setSerializerFeatures(
                SerializerFeature.WriteClassName,
                SerializerFeature.WriteMapNullValue,
                SerializerFeature.PrettyFormat,
                SerializerFeature.WriteNullListAsEmpty,
                SerializerFeature.WriteNullStringAsEmpty
        );
        converter.setFastJsonConfig(config);
         converter;
    }
}

再來 application.properties 中配置一個響應編碼，具體如下：

spring.http.encoding.force-response=true

執行之後，直接位址列中訪問  ，效果如圖：

更多技術資料及影片

本文來源於：奈學開發者社群-江帥帥