SpringBoot 定制化返回?cái)?shù)據(jù)的實(shí)現(xiàn)示例
此時(shí)我們的返回結(jié)構(gòu)如下:
{ 'code': 200, 'msg': 'ok', 'data': { 'id': 1, 'username': 'steve', 'secretKey': 'xxx', 'expiredAt': null, 'createdAt': '2020-07-07T06:09:15' }}
但上面有幾個(gè)問題:
我希望字段是以下劃線命名方式,也就是 createdAt 改成 created_at 這樣 我希望某些字段值的輸出格式可以自定義,比如日期類型我希望輸出是 yyyy-MM-dd HH:mm:ss 我不希望 secretKey 這類具有安全性質(zhì)的字段返回給調(diào)用方 我不希望有 null 這樣的輸出,避免給調(diào)用方不必要的麻煩定制字段名
我們有兩種選擇,第一種是在每一個(gè)字段上通過添加 @JsonProperty 注解來實(shí)現(xiàn),如下:
@JsonProperty('secret_key')private String secretKey;
這種方式靈活度高,缺點(diǎn)就是繁瑣,變量名是單個(gè)單詞的不用轉(zhuǎn)換,多個(gè)單詞的如果要保持統(tǒng)一格式就需要每個(gè)都寫上,工作量不小。
第二種方式就是全局配置 Spring 內(nèi)置的 Jackson 的序列化轉(zhuǎn)換器,在 config 目錄下新建 JsonConfig.java 文件:
package com.foxescap.wxbox.config;import com.fasterxml.jackson.databind.PropertyNamingStrategy;import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.http.converter.HttpMessageConverter;import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;import org.springframework.web.servlet.config.annotation.EnableWebMvc;import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;import java.time.format.DateTimeFormatter;import java.util.List;/** * @author xfly */@EnableWebMvc@Configurationpublic class WebMvcConfig implements WebMvcConfigurer { @Bean public LocalDateTimeSerializer localDateTimeSerializer() { return new LocalDateTimeSerializer(DateTimeFormatter.ofPattern('yyyy-MM-dd HH:mm:ss')); } @Override public void configureMessageConverters(List<HttpMessageConverter<?>> converters) { converters.add(new MappingJackson2HttpMessageConverter( new Jackson2ObjectMapperBuilder().propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE).build()) ); }}
我們通過重寫 WebMvcConfigurer 接口的 configureMessageConverters 方法,添加自定義的 JSON 轉(zhuǎn)換器,關(guān)鍵是 propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE) 這行代碼,設(shè)置屬性的命名策略為下劃線命名方式。
定制字段值格式
最常見的就是對(duì)時(shí)間類型的字段格式化,也有兩種方式,第一種是在每個(gè)字段上添加 @JsonFormat 注解,比如格式化日期時(shí)間:
@JsonFormat(pattern = 'yyyy-MM-dd HH:mm:ss')private LocalDateTime expiredAt;
也可以全局配置,我們?cè)谏厦?JsonConfig 代碼的基礎(chǔ)上,加上一個(gè)類型串行器:
@Beanpublic LocalDateTimeSerializer localDateTimeSerializer() { return new LocalDateTimeSerializer(DateTimeFormatter.ofPattern('yyyy-MM-dd HH:mm:ss'));}@Overridepublic void configureMessageConverters(List<HttpMessageConverter<?>> converters) { converters.add( new MappingJackson2HttpMessageConverter( new Jackson2ObjectMapperBuilder() .propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE) .serializerByType(LocalDateTime.class, localDateTimeSerializer()) .build() ) );}
這樣就能對(duì)全局 LocalDateTime 類型的字段序列化時(shí)轉(zhuǎn)換成我們自定義的格式了。
定制可見性
當(dāng)我們不需要有字段被序列化,即需要忽略它,那么可以在那個(gè)字段上添加 @JsonIgnore 注解即可。
處理 Null
一般地,要么是直接忽略值為 null 的字段,要么是將 null 轉(zhuǎn)換成空字符串處理,前者可以直接在每個(gè)需要的字段上加 @JsonInclude(Include.NON_NULL) 注解,或者也可以在每個(gè)需要序列化的類上加,當(dāng)然也可以全局配置,在 .build() 前加入 .serializationInclusion(JsonInclude.Include.NON_NULL) 即可。
如果我們不希望 null 值直接被忽略,又不需要直接給調(diào)用方返回 null,那么可以添加一個(gè) setNullValueSerializer 方法自定義輸出:
@Overridepublic void configureMessageConverters(List<HttpMessageConverter<?>> converters) { var builder = new Jackson2ObjectMapperBuilder() .propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE) //.serializationInclusion(JsonInclude.Include.NON_NULL) .serializerByType(LocalDateTime.class, localDateTimeSerializer()) .build(); builder.getSerializerProvider() .setNullValueSerializer(new JsonSerializer<>() { @Override public void serialize(Object o, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {jsonGenerator.writeString(''); } }); converters.add(new MappingJackson2HttpMessageConverter(builder));}
糾結(jié)過是直接不序列化 Null 值還是設(shè)為空值,考慮到對(duì)于調(diào)用方,如果直接將 Null 值忽略了的話,數(shù)據(jù)的結(jié)構(gòu)完整性就大大破壞了,比如一個(gè)數(shù)組,有幾個(gè)數(shù)組元素里的字段有,有幾個(gè)沒有,對(duì)于調(diào)用方就非常不友好了。
如果你想對(duì)不同變量類型的 Null 值分別處理的話,那么就需要重寫 changeProperties 方法,比如對(duì)于數(shù)組集合類型的字段,如果是 Null 值則序列化成 [] ;如果是字符串類型的字段,序列化成 '' ;如果是不二類型的字段,序列化成 false 等等:
@Overridepublic void configureMessageConverters(List<HttpMessageConverter<?>> converters) { var builder = new Jackson2ObjectMapperBuilder() .propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE) .serializerByType(LocalDateTime.class, localDateTimeSerializer()) .build(); builder.setSerializerFactory(builder.getSerializerFactory().withSerializerModifier(new BeanSerializerModifier() { @Override public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) { for (var beanPropertyWriter : beanProperties) {var javaType = beanPropertyWriter.getType();if (javaType.isArrayType() || javaType.isCollectionLikeType()) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object o, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException { jsonGenerator.writeStartArray(); jsonGenerator.writeEndArray(); } });} else if (javaType.isTypeOrSubTypeOf(String.class)) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeString(''); } });} else if (javaType.isTypeOrSuperTypeOf(Boolean.class)) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeBoolean(false); } });} else if (javaType.isMapLikeType()) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeStartObject(); gen.writeEndObject(); } });} else if (javaType.isTypeOrSuperTypeOf(Integer.class) || javaType.isTypeOrSuperTypeOf(Long.class) || javaType.isTypeOrSuperTypeOf(Double.class) || javaType.isTypeOrSuperTypeOf(Float.class)) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeNumber(0); } });} else if (javaType.isTypeOrSuperTypeOf(LocalDateTime.class) || javaType.isTypeOrSuperTypeOf(LocalDate.class)) { beanPropertyWriter.assignNullSerializer(new JsonSerializer<>() { @Override public void serialize(Object value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeString(''); } });} } return beanProperties; } })); converters.add(new MappingJackson2HttpMessageConverter(builder));}
到此這篇關(guān)于SpringBoot 定制化返回?cái)?shù)據(jù)的實(shí)現(xiàn)示例的文章就介紹到這了,更多相關(guān)SpringBoot 定制化返回?cái)?shù)據(jù)內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. Python獲取抖音關(guān)注列表封號(hào)賬號(hào)的實(shí)現(xiàn)代碼2. Warning: require(): open_basedir restriction in effect,目錄配置open_basedir報(bào)錯(cuò)問題分析3. php網(wǎng)絡(luò)安全中命令執(zhí)行漏洞的產(chǎn)生及本質(zhì)探究4. 解決Python 進(jìn)程池Pool中一些坑5. php測(cè)試程序運(yùn)行速度和頁面執(zhí)行速度的代碼6. Python如何讀寫CSV文件7. 三個(gè)不常見的 HTML5 實(shí)用新特性簡(jiǎn)介8. ajax請(qǐng)求添加自定義header參數(shù)代碼9. python利用os模塊編寫文件復(fù)制功能——copy()函數(shù)用法10. 無線標(biāo)記語言(WML)基礎(chǔ)之WMLScript 基礎(chǔ)第1/2頁
