springboot2中使用@JsonFormat注解不生效的解決

更新時間：2022年02月18日 15:42:59 作者：殘月飛鷹

這篇文章主要介紹了springboot2中使用@JsonFormat注解不生效的解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教

使用@JsonFormat注解不生效

百度了不少解決方式，有讓用@JsonField,也有讓把fastjson去掉的，也有加很多配置的，但是都沒用。

本次使用的版本號

1、springboot2.2.2 ;

2、fastjson 1.1.26

3、<jackson-mapper-asl.version>1.9.10</jackson-mapper-asl.version>
<jackson-core.version>2.10.3</jackson-core.version>

第三點(diǎn)以及相關(guān)的依賴可能不需要，加上也沒關(guān)系

pom文件中的依賴：

<dependency>
?? ??? ??? ?<groupId>com.alibaba</groupId>
?? ??? ??? ?<artifactId>fastjson</artifactId>
?? ??? ??? ?<version>${fastjson.version}</version>
?? ??? ?</dependency>
<dependency>
?? ??? ??? ?<groupId>org.codehaus.jackson</groupId>
?? ??? ??? ?<artifactId>jackson-mapper-asl</artifactId>
?? ??? ??? ?<version>${jackson-mapper-asl.version}</version>
?? ??? ?</dependency>?
?? ??? ?<dependency>
?? ??? ??? ?<groupId>com.fasterxml.jackson.core</groupId>
?? ??? ??? ?<artifactId>jackson-core</artifactId>
?? ??? ??? ?<version>${jackson-core.version}</version>
?? ??? ?</dependency>
?? ??? ?<dependency>
?? ??? ??? ?<groupId>com.fasterxml.jackson.core</groupId>
?? ??? ??? ?<artifactId>jackson-databind</artifactId>
?? ??? ??? ?<version>${jackson-core.version}</version>
?? ??? ?</dependency>
?? ??? ?<dependency>
?? ??? ??? ?<groupId>com.fasterxml.jackson.core</groupId>
?? ??? ??? ?<artifactId>jackson-annotations</artifactId>
?? ??? ??? ?<version>${jackson-core.version}</version>
?? ??? ?</dependency>

解決方式

第一步新建一個轉(zhuǎn)換類用于自定義Jackson反序列化日期類型時應(yīng)用的類型轉(zhuǎn)換器，一般用于@RequestBody接受參數(shù)時使用

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import org.apache.commons.lang3.StringUtils;
import org.apache.commons.lang3.time.DateUtils;
 
import java.io.IOException;
import java.text.ParseException;
import java.util.Date;
 
/**
 * 自定義Jackson反序列化日期類型時應(yīng)用的類型轉(zhuǎn)換器,一般用于@RequestBody接受參數(shù)時使用
 *  次類是借用網(wǎng)上別的人的，增加了一個日期格式化的類型
 */
public class DateJacksonConverter extends JsonDeserializer<Date> {
    //此處尤為重要，請查找自己控制臺報錯的日期格式化類型是啥樣的
    //我的是2020-04-29T16:23:44.999Z 所以我在下面的數(shù)組中添加了 "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'" 格式；如果下面數(shù)組中沒有你要的格式化類型，其他的可自行根據(jù)自己的情況去添加即可
    private static String[] pattern =
            new String[]{"yyyy-MM-dd", "yyyy-MM-dd HH:mm", "yyyy-MM-dd HH:mm:ss", "yyyy-MM-dd HH:mm:ss.S",
                    "yyyy.MM.dd", "yyyy.MM.dd HH:mm", "yyyy.MM.dd HH:mm:ss", "yyyy.MM.dd HH:mm:ss.S",
                    "yyyy/MM/dd", "yyyy/MM/dd HH:mm", "yyyy/MM/dd HH:mm:ss", "yyyy/MM/dd HH:mm:ss.S", "yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"};
 
    @Override
    public Date deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
 
        Date targetDate = null;
        String originDate = p.getText();
        if (StringUtils.isNotEmpty(originDate)) {
            try {
                long longDate = Long.valueOf(originDate.trim());
                targetDate = new Date(longDate);
            } catch (NumberFormatException e) {
                try {
                    targetDate = DateUtils.parseDate(originDate, DateJacksonConverter.pattern);
                } catch (ParseException pe) {
                    throw new IOException(String.format(
                            "'%s' can not convert to type 'java.util.Date',just support timestamp(type of long) and following date format(%s)",
                            originDate,
                            StringUtils.join(pattern, ",")));
                }
            }
        } 
        return targetDate;
    } 
    @Override
    public Class<?> handledType() {
        return Date.class;
    }
}

創(chuàng)建好上邊的類之后，如果不想繼續(xù)，則可以在實體對象屬性上加注解就完全可以了。

導(dǎo)入的包路徑為：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;?

@JsonDeserialize(using=DateJacksonConverter.class)
private Date startDate;

如果不想去讓實體類加這個注解，可以在寫一個公共配置，如下：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
 
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fx.base.serializer.DateJacksonConverter;
 
@Configuration
public class ConverterConfig {
    @Bean
    public DateJacksonConverter dateJacksonConverter() {
        return new DateJacksonConverter();
    }
 
    @Bean
    public Jackson2ObjectMapperFactoryBean jackson2ObjectMapperFactoryBean(
            @Autowired
                    DateJacksonConverter dateJacksonConverter) {
        Jackson2ObjectMapperFactoryBean jackson2ObjectMapperFactoryBean = new Jackson2ObjectMapperFactoryBean();
 
        jackson2ObjectMapperFactoryBean.setDeserializers(dateJacksonConverter);
        return jackson2ObjectMapperFactoryBean;
    }
 
    @Bean
    public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter(
            @Autowired
                    ObjectMapper objectMapper) {
        MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter =
                new MappingJackson2HttpMessageConverter();
        mappingJackson2HttpMessageConverter.setObjectMapper(objectMapper);
        return mappingJackson2HttpMessageConverter;
    }
}

此時就不必再每個實體類屬性上加注解了。

@JsonFormat和@DateTimeFormat的作用

@DatetimeFormat是將String轉(zhuǎn)換成Date，一般前臺給后臺傳值時用

? ? import org.springframework.format.annotation.DateTimeFormat;
? ? /**
? ? ?* 前臺傳后臺時, 字符串自動封裝成日期
? ? ?*/
? ? @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
? ? private Date birth;

@JsonFormat(pattern=”yyyy-MM-dd”) 將Date轉(zhuǎn)換成String 一般后臺傳值給前臺時

? ? import com.fasterxml.jackson.annotation.JsonFormat;
? ? /**
? ? ?* 后臺返給前臺時, 日期自動格式化
? ? ?*/
? ? @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
? ? private Date birth;

注意：

@JsonFormat不僅可以完成后臺到前臺參數(shù)傳遞的類型轉(zhuǎn)換，還可以實現(xiàn)前臺到后臺類型轉(zhuǎn)換。

當(dāng)content-type為application/json時，優(yōu)先使用@JsonFormat的pattern進(jìn)行類型轉(zhuǎn)換。而不會使用@DateTimeFormat進(jìn)行類型轉(zhuǎn)換。

@JsonFormat注解的作用就是完成json字符串到j(luò)ava對象的轉(zhuǎn)換工作，與參數(shù)傳遞的方向無關(guān)。

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: