最近項目中大量使用了Spring Cloud Feign來對接http接口，踩了不少坑，也產生了一些對RESTFUL接口設計的想法，特此一篇記錄下。

SpringMVC的請求參數(shù)綁定機制

了解Feign歷史的朋友會知道，Feign本身是Netflix的產品，Spring Cloud Feign是在原生Feign的基礎上進行了封裝，引入了大量的SpringMVC注解支持，這一方面使得其更容易被廣大的Spring使用者開箱即用，但也產生了不小的混淆作用。所以在使用Spring Cloud Feign之前，筆者先介紹一下SpringMVC的一個入?yún)C制。預設一個RestController，在本地的8080端口啟動一個應用，用于接收http請求。

@RestControllerpublic class BookController { @RequestMapping(value = "/hello") // <1> public String hello(String name) { // <2> return "hello " + name; }}

這個接口寫起來非常簡單，但實際springmvc做了非常多的兼容，使得這個接口可以接受多種請求方式。

<1> RequestMapping代表映射的路徑，使用GET,POST,PUT,DELETE方式都可以映射到該端點。

<2> SpringMVC中常用的請求參數(shù)注解有(@RequestParam,@RequestBody,@PathVariable)等。name被默認當做@RequestParam。形參String name由框架使用字節(jié)碼技術獲取name這個名稱，自動檢測請求參數(shù)中key值為name的參數(shù)，也可以使用@RequestParam(“name”)覆蓋變量本身的名稱。當我們在url中攜帶name參數(shù)或者form表單中攜帶name參數(shù)時，會被獲取到。

POST /hello HTTP/1.1Host: localhost:8080Content-Type: application/x-www-form-urlencodedname=formParam

或

GET /hello?name=queryString HTTP/1.1Host: localhost:8080

Feign的請求參數(shù)綁定機制

上述的SpringMVC參數(shù)綁定機制，大家應該都是非常熟悉的，但這一切在Feign中有些許的不同。

我們來看一個非常簡單的，但是實際上錯誤的接口寫法：

//注意：錯誤的接口寫法@FeignClient("book")public interface BookApi { @RequestMapping(value = "/hello

總結

以上是生活随笔為你收集整理的feignclient注解使用_从 Feign 使用注意点到 RESTFUL 接口设计规范的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內容還不錯，歡迎將生活随笔推薦給好友。