Java/Springプロジェクトでバージョン管理されたREST APIコードを整理するベストプラクティス（例）

Question

誰かが、バージョン管理（uri-based、 "/ v1/zzz"、 "/ v2/xxx"を意味する）を持つREST APIコードを整理したり、Acceptヘッダー） - Java/Springプロジェクトでは？今私のプロジェクトでは複雑すぎるので、他の人から学ぶのはうれしいですね。

明確化：フィルターを通す必要があるかどうかわからず、動作を変更するためにいくつかのデザインパターンを使用しますが、これによってフィルタがかなり複雑になります。または、春とDI、私は自分のコードをきれいにすることができます。最も簡単なアプローチは、異なるバージョン管理を持つすべての方法にいくつかの戦略パターンですが、あまりにもきれいではありません.--(

Answer 1

Apigee http://offers.apigee.com/api-design-ebook-bw/の本とブログを読むことを強くお勧めしますURLを設計し、エラー処理を行うため、私は本当に実用的なアドバイス。

http://www.stormpath.com/blog/spring-mvc-rest-exception-handling-best-practices-part-2は安らかなアプリケーションのための取り扱い一般的なエラーを行うには、スプリングMVCを設定する方法の本当に素晴らしい記事があります。

で受け入れるheadrsにフィルタリングするためとして、春以降かなり簡単に、ヘッダにあるようにフィルタに基づいてハンドラメソッドのマッピングを絞り込むことができますreqの=下のマッピングを行います。

@RequestMapping(value="/narrow/headers/{name}/{email}/{customerNumber}", 
     method={RequestMethod.POST,RequestMethod.GET}, 
     headers="Referer=http://localhost:8080/SpringMVC/request-mappings.html") 
public ResponseEntity<String> narrowOnHeaders(
     @PathVariable("name")String name, 
     @PathVariable("email") String email, 
     @PathVariable("customerNumber") Integer customerNumber, 
     @RequestHeader("Referer") String referer 
    )