时间:2021-05-20
此时我们的返回结构如下:
{ "code": 200, "msg": "ok", "data": { "id": 1, "username": "steve", "secretKey": "xxx", "expiredAt": null, "createdAt": "2020-07-07T06:09:15" }}但上面有几个问题:
定制字段名
我们有两种选择,第一种是在每一个字段上通过添加 @JsonProperty 注解来实现,如下:
@JsonProperty("secret_key")private String secretKey;这种方式灵活度高,缺点就是繁琐,变量名是单个单词的不用转换,多个单词的如果要保持统一格式就需要每个都写上,工作量不小。
第二种方式就是全局配置 Spring 内置的 Jackson 的序列化转换器,在 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 转换器,关键是 propertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE) 这行代码,设置属性的命名策略为下划线命名方式。
定制字段值格式
最常见的就是对时间类型的字段格式化,也有两种方式,第一种是在每个字段上添加 @JsonFormat 注解,比如格式化日期时间:
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")private LocalDateTime expiredAt;也可以全局配置,我们在上面 JsonConfig 代码的基础上,加上一个类型串行器:
@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() ) );}这样就能对全局 LocalDateTime 类型的字段序列化时转换成我们自定义的格式了。
定制可见性
当我们不需要有字段被序列化,即需要忽略它,那么可以在那个字段上添加 @JsonIgnore 注解即可。
处理 Null
一般地,要么是直接忽略值为 null 的字段,要么是将 null 转换成空字符串处理,前者可以直接在每个需要的字段上加 @JsonInclude(Include.NON_NULL) 注解,或者也可以在每个需要序列化的类上加,当然也可以全局配置,在 .build() 前加入 .serializationInclusion(JsonInclude.Include.NON_NULL) 即可。
如果我们不希望 null 值直接被忽略,又不需要直接给调用方返回 null,那么可以添加一个 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));}纠结过是直接不序列化 Null 值还是设为空值,考虑到对于调用方,如果直接将 Null 值忽略了的话,数据的结构完整性就大大破坏了,比如一个数组,有几个数组元素里的字段有,有几个没有,对于调用方就非常不友好了。
如果你想对不同变量类型的 Null 值分别处理的话,那么就需要重写 changeProperties 方法,比如对于数组集合类型的字段,如果是 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));}到此这篇关于SpringBoot 定制化返回数据的实现示例的文章就介绍到这了,更多相关SpringBoot 定制化返回数据内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!
声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。
如果你想实现一些定制化功能,只需要写这个组件,然后将它交给springboot管理,springboot会给我们自动装配以下是spring官方文档解释由官方文档
开篇本例是在springboot整合H2内存数据库,实现单元测试与数据库无关性和使用RestTemplate消费springboot的Restful服务两个示例
这篇文章主要介绍了SpringBoot实现国际化过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下实现方
springboot日志默认采用logback进行输出,你可以对logback进行定制化,方法如下:在resources文件夹下建立logback.xml配置文
这篇文章主要介绍了SpringBoot基于数据库实现定时任务过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以