Spring Boot中Jack相关问题（精度丢失/日期格式化/忽略null值）

精度丢失

是否存在@EnableWebMvc注解
若存在则去掉，此注解中默认继承WebMvcConfigurationSupport类，该类在整个应用程序中只会生效一个，会导致某些配置失效，慎用。

添加@JsonFormat注解（局部）
在实体类属性上如下注解：

@JsonFormat(shape = JsonFormat.Shape.STRING)    // 将Long类型转为String类型
private Long id;
1
2

扩展mvc框架的消息转换器（全局）
添加JacksonObjectMapper类，继承ObjectMapper类

package com.aiw.waimai.common;

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalTimeSerializer;

import java.math.BigInteger;
import java.text.SimpleDateFormat;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;

import static com.fasterxml.jackson.databind.DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES;

/**
 * 对象映射器:基于jackson将Java对象转为json，或者将json转为Java对象
 * 将JSON解析为Java对象的过程称为 [从JSON反序列化Java对象]
 * 从Java对象生成JSON的过程称为 [序列化Java对象到JSON]
 */
public class JacksonObjectMapper extends ObjectMapper {

    public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
    public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
    public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";

    public JacksonObjectMapper() {
        super();
        //收到未知属性时不报异常
        this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);

        //反序列化时，属性不存在的兼容处理
        this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);

        // 忽略null值
        this.setSerializationInclusion(JsonInclude.Include.NON_NULL);

        // 设置Date类型格式化
        this.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));

        SimpleModule simpleModule = new SimpleModule()
                // 反序列化（设置LocalDateTime等日期时间类型格式化）
                .addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
                .addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
                .addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
                // 将大数字类型自动转换为String类型，防止前端精度丢失（也可以直接使用@JsonFormat(shape = JsonFormat.Shape.STRING)注解）
                .addSerializer(BigInteger.class, ToStringSerializer.instance)
                .addSerializer(Long.class, ToStringSerializer.instance)
                // 序列化
                .addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
                .addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
                .addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));

        //注册功能模块 例如，可以添加自定义序列化器和反序列化器
        this.registerModule(simpleModule);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

注册转换器，新建配置类WebConfig.java，实现WebMvcConfigurer接口

package com.aiw.waimai.config;

import com.aiw.waimai.common.JacksonObjectMapper;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class WebConfig implements WebMvcConfigurer {
    /**
     * 扩展mvc框架的消息转换器
     *
     * @param converters
     */
    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        // 设置对象转换器，底层使用Jackson将Java对象转为Json
        converter.setObjectMapper(new JacksonObjectMapper());
        // 将消息转换器器对象追加到mvc框架的转换器集合中，放于第一位
        converters.add(0, converter);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

前端也可以单独使用jsonlint.js处理精度丢失问题，参考Jison解决JS处理后端返回的Long型数据精度丢失问题

日期格式化

添加@JsonFormat注解（局部）
在实体类属性上如下注解：

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private Date createTime;
1
2

使用注解方式，对于Date和LocalDateTime等日期时间类型是生效的

修改配置文件
在application.yml配置文件中添加如下：

spring:
  # 该设置会有失效的情况（使用@EnableWebMvc会失效）
  jackson:
    date-format: yyyy-MM-dd HH:mm:ss
    time-zone: GMT+8
1
2
3
4
5

使用修改配置文件方式，只对于Date日期时间类型会生效，对其它类型不生效；若需要格式化LocalDateTime等日期时间类型，需扩展mvc框架的消息转换器

扩展mvc框架的消息转换器（全局）
参考上述。

忽略null值

添加@JsonInclude注解（局部）
在实体类属性上如下注解：

@JsonInclude(JsonInclude.Include.NON_NULL)  // 忽略null值
private T data; 
1
2

修改配置文件
在application.yml配置文件中添加如下：

spring:
  # 该设置会有失效的情况（使用@EnableWebMvc会失效）
  jackson:
    default-property-inclusion: non_null
1
2
3
4

扩展mvc框架的消息转换器（全局）
参考上述。