Jersey中處理POST格式的Best Practice

標籤：jersey   java   rest   post   

REST中，我們可以把接受POST請求的方式寫成如下的方式：

    @POST

    @Consumes(MediaType.APPLICATION_JSON)

    public Response createProduct(CreateProductJson createProductJson, @Context UriInfo uriInfo) {

CreateProductJson就是我們伺服器用來接收CreateProudct這樣一個請求的JSON表達方式，然後我們可以通過createProductJson.getProduct()這樣類似的方法得到product對象，然後再將圍繞著product這一領域對象進行處理

這樣看似還不錯，CreateProductJson就類似成為了我們的DTO對象，但是這裡有一個問題就是CreateProductJson的容錯性比較差。假如，我們當前的product需要兩個欄位：name、price。但是用戶端如果多傳輸給我們了一個description，那麼很有可能我的還原序列化CreateProductJson對象的時候就會拋異常，丟出400 Bad Request錯誤。這麼嚴格的要求往往是沒有必要的。一些相關的解釋可以參考Martin Fowler的講解《Customer Driven Contract》

那我們怎麼能夠做的容錯性更好呢？其實非常簡單

    @POST
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    public Response createProduct(Form form) {
    

我們只要再定義一個transformer就行了，比如，定義ProductForm，它其中含有一個方法getProduct()，這個方法中我們只從form去取我們真正需要的資料，對於多餘的資料，我們可以置之不理。