Spring Boot 全局日期格式化（基于注解）
學(xué)習(xí)目標(biāo)
快速學(xué)會(huì)通過(guò)注解 @JsonComponent自定義日期格式化的序列化器。
使用教程
根據(jù)官方文檔 Custom JSON Serializers and Deserializers ，想要接管Jackson的JSON的序列化和反序列化，只需通過(guò)注解
@JsonComponent來(lái)聲明其靜態(tài)內(nèi)部類(lèi)即可。
首先根據(jù)項(xiàng)目要求提供自定義的日期序列化器和反序列化器，其中包括：
-
DateJsonSerializerextendsJsonSerializer表示將Date格式化為日期字符串。 -
DateJsonDeserializerextendsJsonDeserializer表示將日期字符串解析為Date日期。
/**
* 全局日期格式化
*/
@JsonComponent
public class DateFormatConfig {
private static SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
/**
* 日期格式化
*/
public static class DateJsonSerializer extends JsonSerializer<Date> {
@Override
public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
jsonGenerator.writeString(dateFormat.format(date));
}
}
/**
* 解析日期字符串
*/
public static class DateJsonDeserializer extends JsonDeserializer<Date> {
@Override
public Date deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JsonProcessingException {
try {
return dateFormat.parse(jsonParser.getText());
} catch (ParseException e) {
throw new RuntimeException(e);
}
}
}
}/**
* 查詢用戶信息
*/
@RestController
public class UserController {
@GetMapping("/")
public User get() {
return new User("1", "socks", "123456", new Date(), "GMT");
}
}
/**
* 用戶信息
*/
public class User {
private String userId;
private String username;
private String password;
private Date createTime;
private String timezone;
public User(String userId, String username, String password, Date createTime, String timezone) {
this.userId = userId;
this.username = username;
this.password = password;
this.createTime = createTime;
this.timezone = timezone;
}
//省略getters&setters
}{
"userId": "1",
"username": "socks",
"password": "123456",
"createTime": "2018-12-26 01:03:25"
}DateFormatConfig 注入業(yè)務(wù)變量，例如根據(jù)當(dāng)前登錄人的所屬時(shí)區(qū)（雖然 SimpleDateFormat默認(rèn)讀取了當(dāng)?shù)貢r(shí)區(qū)，但在實(shí)際的國(guó)際化系統(tǒng)中，用戶的所屬時(shí)區(qū)是指其在系統(tǒng)錄入的所屬時(shí)區(qū)，而不是指當(dāng)?shù)貢r(shí)區(qū)。例如Tony這個(gè)用戶賬號(hào)掛在GMT+0時(shí)區(qū)，但此時(shí)他出差在香港使用，系統(tǒng)仍需要按照GMT+0時(shí)區(qū)來(lái)顯示時(shí)間），為了解決這個(gè)問(wèn)題，此時(shí)我們可以在 DateFormatConfig 注入當(dāng)前登錄人然后改變?nèi)掌诠ぞ哳?lèi)的 TimeZone來(lái)動(dòng)態(tài)修改時(shí)區(qū)。
/**
* 全局日期格式化
*/
@JsonComponent
public class DateFormatConfig {
private static SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss Z") {
@Override
public Date parse(String source) throws ParseException {
try {
if (StringUtils.isEmpty(source)) {
return null;
}
return super.parse(source);
} catch (Exception e) {
return new StdDateFormat().parse(source);
}
}
};
private static UserController userController;//這里是指獲取當(dāng)前登錄人的工具類(lèi)
@Autowired
public void setUserController(UserController userController) {
DateFormatConfig.userController = userController;
}
/**
* 日期格式化
*/
public static class DateJsonSerializer extends JsonSerializer<Date> {
@Override
public void serialize(Date date, JsonGenerator jsonGenerator, SerializerProvider serializerProvider) throws IOException {
//獲取當(dāng)前登錄人的所屬時(shí)區(qū)
dateFormat.setTimeZone(TimeZone.getTimeZone(userController.get().getTimezone()));
//格式化日期
jsonGenerator.writeString(dateFormat.format(date));
}
}
/**
* 解析日期字符串
*/
public static class DateJsonDeserializer extends JsonDeserializer<Date> {
@Override
public Date deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException, JsonProcessingException {
try {
//獲取當(dāng)前登錄人的所屬時(shí)區(qū)
dateFormat.setTimeZone(TimeZone.getTimeZone(userController.get().getTimezone()));
//解析日期
return dateFormat.parse(jsonParser.getText());
} catch (ParseException e) {
throw new RuntimeException(e);
}
}
}
}{
"userId": "1",
"username": "socks",
"password": "123456",
"createTime": "2018-12-25 17:35:50 +0000",
"timezone": "GMT"
}小結(jié)
@JsonComponent 可以快速自定義日期格式化的序列化器，免除傳統(tǒng)通過(guò)模塊注冊(cè)的煩惱。
@JsonComponent 實(shí)現(xiàn)與當(dāng)?shù)責(zé)o關(guān)的動(dòng)態(tài)時(shí)區(qū)的精髓就在于將獲取當(dāng)前等人的方法寫(xiě)在解析日期和格式化日期的代碼里。
@JsonComponent 是直接處理String和Date的相互轉(zhuǎn)換的，所以要注意空串問(wèn)題。例如dateFormat.parse()要預(yù)防空串。
作者：yizhiwazi
鏈接：https://www.jianshu.com/p/f4654d251104
文末福利：我總結(jié)了一套 5000 頁(yè)的 Java 學(xué)習(xí)手冊(cè)，在知乎已經(jīng)3萬(wàn)贊了！此手冊(cè)內(nèi)容專(zhuān)注 Java技術(shù)，包括 JavaWeb，SSM，Linux，Spring Boot，MyBatis，MySQL，Nginx，Git，GitHub，Servlet，IDEA，多線程，集合，JVM，DeBug, Dubbo，Redis，算法，面試題等相關(guān)內(nèi)容。 
下載方式
1. 首先掃描下方二維碼
2. 后臺(tái)回復(fù)「555」即可獲取
注明：僅僅作為知識(shí)分享，切勿用于其它商業(yè)活動(dòng) 。感謝所有技術(shù)分享者的付出。
點(diǎn)贊是最大的支持
評(píng)論
圖片
表情