跳到主要內容

Jackson - Convert the Date format to ISO8601

 Problem

在做Rest API的輸出處理時,一定會遇到日期要顯示的格式,而日期也伴隨著timezone的問題。要顯示成甚麼樣子的格式,就看各個應用程式的需求。一開始是想仿效臉書轉為unix time,後來再為這問題爭論不休;最後我在study後,認為ISO8601比較符合我們需求,就決定為我們的顯示格式。

How to?

預設使用Jackson去做Date的轉換,會輸出為unix time。如果要達到我們的目的,可透過@JsonSerialize設定對應序列化的物件;而要接收使用者輸入轉為對應物件的話,可透過@JsonDeserialize設定對應反序列化物件。

Object with JsonSerialize and JsonDeserialize annotation

public class Event {
	@JsonSerialize(using=ISO8601DateSerializer.class)
	@JsonDeserialize(using=ISO8601DateDeserializer.class)
	private Date date;
 
	private String message;
 
	public Date getDate(){
		return date;
	}
 
	public void setDate(Date date){
		this.date = date;
	}
 
        // ... skip
}

ISO8601DateSerializer for Date

public class ISO8601DateSerializer extends StdSerializer<Date> {
	private static final long serialVersionUID = 1L;
 
	public ISO8601DateSerializer() {
		super(Date.class);
	}
 
	@Override
	public void serialize(Date date, JsonGenerator json,
			SerializerProvider provider) throws IOException,
			JsonGenerationException {
		DateFormat df = StdDateFormat.getISO8601Format(
				TimeZone.getTimeZone("UTC"), Locale.getDefault());
		String out = df.format(date);
 
 
		json.writeString(out);
	}
 
}

ISO8601DateDeserializer for Date

public class ISO8601DateDeserializer extends StdDeserializer<Date> {
 
	private static final long serialVersionUID = 1L;
 
	public ISO8601DateDeserializer() {
        super(Date.class);
    }
 
	@Override
	public Date deserialize(JsonParser parser, DeserializationContext context)
			throws IOException, JsonProcessingException {
		try {
 
			DateFormat df = StdDateFormat.getISO8601Format(
					TimeZone.getTimeZone("UTC"), Locale.getDefault());
			return df.parse(parser.getText());
		} catch (Exception e) {
			return null;
		}
	}
}

Convert to Json

簡單寫一個測試案例,去驗證序列化後再反序列化的內容會一致:

	@Test
	public void testDateWithAnnotation() throws Exception {
		ObjectMapper mapper = new ObjectMapper();
 
		Date d = new Date();
		Event e = new Event();
		e.setDate(d);
 
		String ret = mapper.writeValueAsString(e);
		System.out.println(ret);
		Event newEvent = mapper.readValue(ret, Event.class);
		assertEquals(d.getTime(), newEvent.getDate().getTime());
	}
output:
{"date":"2016-03-10T15:40:11.869+0000","message":null}

Apply to all Date fields

上面所敘述的是透過在欄位宣告@JsonSerialize,來達到我們的目的。如果想要讓每一個擁有Date的bean物件都能使用這個格式,可以透過Jackson所提供的Module功能,去設定對應物件的Serializer與Deserializer:

ObjectMapper mapper = new ObjectMapper();
 
SimpleModule m = new SimpleModule();
m.addSerializer(Date.class, new ISO8601DateSerializer());
m.addDeserializer(Date.class, new ISO8601DateDeserializer());
 
mapper.registerModule(m);

後記

  • 時間轉換可以透過joda-time去實作你想要的格式。
  • Jackson提供了joda模組,讓你轉換更容易。

Reference


留言

這個網誌中的熱門文章

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中,不可或缺的東西就是Unattended installation。以Unattended installation來說,我們可以選擇透過Installer的silent mode安裝,也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法,教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數,除了可以直接上官網搜尋Installation User Guide以外,也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多,以我們需求來說,我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =

How to install RIDE on Windows?

Introduction 多年沒在Windows上開發RobotFramework,趁著這次整理一下RIDE安裝方法。 目前RIDE最新版本與Python對應版本如下: (3.6 < python <= 3.11) Install current released version (2.0.8.1) with: pip install -U robotframework-ride 安裝Python 直接到Python官網找尋最新的3.11版本,我使用3.11.9: link 。安裝就是一直下一步而已。 安裝wxPython 每次安裝RIDE最困難的都是wxPython。看了一下 官網 描述,我就姑且相信一下: 接著進入下 載頁面 就有安裝教學。基本上就是到Python目錄下的Scripts直接執行以下command: pip install -U wxPython 安裝RIDE 接著就如RIDE官網所說,執行以下command: pip install -U robotframework-ride 啟動RIDE 直接在相同目錄下執行ride就可以啟動了,你也可以直接在桌面建ride連結,加快下次啟動時間。 沒想到這次這麼順利就安裝完成了。因為我是使用java去啟動robot framework,就不特別講要怎麼使用pip安裝robot framework了。

Hello World!

即將要搬家,因此舊網頁內容將慢慢轉移至Blogger。 如果要存取舊網頁,可以使用以下連結: https://wiki.tonylin.idv.tw/dokuwiki/doku.php