1Restemplate簡介:
1.1RestTemplate是Spring提供的用于訪問Rest服務的客戶端,RestTemplate類的設計原則與許多其他Spring *模板類(例如JdbcTemplate、JmsTemplate)相同,
2RestTemplate包含以下幾個部分:
2.1HttpMessageConverter 對象轉換器
RestTemplate默認使用HttpMessageConverter實例將HTTP消息轉換成POJO或者從POJO轉換成HTTP消息。默認情況下會注冊主mime類型的轉換器,但也可以通過setMessageConverters注冊其他的轉換器
例如:選好了HttpMessageConverter后怎么把它注冊到我們的RestTemplate中呢
RestTemplate restTemplate = new RestTemplate();
? ? ? ? //獲取RestTemplate默認配置好的所有轉換器
? ? ? ? List<HttpMessageConverter<?>> messageConverters = restTemplate.getMessageConverters();
? ? ? ? //默認的MappingJackson2HttpMessageConverter在第7個 先把它移除掉
? ? ? ? messageConverters.remove(6);
? ? ? ? //添加上GSON的轉換器
? ? ? ? messageConverters.add(6, new GsonHttpMessageConverter());
2.2ClientHttpRequestFactory 默認是JDK的HttpURLConnection
RestTemplate默認依賴JDK提供http連接的能力(HttpURLConnection),如果有需要的話也可以通過setRequestFactory方法替換為例如
Apache HttpComponents、Netty或OkHttp等其它HTTP library
設置底層連接方式
例如:使用一個HttpClient作為底層實現
要創建一個RestTemplate的實例,您可以像上述例子中簡單地調用默認的無參數構造函數。這將使用java.net包中的標準Java類作為底層實現來創建HTTP請求。
//生成一個設置了連接超時時間、請求超時時間、異常最大重試次數的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創建一個ClientHttpRequestFactory的實現
? ? ? ? ClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
? ? ? ?? //ClientHttpRequestFactory作為參數構造一個使用作為底層的RestTemplate
? ? ? ? RestTemplate restTemplate = new RestTemplate(requestFactory);
2.3ResponseErrorHandler 異常處理
2.4ClientHttpRequestInterceptor 請求攔截器
設置攔截器(ClientHttpRequestInterceptor)
有時候我們需要對請求做一些通用的攔截設置,這就可以使用攔截器進行處理。攔截器需要我們實現org.springframework.http.client.ClientHttpRequestInterceptor接口自己寫。
舉個簡單的例子,寫一個在header中根據請求內容和地址添加令牌的攔截器。
public class TokenInterceptor implements ClientHttpRequestInterceptor{
? ? @Override
? public ClientHttpResponse intercept(HttpRequest request, byte[] body,
ClientHttpRequestExecution execution) throws IOException{
? ? ? ? //請求地址
? ? ? ? String checkTokenUrl = request.getURI().getPath();
? ? ? ? //token有效時間
? ? ? ? int ttTime = (int) (System.currentTimeMillis() / 1000 + 1800);
? ? ? ? //請求方法名 POST、GET等
? ? ? ? String methodName = request.getMethod().name();
? ? ? ? //請求內容
? ? ? ? String requestBody = new String(body);
? ? ? ? //生成令牌 此處調用一個自己寫的方法,有興趣的朋友可以自行google如何使用ak/sk生成token,此方法跟本教程無關,就不貼出來了
? ? ? ? String token = TokenHelper.generateToken(checkTokenUrl, ttTime, methodName, requestBody);
? ? ? ? //將令牌放入請求header中
? ? ? ? request.getHeaders().add("X-Auth-Token",token);
? ? ? ? return execution.execute(request, body);
? ? }
}