JAVA DATE型のRESTデータ返却について

Java処理でDATE型をJSON形式でクライアントに返却すると
DATE型に格納されているfastTimeの値が渡されてしまいます。

通常、DATE型はJSONで返却しないものでしょうか？
たとえば、文字列の日付フォーマットに変換してJSONに変換するなど
または、クライアント側でfastTimeの値を日付型(yyyy/mm/dd)に変換できるのでしょうか？

サーバ処理の一部
返却する値はdomaのentityリストをJson形式にして返却しています。
※entityリストの中にDATE型があります。

lang
1@RestController
2public class XXXXRestController {
3	
4	@ResponseBody
5	@RequestMapping(value="/rest")
6	public List<entityクラス名> XXXメソッド(
7			ServletRequest request
8			) {
9		
10		List<entityクラス名> entity = null;
11		entity = entityクラス名.selectList();
12
13		return entity;
14	}
15}

開発環境
OS win7
サーバ言語 java1.7
javaフレームワーク spring 4 mvc
O/Rマッピング doma
jsフレームワーク knockout.js
ＤＢ oracle12c
ブラウザ主にIE

行動規範の内容に同意します

回答1件

ベストアンサー

こんにちは。

まず、

通常、DATE型はJSONで返却しないものでしょうか？

についてなのですが、返却する例を以下から挙げます。

Web API Design
https://pages.apigee.com/rs/apigee/images/api-design-ebook-2012-03.pdf
（個人的に、WEBAPIの設計をするときに、よく読み返す資料です。）

これの21ページに以下のような例があります。

Twitter
"created_at": "Thu Nov 03 05:19;38 +0000 2011"

Bing
"DateTime": "2011-10-29T09:35:00Z"

Foursquare
"createdAt": 1320296464

これらは、各WEBサービスの返すJSONの中で、日時がどのように
書かれるかの例になっています。
（ただし、このPDFには、「これらのうち、このフォーマットがベスト」とは書いてはありませんが。）

ご質問に戻りますと、

通常、DATE型はJSONで返却しないものでしょうか？

については、

たとえば、文字列の日付フォーマットに変換してJSONに変換するなど

とおっしゃっているように、文字列や数値に変換して返却します。
上記の例の

"created_at": "Thu Nov 03 05:19;38 +0000 2011"
"DateTime": "2011-10-29T09:35:00Z"

は、文字列にしている例で、

"createdAt": 1320296464

は、エポック秒の整数値がJSONの値になっています。

もう一点、ご質問にある

クライアント側でfastTimeの値を日付型(yyyy/mm/dd)に変換できるのでしょうか？

についてです。
java.util.Date のfastTimeとは何かというと、コンストラクタ

lang
1new Date(long milliseconds)

で与えるmillisecondsのことで、ミリ秒単位です。
ですので、ご質問の回答としては

クライアント側でミリ秒単位のエポックタイムから日時のオブジェクト
（あるいはそれに相当するもの）を作成できるなら、できます。

というものになるかと思います。
たとえば、APIを使うプログラムをJavascriptで書いているなら、
Javascriptでも

lang
1new Date( milliseconds )

というコンストラクタで、引数にミリ秒単位のエポックタイム
を与えて、Dateオブジェクトを作ることができますので、
JSONのプロパティの値として出現する、fastTimeの値から
JavascriptのDateオブジェクトを作り、これを適宜、"yyyy/mm/dd"などの
欲しい文字列に変換することができます。