【Google App Engine】 RESTfulアプリのCRUDサンプル －Servlet編－

　今回は、RESTfulアプリのServlet部分について説明する。例によって、請求書アプリを題材にしている。使用しているReflexGaeライブラリは＝＞ココ

検索（GET）

　検索ではRequestパラメータを受け取り、それを条件にdatastoreを検索して、結果をJSONもしくはXMLで返す。

　1. ReflexServletをextendsしてRESTful機能をもたせる
　2. RequestパラメータをEntity（Invoice）にセットする
　3. パラメータInvoiceを与えてdatastoreを検索
　4. 結果をJSONもしくはXMLにして返す
　5. エラー発生時はエラー内容をJSONもしくはXMLにして返す

登録（POST）

　登録では、クライアントからPOSTで受け取ったXMLもしくはJSONをEntityオブジェクトに変換した後、datastoreへのINSERTを実行する。クライアントには登録成功でHTTPStatus201(created)を返す。

　1. クライアントから受け取ったXML（JSON）をEntityオブジェクトに変換
　2. すでに登録されている場合エラー
　3. 登録されていなければinsert
　4. エラー発生時はエラー内容をJSONもしくはXMLにして返す

更新（PUT)

　更新では登録と同様に、クライアントからPOSTで受け取ったXML、JSONをEntityオブジェクトに変換してUpdateを実行する。更新オブジェクトのRevision番号が同一であれば更新実行、異なれば楽観的ロック失敗とする。



削除(delete)

　削除では、リクエストパラメータをもとに削除したいオブジェクトを取得し、deleteを実行する。該当するオブジェクトが存在しない場合に、HTTPStatus 204(no content)を返すようにしているが、これは特になくてもよい処理かもしれない。



嵌りどころと注意点

　1. POSTの場合、Requestに対し、getInputStreamを実行する前に、getParameterを実行してしまうとInputStreamの値が読み取れない。（PUTの場合はなぜかうまく動作する）
　2. HTTP Status 200,201以外をセットする場合、ResponseのOutputStreamに内容が出力されない。具体的には以下のような現象となる。

(HTTP Status) : (現象)
* 204 : 内容なし
* 409 : java.io.IOException
* 404 : java.io.FileNotFoundException

　最後に一言。GAEにおけるアプリケーション開発で特に重要だと思うのはテストである。テストコードを書けとか、TDDをやれとかいう意味ではなく、実際にテストして動作を確認することが重要である。（私は自分が作ったアプリのテストコードはほとんど書かないが、他人が作ったものは実際に検証しないと何も信じないタチである。）実際に現象を確認しないで、SPECやDocumentを見て判断してはいけないし、やみくもに信じてはいけない。ある程度予想できる結果であったとしても、必ずテストして確認すること。GAEは特にそうしないと危ない。石橋を叩いて渡るぐらいの心構えでちょうどよいと感じている。

＜関連＞
AJAX CRUDサンプルとJDO代替ライブラリ
RESTfulアプリのCRUDサンプル　－Modeling編－