HTTP 請求工具類-RestTemplate

什麼是RestTemplate?

傳統情況下在java代碼裏訪問restful服務，一般使用Apache的HttpClient。不過此種方法使用起來太過繁瑣。spring提供了一種簡單便捷的模板類來進行操作，這就是RestTemplate。

一個簡單的例子

定義一個簡單的restful接口

@RestController
public class TestController
{
    @RequestMapping(value = "testPost", method = RequestMethod.POST)
    public ResponseBean testPost(@RequestBody RequestBean requestBean)
    {
        ResponseBean responseBean = new ResponseBean();
        responseBean.setRetCode("0000");
        responseBean.setRetMsg("succ");

        return responseBean;
    }
}

使用RestTemplate訪問該服務

 //請求地址
        String url = "http://localhost:8080/testPost";
        //入參
        RequestBean requestBean = new RequestBean();
        requestBean.setTest1("1");
        requestBean.setTest2("2");
        requestBean.setTest3("3");

        RestTemplate restTemplate = new RestTemplate();
        ResponseBean responseBean = restTemplate.postForObject(url, requestBean, ResponseBean.class);

從這個例子可以看出，使用restTemplate訪問restful接口非常的簡單粗暴無腦。(url, requestMap,
ResponseBean.class)這三個參數分別代表 請求地址、請求參數、HTTP響應轉換被轉換成的對象類型。

RestTemplate方法的名稱遵循命名約定，第一部分指出正在調用什麼HTTP方法，第二部分指示返回的內容。本例中調用了restTemplate.postForObject方法，post指調用了HTTP的post方法，Object指將HTTP響應轉換爲您選擇的對象類型。還有其他很多類似的方法，有興趣的同學可以參考官方api。

手動指定轉換器(HttpMessageConverter)

我們知道，調用reseful接口傳遞的數據內容是json格式的字符串，返回的響應也是json格式的字符串。然而restTemplate.postForObject方法的請求參數RequestBean和返回參數ResponseBean卻都是java類。是RestTemplate通過HttpMessageConverter自動幫我們做了轉換的操作。

默認情況下RestTemplate自動幫我們註冊了一組HttpMessageConverter用來處理一些不同的contentType的請求。
你可以在org.springframework.http.converter包下找到所有spring幫我們實現好的轉換器。
如果現有的轉換器不能滿足你的需求，你還可以實現org.springframework.http.converter.HttpMessageConverter接口自己寫一個。詳情參考官方api。

選好了HttpMessageConverter後怎麼把它註冊到我們的RestTemplate中呢。

 RestTemplate restTemplate = new RestTemplate();
        //獲取RestTemplate默認配置好的所有轉換器
        List<HttpMessageConverter<?>> messageConverters = restTemplate.getMessageConverters();
        //默認的MappingJackson2HttpMessageConverter在第7個 先把它移除掉
        messageConverters.remove(6);
        //添加上GSON的轉換器
        messageConverters.add(6, new GsonHttpMessageConverter());

這個簡單的例子展示瞭如何使用GsonHttpMessageConverter替換掉默認用來處理application/json的MappingJackson2HttpMessageConverter。

出處：https://www.jianshu.com/p/90ec27b3b518