SpringBoot
是爲了簡化 Spring
應用的建立、運行、調試、部署等一系列問題而誕生的產物,自動裝配的特性讓咱們能夠更好的關注業務自己而不是外部的XML配置,咱們只需遵循規範,引入相關的依賴就能夠輕易的搭建出一個 WEB 工程
java
爲何要用新的日期類型
在 JDK8
中,一個新的重要特性就是引入了全新的時間和日期API,它被收錄在 java.time
包中。藉助新的時間和日期API能夠以更簡潔的方法處理時間和日期。web
在 JDK8
以前,全部關於時間和日期的API存在如下幾個缺陷,也正是這些缺陷,出現了不少第三方的日期處理框架,例如 Joda-Time
,date4j
等開源項目。可是,Java 須要一套標準的用於處理時間和日期的框架,因而乎在 JDK8
中引入了新的日期API。遵循 JSR-310
規範的實現,而 Joda-Time
框架的做者正是 JSR-310
的規範的倡導者,因此用過 Joda-Time
的對新日期API也不會陌生。spring
缺陷安全
- 以前的
java.util.Date
和 java.util.Calendar
類易用性差,不支持時區,且非線程安全的;
- 日期格式化類
java.text.DateFormat
是一個抽象類,使用時須要先實例化一個 SimpleDateFormat
對象來處理日期格式化,同時 DateFormat
也不是線程安全的,這意味着若是你在多線程程序中調用同一個 DateFormat
對象,會獲得意想不到的結果。
- 對日期的計算方式繁瑣,並且容易出錯,由於月份是從0開始的,從 Calendar 中獲取的月份須要加一才能表示當前月份。
爲何要格式化
說了這麼多,和 Spring Boot
有什麼關係呢?不要急,待我娓娓道來!多線程
- 格式化前:{「payTime」:」2018-09-30T09:51:56.77」}
- 格式化後:{「payTime」:」2018-09-30 09:51:56」}
都知道咱們國人習慣 yyyy-MM-dd HH:mm:ss
這種格式的日期,但奈何框架是歪國大佬們寫的,他們的日期格式與咱們相差甚遠,好在 Spring Boot
提供了 spring.jackson.date-format
,奈何它只能格式化 java.util.Date
。那麼解決辦法是什麼呢?app
導入依賴
首先一個 WEB
項目,必不可少的依賴就是 spring-boot-starter-web
了,一路學習下來的小夥伴們確定都熟記於心了框架
1 2 3 4
|
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>
|
配置文件
因爲 spring.jackson.date-format
對新的日期類型不在有效果,因此這裏0配置文件了ide
方案一(強烈推薦)
只須要定義一個配置類,在裏面定義兩個 Bean
便可完成全局日期格式化處理,這種方式也是本人如今使用的,同時還兼顧了 Date
和 LocalDateTime
並存函數
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
|
package com.battcn.config;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer; import org.springframework.beans.factory.annotation.Value; import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration;
import java.time.LocalDateTime; import java.time.format.DateTimeFormatter;
/** * @author Levin * @since 2018/9/30 0030 */ @Configuration public class LocalDateTimeSerializerConfig {
@Value("${spring.jackson.date-format:yyyy-MM-dd HH:mm:ss}") private String pattern;
@Bean public LocalDateTimeSerializer localDateTimeDeserializer() { return new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(pattern)); }
@Bean public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() { return builder -> builder.serializerByType(LocalDateTime.class, localDateTimeDeserializer()); } }
|
方案二(強烈推薦)
有時候,咱們對日期格式要作特殊的處理,全局的格式化方式沒法知足咱們需求是,使用該方案是很是好的選擇,經過 @JsonFormat
註解咱們能夠更爲精準的爲日期字段格式化,它也是優先級最高的spring-boot
1 2 3 4 5 6
|
public class Order {
@JsonFormat(pattern = "yyyy-MM-dd") private LocalDateTime payTime; // 省略 GET SET ... }
|
方案三(可選)
其實和第一種相似,只不過第一種的寫法更加優雅簡潔,若是有多種類型須要作統一格式化處理,這種方案也不是不能夠考慮
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
|
package com.battcn.config;
import com.fasterxml.jackson.core.JsonGenerator; import com.fasterxml.jackson.core.JsonParser; import com.fasterxml.jackson.databind.*; import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer; import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary;
import java.io.IOException; import java.time.LocalDate; import java.time.LocalDateTime;
import static java.time.format.DateTimeFormatter.ofPattern;
/** * @author Levin * @since 2018/9/30 0030 */ @Configuration public class LocalDateTimeSerializerConfig1 {
@Value("${spring.jackson.date-format:yyyy-MM-dd HH:mm:ss}") private String pattern;
@Bean @Primary public ObjectMapper serializingObjectMapper() { ObjectMapper objectMapper = new ObjectMapper(); JavaTimeModule javaTimeModule = new JavaTimeModule(); javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer()); javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer()); objectMapper.registerModule(javaTimeModule); return objectMapper; }
public class LocalDateTimeSerializer extends JsonSerializer<LocalDateTime> { @Override public void serialize(LocalDateTime value, JsonGenerator gen, SerializerProvider serializers) throws IOException { gen.writeString(value.format(ofPattern(pattern))); } }
public class LocalDateTimeDeserializer extends JsonDeserializer<LocalDateTime> { @Override public LocalDateTime deserialize(JsonParser p, DeserializationContext deserializationContext) throws IOException { return LocalDateTime.parse(p.getValueAsString(), ofPattern(pattern)); } } }
|
控制層
定義了一個很簡單的響應
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
|
package com.battcn.controller;
import com.battcn.pojo.Order; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController;
import java.time.LocalDateTime;
/** * @author Levin * @since 2018/8/2 0002 */ @RestController @RequestMapping("/orders") public class OrderController {
@GetMapping public Order query() { Order order = new Order(); order.setPayTime(LocalDateTime.now()); return order; } }
|
主函數
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
|
package com.battcn;
import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication;
/** * @author Levin */ @SpringBootApplication public class Chapter28Application {
public static void main(String[] args) { SpringApplication.run(Chapter28Application.class, args); } }
|
測試
完成準備事項後,啓動Chapter28Application
,訪問 http://localhost:8080/orders 便可看到格式化後的日期啦…