Spring boot如何配置请求的入参和出参json数据格式

时间:2021-05-20

这篇文章主要介绍了spring boot如何配置请求的入参和出参json数据格式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下

请求入参数据格式配置,以日期格式为例:

编写日期编辑器类:

import first.zxz.tools.DateUtil;import java.beans.PropertyEditorSupport;/** * 日期编辑器 * * @author zhangxz * @date 2019-11-12 20:01 */public class DateEditor extends PropertyEditorSupport { /** * 是否将null转换为空字符串 */ private final boolean nullAsEmpty; public DateEditor() { this(true); } public DateEditor(boolean nullAsEmpty) { this.nullAsEmpty = nullAsEmpty; } @Override public void setAsText(String text) { if (text == null) { if (nullAsEmpty) { setValue(""); } else { setValue(null); } } else { setValue(DateUtil.parse(text)); } }}

其中用到的日期工具类如下:

public class DateUtil { private static final String DATE_FORMAT_1 = "yyyy-MM-dd"; private static final String DATE_FORMAT_2 = "yyyy/MM/dd"; private static final String DATE_FORMAT_3 = "yyyyMMdd"; private static final String DATE_TIME_FORMAT_1 = DATE_FORMAT_1 + " HH:mm:ss"; private static final String DATE_TIME_FORMAT_2 = DATE_FORMAT_2 + " HH:mm:ss"; private static final String DATE_TIME_FORMAT_3 = DATE_FORMAT_3 + "HHmmss"; //key为正则表达式,value为对应的日期格式 private static final HashMap<String, String> DATE_REGEX_FORMATTER_MAP = new HashMap<>(); static { DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_1, DATE_FORMAT_1); DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_2, DATE_FORMAT_2); DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_3, DATE_FORMAT_3); DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_TIME_1, DATE_TIME_FORMAT_1); DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_TIME_2, DATE_TIME_FORMAT_2); DATE_REGEX_FORMATTER_MAP.put(DateRegexConst.DATE_TIME_3, DATE_TIME_FORMAT_3); } //提示语:所有可用的日期格式 public static final String ALL_USABLE_DATE_FORMATS = DATE_REGEX_FORMATTER_MAP.values().toString() + ",以及时间戳;"; /** * 根据输入的字符串,进行格式化,并输入日期数据 * 注意:格式化之前,会进行null和空字符串过滤;格式化时,会去除字符串两端的空字符串 * * @param formattedDateStr 日期字符串数据 * @return java.util.Date * @author Zxz * @date 2019/11/6 15:07 **/ public static Date parse(String formattedDateStr) { if (formattedDateStr == null || formattedDateStr.trim().length() <= 0) { throw new StringEmptyException(); } for (Map.Entry<String, String> entry : DATE_REGEX_FORMATTER_MAP.entrySet()) { if (formattedDateStr.trim().matches(entry.getKey())) { SimpleDateFormat simpleDateFormat = new SimpleDateFormat(entry.getValue()); try { return simpleDateFormat.parse(formattedDateStr.trim()); } catch (ParseException e) { e.printStackTrace(); throw new DateFormatException(); } } } try { Long aLong = Long.valueOf(formattedDateStr); return new Date(aLong); } catch (NumberFormatException e) { //格式不匹配 throw new DateFormatException(); } }}

把编辑器加入web的绑定初始化配置:

import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.format.support.FormattingConversionService;import org.springframework.validation.Validator;import org.springframework.web.bind.support.ConfigurableWebBindingInitializer;import simple.proj.zxz.play.config.editor.DateEditor;import java.util.Date;/** * 配置请求 bean数据接收格式,例如date格式 * * @author zhangxz * @date 2019-11-12 19:56 */@Configurationpublic class WebBindingInitializerConfig { /** * 配置请求入参数据格式,参考{@link simple.proj.zxz.play.config.editor.DateEditor} * * @param mvcConversionService mvc版本业务 * @param mvcValidator mvc校验器 * @return org.springframework.web.bind.support.ConfigurableWebBindingInitializer * @author zhangxz * @date 2019/11/13 10:40 */ @Bean public ConfigurableWebBindingInitializer configurableWebBindingInitializer(FormattingConversionService mvcConversionService, Validator mvcValidator) { ConfigurableWebBindingInitializer initializer = new ConfigurableWebBindingInitializer(); initializer.setConversionService(mvcConversionService); initializer.setValidator(mvcValidator); initializer.setPropertyEditorRegistrar(propertyEditorRegistry -> { //PropertyEditor 非线程安全 propertyEditorRegistry.registerCustomEditor(Date.class, new DateEditor()); }); return initializer; }}

入参的日期数据格式配置完成,可以接收的日期格式在日期工具类可以看到,有以下几种:yyyy-mm-dd,时间戳,yyyy-mm-dd hh:mm:ss等。

请求出参格式配置,包括空字符串,空数组,以及日期格式化输出

编写空字符串序列器:

import com.fasterxml.jackson.core.JsonGenerator;import com.fasterxml.jackson.core.JsonProcessingException;import com.fasterxml.jackson.databind.JsonSerializer;import com.fasterxml.jackson.databind.SerializerProvider;import java.io.IOException;/** * 空字符串序列器 * * @author zhangxz * @date 2019-11-12 22:05 */public class NullStringSerializer extends JsonSerializer { @Override public void serialize(Object o, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException, JsonProcessingException { jsonGenerator.writeString(""); }}

编写空数组序列器

/** * 空数组或集合序列器 * * @author zhangxz * @date 2019-11-12 22:04 */public class NullArraySerializer extends JsonSerializer { @Override public void serialize(Object value, JsonGenerator jgen, SerializerProvider provider) throws IOException, JsonProcessingException { jgen.writeStartArray(); jgen.writeEndArray(); }}

编写日期序列器

import com.fasterxml.jackson.core.JsonGenerator;import com.fasterxml.jackson.databind.JsonSerializer;import com.fasterxml.jackson.databind.SerializerProvider;import java.io.IOException;import java.util.Date;/** * 日期序列器 * * @author zhangxz * @date 2019-11-12 23:01 */public class DateSerializer extends JsonSerializer { /** * 日期序列化方法,返回时间戳格式 * * @param o 数值 * @param jsonGenerator json生成器 * @param serializerProvider 序列器 * @author zhangxz * @date 2019/11/13 10:41 */ @Override public void serialize(Object o, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException { jsonGenerator.writeNumber(((Date) o).getTime()); }}

编写总序列器

import com.fasterxml.jackson.databind.BeanDescription;import com.fasterxml.jackson.databind.JsonSerializer;import com.fasterxml.jackson.databind.SerializationConfig;import com.fasterxml.jackson.databind.ser.BeanPropertyWriter;import com.fasterxml.jackson.databind.ser.BeanSerializerModifier;import java.util.Collection;import java.util.Date;import java.util.List;/** * 总序列器 * * @author zhangxz * @date 2019-11-12 22:07 */public class GeneralSerializer extends BeanSerializerModifier { //空数组 private JsonSerializer _nullArraySerializer = new NullArraySerializer(); //空字符串 private JsonSerializer _nullStringSerializer = new NullStringSerializer(); //日期类型 private JsonSerializer dateSerializer = new DateSerializer(); @Override public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) { for (BeanPropertyWriter beanProperty : beanProperties) { if (isArrayType(beanProperty)) { beanProperty.assignNullSerializer(this._nullArraySerializer); } else if (isStringType(beanProperty)) { beanProperty.assignNullSerializer(this._nullStringSerializer); } else if (isDateType(beanProperty)) { beanProperty.assignSerializer(this.dateSerializer); } } return beanProperties; } private boolean isStringType(BeanPropertyWriter writer) { Class clazz = writer.getType().getRawClass(); return clazz == String.class; } private boolean isDateType(BeanPropertyWriter writer) { return Date.class == writer.getType().getRawClass(); } private boolean isArrayType(BeanPropertyWriter writer) { Class clazz = writer.getType().getRawClass(); return clazz.isArray() || Collection.class.isAssignableFrom(clazz); }}

把总序列器加入web配置中:

import com.fasterxml.jackson.databind.ObjectMapper;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;import simple.proj.zxz.play.config.serializer.GeneralSerializer;/** * @description: 配置jackson 序列器 * @author: zhangxz * @create: 2019-11-12 22:02 */@Configurationpublic class JacksonConfig { /** * 出参数据格式配置,参考类 {@link simple.proj.zxz.play.config.serializer.GeneralSerializer} * * @return org.springframework.http.converter.json.MappingJackson2HttpMessageConverter * @author zhangxz * @date 2019/11/13 10:34 */ @Bean public MappingJackson2HttpMessageConverter mappingJacksonHttpMessageConverter() { final MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter(); ObjectMapper mapper = converter.getObjectMapper(); mapper.setSerializerFactory(mapper.getSerializerFactory().withSerializerModifier(new GeneralSerializer())); return converter; }}

请求出参配置完成,出参格式如下:null的字符串输出为空字符串,null的数组输出为空数组,date数据格式输出为时间戳。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。

声明:本页内容来源网络,仅供用户参考;我单位不保证亦不表示资料全面及准确无误,也不保证亦不表示这些资料为最新信息,如因任何原因,本网内容或者用户因倚赖本网内容造成任何损失或损害,我单位将不会负任何法律责任。如涉及版权问题,请提交至online#300.cn邮箱联系删除。

相关文章