請求入參數據格式配置,以日期格式為例:
編寫日期編輯器類:
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 */ @Configuration public 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 */ @Configuration public 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數據格式輸出為時間戳。
參考博客:
https://blog.csdn.net/qq_36356627/article/details/82953011
https://blog.csdn.net/qq_36804701/article/details/81116119
https://blog.csdn.net/Michean/article/details/90901450