一. 什么是RestTemplate

傳統(tǒng)情況下在java代碼里訪問(wèn)restful服務(wù)，一般使用Apache的HttpClient。不過(guò)此種方法使用起來(lái)太過(guò)繁瑣。spring提供了一種簡(jiǎn)單便捷的模板類(lèi)來(lái)進(jìn)行操作，這就是RestTemplate。

二.一個(gè)簡(jiǎn)單的例子。

定義一個(gè)簡(jiǎn)單的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訪問(wèn)該服務(wù)

        //請(qǐng)求地址
        String url = "http://localhost:8080/testPost";
        //入?yún)?        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);

從這個(gè)例子可以看出，使用restTemplate訪問(wèn)restful接口非常的簡(jiǎn)單粗暴無(wú)腦。(url, requestMap, ResponseBean.class)這三個(gè)參數(shù)分別代表 請(qǐng)求地址、請(qǐng)求參數(shù)、HTTP響應(yīng)轉(zhuǎn)換被轉(zhuǎn)換成的對(duì)象類(lèi)型。

RestTemplate方法的名稱遵循命名約定，第一部分指出正在調(diào)用什么HTTP方法，第二部分指示返回的內(nèi)容。本例中調(diào)用了restTemplate.postForObject方法，post指調(diào)用了HTTP的post方法，Object指將HTTP響應(yīng)轉(zhuǎn)換為您選擇的對(duì)象類(lèi)型。還有其他很多類(lèi)似的方法，有興趣的同學(xué)可以參考官方api。

三.手動(dòng)指定轉(zhuǎn)換器(HttpMessageConverter)

我們知道，調(diào)用reseful接口傳遞的數(shù)據(jù)內(nèi)容是json格式的字符串，返回的響應(yīng)也是json格式的字符串。然而restTemplate.postForObject方法的請(qǐng)求參數(shù)RequestBean和返回參數(shù)ResponseBean卻都是java類(lèi)。是RestTemplate通過(guò)HttpMessageConverter自動(dòng)幫我們做了轉(zhuǎn)換的操作。

默認(rèn)情況下RestTemplate自動(dòng)幫我們注冊(cè)了一組HttpMessageConverter用來(lái)處理一些不同的contentType的請(qǐng)求。
如StringHttpMessageConverter來(lái)處理text/plain;MappingJackson2HttpMessageConverter來(lái)處理application/json;MappingJackson2XmlHttpMessageConverter來(lái)處理application/xml。
你可以在org.springframework.http.converter包下找到所有spring幫我們實(shí)現(xiàn)好的轉(zhuǎn)換器。
如果現(xiàn)有的轉(zhuǎn)換器不能滿足你的需求，你還可以實(shí)現(xiàn)org.springframework.http.converter.HttpMessageConverter接口自己寫(xiě)一個(gè)。詳情參考官方api。

選好了HttpMessageConverter后怎么把它注冊(cè)到我們的RestTemplate中呢。

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

這個(gè)簡(jiǎn)單的例子展示了如何使用GsonHttpMessageConverter替換掉默認(rèn)用來(lái)處理application/json的MappingJackson2HttpMessageConverter。

四.設(shè)置底層連接方式

要?jiǎng)?chuàng)建一個(gè)RestTemplate的實(shí)例，您可以像上述例子中簡(jiǎn)單地調(diào)用默認(rèn)的無(wú)參數(shù)構(gòu)造函數(shù)。這將使用java.net包中的標(biāo)準(zhǔn)Java類(lèi)作為底層實(shí)現(xiàn)來(lái)創(chuàng)建HTTP請(qǐng)求。
但很多時(shí)候我們需要像傳統(tǒng)的HttpClient那樣設(shè)置HTTP請(qǐng)求的一些屬性。RestTemplate使用了一種很偷懶的方式實(shí)現(xiàn)了這個(gè)需求，那就是直接使用一個(gè)HttpClient作為底層實(shí)現(xiàn)......

        //生成一個(gè)設(shè)置了連接超時(shí)時(shí)間、請(qǐng)求超時(shí)時(shí)間、異常最大重試次數(shù)的httpClient
        RequestConfig config = RequestConfig.custom().setConnectionRequestTimeout(10000).setConnectTimeout(10000).setSocketTimeout(30000).build();
        HttpClientBuilder builder = HttpClientBuilder.create().setDefaultRequestConfig(config).setRetryHandler(new DefaultHttpRequestRetryHandler(5, false));
        HttpClient httpClient = builder.build();
        //使用httpClient創(chuàng)建一個(gè)ClientHttpRequestFactory的實(shí)現(xiàn)
        ClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
         //ClientHttpRequestFactory作為參數(shù)構(gòu)造一個(gè)使用作為底層的RestTemplate
        RestTemplate restTemplate = new RestTemplate(requestFactory);

五.設(shè)置攔截器(ClientHttpRequestInterceptor)

有時(shí)候我們需要對(duì)請(qǐng)求做一些通用的攔截設(shè)置，這就可以使用攔截器進(jìn)行處理。攔截器需要我們實(shí)現(xiàn)org.springframework.http.client.ClientHttpRequestInterceptor接口自己寫(xiě)。

舉個(gè)簡(jiǎn)單的例子，寫(xiě)一個(gè)在header中根據(jù)請(qǐng)求內(nèi)容和地址添加令牌的攔截器。

public class TokenInterceptor implements ClientHttpRequestInterceptor
{
    @Override
    public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException
    {
        //請(qǐng)求地址
        String checkTokenUrl = request.getURI().getPath();
        //token有效時(shí)間
        int ttTime = (int) (System.currentTimeMillis() / 1000 + 1800);
        //請(qǐng)求方法名 POST、GET等
        String methodName = request.getMethod().name();
        //請(qǐng)求內(nèi)容
        String requestBody = new String(body);
        //生成令牌 此處調(diào)用一個(gè)自己寫(xiě)的方法，有興趣的朋友可以自行g(shù)oogle如何使用ak/sk生成token，此方法跟本教程無(wú)關(guān)，就不貼出來(lái)了
        String token = TokenHelper.generateToken(checkTokenUrl, ttTime, methodName, requestBody);
        //將令牌放入請(qǐng)求header中
        request.getHeaders().add("X-Auth-Token",token);

        return execution.execute(request, body);
    }
}

創(chuàng)建RestTemplate實(shí)例的時(shí)候可以這樣向其中添加攔截器

        RestTemplate restTemplate = new RestTemplate();
        //向restTemplate中添加自定義的攔截器
        restTemplate.getInterceptors().add(new TokenInterceptor());

六.總結(jié)

通過(guò)本章的講解，想必讀者初步的了解了如何使用RestTemplate方便快捷的訪問(wèn)restful接口。其實(shí)RestTemplate的功能非常強(qiáng)大，作者也僅僅學(xué)了點(diǎn)皮毛。如果大家覺(jué)得本文有什么地方?jīng)]寫(xiě)清楚的或者有其他什么想要了解的可以在下方留言，我后續(xù)會(huì)盡量在文中進(jìn)行補(bǔ)充完善。