您好,登錄后才能下訂單哦!
日期時(shí)間格式是如何在Spring Boot中處理的?相信很多沒有經(jīng)驗(yàn)的人對(duì)此束手無(wú)策,為此本文總結(jié)了問題出現(xiàn)的原因和解決方法,通過這篇文章希望你能解決這個(gè)問題。
在springboot中開發(fā)RESTful接口,經(jīng)常會(huì)遇到日期時(shí)間轉(zhuǎn)換相關(guān)的問題,例如我們明明輸入看起來很正常的日期時(shí)間字符串,但是系統(tǒng)卻報(bào)錯(cuò)無(wú)法解析:
JSON parse error: Cannot deserialize value of type java.time.OffsetDateTime from String “2020-06-06 14:26:31”
或者接口返回的日期時(shí)間字符串是一個(gè)很奇怪的字符串:
2020-06-04 14:41:54.767135400+08:00
如何正確的處理日期時(shí)間,本文將一探究竟。
日期時(shí)間格式標(biāo)準(zhǔn)
有兩個(gè)標(biāo)準(zhǔn)組織對(duì)日期時(shí)間格式進(jìn)行規(guī)范,一個(gè)是IETF,一個(gè)是ISO。雖然IETF的定義更早,但是它存在一些問題,ISO的定義使用更普遍。但是不管哪種定義,我們常常使用的yyyy-MM-dd HH:mm:ss這種格式都不是標(biāo)準(zhǔn)的,你是否非常驚訝呢。
IETF
RFC822->RFC2822->RFC5322
日期時(shí)間的本文表示最早是在電子郵件消息中被討論和定義,可以追溯到Internet剛誕生之時(shí),ARPANET使用的文本信息格式中所定義,也就是RFC822,發(fā)布于1982年。此后經(jīng)過若干次修訂,定型是RFC2822,最新版是RFC5322。
通過幾個(gè)例子來了解下這種格式長(zhǎng)什么樣子。
最常見的樣子如下,通過linux命令date可以打?。?/p>
date --rfc-email
Thu, 04 Jun 2020 13:54:52 +0800
有些格式已經(jīng)不建議使用,RFC2822定義為過時(shí)的格式,如:
RFC1123
RFC1123并不定義日期時(shí)間格式,而是描述應(yīng)用程序之間通信協(xié)議的需求,包括各種應(yīng)用層協(xié)議,如TELNET,F(xiàn)TP,SMTP等,涉及到日期時(shí)間格式的正是SMTP,它引用了RFC822,并說明了年份修改為2到4個(gè)數(shù)字,建議時(shí)區(qū)總是使用數(shù)字。
RFC1036
同樣RFC1306也不定義日期時(shí)間格式,而是描述USENET中對(duì)日期時(shí)間的要求,同樣引用了RFC822。
綜上IETF的時(shí)間格式主要為電子郵件定義,但是只要以可讀文本方式表示時(shí)間都可以使用。IETF的定義帶有明顯的時(shí)代和地區(qū)特征,并不具有國(guó)際通用性,也不便于閱讀和解析,因此又出現(xiàn)了ISO的日期時(shí)間格式。
ISO8601,RFC3339
ISO的日期時(shí)間格式有助于避免由許多不同的國(guó)家符號(hào)引起的國(guó)際通信混亂,并提高了計(jì)算機(jī)用戶界面的可移植性。第一版發(fā)布于1988年。
RFC3339是ISO8601的概要版本。
先通過例子了解一下他們長(zhǎng)什么樣子。
date --iso-8601=ns
2020-06-04T14:41:54,767135400+08:00
date --rfc-3339=ns
2020-06-04 14:41:54.767135400+08:00
以上是最常見的樣子,ISO8601相對(duì)于RFC5322有幾個(gè)主要變化:
RFC3339和ISO8601的區(qū)別:
Java日期時(shí)間編程接口
Java的發(fā)展過程中出現(xiàn)過幾個(gè)不同的日期時(shí)間編程接口。java8之前的日期時(shí)間接口存在眾所周知的問題,這時(shí)只能尋求第三方庫(kù)庫(kù)來解決,這就是joda,java8大量借鑒了joda,推出了新的日期時(shí)間庫(kù)。自此,java8日期時(shí)間接口成為首選。
java8之前 | java8 | joda | |
---|---|---|---|
本地時(shí)間 | java.util.Date | java.time.LocalDate java.time.LocalTime java.time.LocalDateTime | org.joda.time.LocalDate org.joda.time.LocalTime org.joda.time.LocalDateTime |
帶時(shí)區(qū)時(shí)間 | java.time.OffsetTime java.time.OffsetDateTime java.time.ZonedDateTime | org.joda.time.DateTime | |
格式化和解析 | java.text.DateFormat | java.time.format.DateTimeFormatter | org.joda.time.format.DateTimeFormatter |
舉例 | Date date = new Date(); SimpleDateFormat fmt = new SimpleDateFormat(“yyyy-MM-dd HH:mm:ss”); String str = fmt.format(date); date = fmt.parse(“2020-06-06 15:13:25”); | LocalDateTime date = LocalDateTime.now(); DateTimeFormatter fmt = DateTimeFormatter.ofPattern(“yyyy-MM-dd HH:mm:ss”); String str = fmt.format(date); TemporalAccessor acc = fmt.parse(“2020-06-06 15:13:25”); date = LocalDateTime.from(acc); | LocalDateTime date = LocalDateTime.now(); DateTimeFormatter fmt = DateTimeFormat.forPattern(“pattern”); String str = fmt.print(date); date = fmt.parseLocalDate(“2020-06-06 15:13:25”); |
以上各種日期時(shí)間編程接口都提供了格式化和解析接口,實(shí)現(xiàn)字符串和日期時(shí)間對(duì)象之間的互相轉(zhuǎn)換,我們可以定制日期格式,例如常用的格式y(tǒng)yyy-MM-dd HH:mm:ss,那么格式化和解析都會(huì)按照這個(gè)格式,解析時(shí)如果不符合格式就會(huì)異常。
sprintboot中如何處理日期時(shí)間
確切的說是如何處理json和java日期時(shí)間對(duì)象之間的轉(zhuǎn)換。
springboot極大的簡(jiǎn)化了springmvc的開發(fā),對(duì)于開發(fā)RESTful接口也是一樣,開箱即用。這是通過autoconfigure和starter實(shí)現(xiàn)的。
首先引入spring-boot-starter-web依賴。
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
spring-boot-starter-web會(huì)引入spring-boot-starter-json,spring-boot-starter-json又會(huì)引入jackson-databind,jackson-datatype-jdk8和jackson-datatype-jsr310。可見json的實(shí)現(xiàn)默認(rèn)是使用的jackson。其中jackson-datatype-jsr310就包含了java8日期時(shí)間的序列化、反序列化方法。
其次springboot應(yīng)用,也就是使用了@SpringBootApplication注解,通過autoconfigure對(duì)jackson進(jìn)行了自動(dòng)配置。實(shí)現(xiàn)代碼在sprint-boot-autoconfigure的JacksonAutoConfiguration.java文件中。
其中有三個(gè)點(diǎn)對(duì)jackson進(jìn)行配置:Jackson2ObjectMapperBuilder,Jackson2ObjectMapperBuilderCustomizer和ObjectMapper,以上所有配置最終都是影響ObjectMapper。
@Configuration(proxyBeanMethods = false) @ConditionalOnClass(Jackson2ObjectMapperBuilder.class) static class JacksonObjectMapperBuilderConfiguration { @Bean @Scope("prototype") @ConditionalOnMissingBean Jackson2ObjectMapperBuilder jacksonObjectMapperBuilder(ApplicationContext applicationContext, List<Jackson2ObjectMapperBuilderCustomizer> customizers) { Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder(); builder.applicationContext(applicationContext); customize(builder, customizers); return builder; }
@Configuration(proxyBeanMethods = false) @ConditionalOnClass(Jackson2ObjectMapperBuilder.class) @EnableConfigurationProperties(JacksonProperties.class) static class Jackson2ObjectMapperBuilderCustomizerConfiguration { @Bean StandardJackson2ObjectMapperBuilderCustomizer standardJacksonObjectMapperBuilderCustomizer( ApplicationContext applicationContext, JacksonProperties jacksonProperties) { return new StandardJackson2ObjectMapperBuilderCustomizer(applicationContext, jacksonProperties); }
@Configuration(proxyBeanMethods = false) @ConditionalOnClass(Jackson2ObjectMapperBuilder.class) static class JacksonObjectMapperConfiguration { @Bean @Primary @ConditionalOnMissingBean ObjectMapper jacksonObjectMapper(Jackson2ObjectMapperBuilder builder) { return builder.createXmlMapper(false).build(); } }
那么對(duì)于日期時(shí)間的處理,springboot的默認(rèn)行為是怎么樣的呢,默認(rèn)的代碼配置在上述StandardJackson2ObjectMapperBuilderCustomizer中。
static final class StandardJackson2ObjectMapperBuilderCustomizer implements Jackson2ObjectMapperBuilderCustomizer, Ordered { ...... private void configureDateFormat(Jackson2ObjectMapperBuilder builder) { // We support a fully qualified class name extending DateFormat or a date // pattern string value String dateFormat = this.jacksonProperties.getDateFormat(); if (dateFormat != null) { try { Class<?> dateFormatClass = ClassUtils.forName(dateFormat, null); builder.dateFormat((DateFormat) BeanUtils.instantiateClass(dateFormatClass)); } catch (ClassNotFoundException ex) { SimpleDateFormat simpleDateFormat = new SimpleDateFormat(dateFormat); // Since Jackson 2.6.3 we always need to set a TimeZone (see // gh-4170). If none in our properties fallback to the Jackson's // default TimeZone timeZone = this.jacksonProperties.getTimeZone(); if (timeZone == null) { timeZone = new ObjectMapper().getSerializationConfig().getTimeZone(); } simpleDateFormat.setTimeZone(timeZone); builder.dateFormat(simpleDateFormat); } } }
其邏輯是首先讀取spring.jackson.date-format屬性,如果不為空就會(huì)設(shè)置builder.dateFormat,如果是一個(gè)類(當(dāng)然是從java.text.DateFormat派生),那么初始化為這個(gè)類的實(shí)例,否則認(rèn)為配置的yyyy-MM-dd HH:mm:ss這種格式化字符串,然后創(chuàng)建SimpleDateFormat實(shí)例。
另外springmvc本身還有一個(gè)MappingJackson2HttpMessageConverter,其實(shí)也是配置Jackson2ObjectMapperBuilder。
看完上述內(nèi)容,你們掌握日期時(shí)間格式是如何在Spring Boot中處理的的方法了嗎?如果還想學(xué)到更多技能或想了解更多相關(guān)內(nèi)容,歡迎關(guān)注億速云行業(yè)資訊頻道,感謝各位的閱讀!
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。