【源码分析】FastJson全局配置日期格式导致@JSONField(format = "yyyy-MM-dd")注解失效...

出现的问题

我全局配置的时间格式是：yyyy-MM-dd HH:mm:ss

@JSONField注解配置的时间格式是：yyyy-MM-dd

最终的返回结果是：yyyy-MM-dd HH:mm:ss

问题：为啥不是以注解定义的时间格式为主呢？

先说答案，后面再分析：

FastJson的全局配置日期格式会导致@JSONField注解失效

使用建议：

1.若全局配置了日期格式，就不要使用@JSONField注解

2.若想使用@JSONField注解，就不要全局配置日期格式

 

一、FastJson全局配置代码如下

@Configuration
public class FastJsonConverterConfig {

    @Bean
    public HttpMessageConverters fastJsonHttpMessageConverters() {
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        fastJsonConfig.setSerializerFeatures(
                SerializerFeature.WriteMapNullValue,
                SerializerFeature.WriteNullListAsEmpty,
                SerializerFeature.WriteNullStringAsEmpty,
                SerializerFeature.WriteNullBooleanAsFalse
//                SerializerFeature.WriteDateUseDateFormat
        );
        fastConverter.setFastJsonConfig(fastJsonConfig);

　　　　　//全局指定了日期格式
        fastJsonConfig.setDateFormat("yyyy-MM-dd HH:mm:ss");

        //该设置目的，为了兼容jackson
        fastConverter.setSupportedMediaTypes(Arrays.asList(MediaType.APPLICATION_JSON,MediaType.APPLICATION_JSON_UTF8,MediaType.APPLICATION_OCTET_STREAM));
        HttpMessageConverter converter = fastConverter;
        return new HttpMessageConverters(converter);
    }
}

 

二、使用@JSONField注解的Java Bean代码如下

@Data
public class UserCardInfoResponseModel {

    @JSONField(format = "yyyy-MM-dd")
    private Date validStartDate;

}

 

三、源码分析

1.首先我们看下FastJson最终格式化字段值的方法，JSONSerializer.writeWithFormat(Object object, String format)

public class JSONSerializer extends SerializeFilterable {
　　
　　/**
　　* format就是@JSONField注解中指定的format值
　　* object就是需要格式化的变量
　　*/
　　public final void writeWithFormat(Object object, String format) {
        if (object instanceof Date) {
　　　　　　　//从当前类获取一个DateFormat，DateFormat就是用来格式化日期的类，再看看this.getDateFormat();的实现　
            DateFormat dateFormat = this.getDateFormat();
            if (dateFormat == null) {
　　　　　　　//只有当，当前类中的dateFormat为null时，才会使用JSONField注解中的format值初始化一个新的DateFormat
　　　　　　　//那么我们可以肯定@JSONField注解没生效的原因就是,当前类中的dateFormat不为null
                dateFormat = new SimpleDateFormat(format, locale);
                dateFormat.setTimeZone(timeZone);
            }
            String text = dateFormat.format((Date) object);
            out.writeString(text);
            return;
        }

        if (object instanceof byte[]) {
            byte[] bytes = (byte[]) object;
            if ("gzip".equals(format) || "gzip,base64".equals(format)) {
                GZIPOutputStream gzipOut = null;
                try {z
                    ByteArrayOutputStream byteOut = new ByteArrayOutputStream();
                    if (bytes.length < 512) {
                        gzipOut = new GZIPOutputStream(byteOut, bytes.length);
                    } else {
                        gzipOut = new GZIPOutputStream(byteOut);
                    }
                    gzipOut.write(bytes);
                    gzipOut.finish();
                    out.writeByteArray(byteOut.toByteArray());
                } catch (IOException ex) {
                    throw new JSONException("write gzipBytes error", ex);
                } finally {
                    IOUtils.close(gzipOut);
                }
            } else if ("hex".equals(format)) {
                out.writeHex(bytes);
            } else {
                out.writeByteArray(bytes);
            }
            return;
        }

        if (object instanceof Collection) {
            Collection collection = (Collection) object;
            Iterator iterator = collection.iterator();
            out.write('[');
            for (int i = 0; i < collection.size(); i++) {
                Object item = iterator.next();
                if (i != 0) {
                    out.write(',');
                }
                writeWithFormat(item, format);
            }
            out.write(']');
            return;
        }
        write(object);
    }


　　public DateFormat getDateFormat() {

if (dateFormat == null) {
            if (dateFormatPattern != null) {
　　　　　　　//第一次调用该方法时，dateformat为null，满足第一个if条件
　　　　　　　//那么只有当dateFormatPattern有值时，才会初始化一个dateFormat对象，
　　　　　　　//那么问题来了，dateFormatPattern值是从哪里来的呢，答案就是从我们的全局配置中来的，我们继续往下看
                dateFormat = new SimpleDateFormat(dateFormatPattern, locale);
                dateFormat.setTimeZone(timeZone);
            }
        }

        return dateFormat;
    }

}

 

2.其次，我们来看使用我们FastJson全局配置的地方，FastJsonHttpMessageConverter.writeInternal(Object object, HttpOutputMessage outputMessage);

public class FastJsonHttpMessageConverter extends AbstractHttpMessageConverter