SpringCloud学习之－RestTemplate使用详解

上一篇学习了如何使用RestTemplate发送http请求，可是讲解比较简单。因此这篇更加详细的探究一下RestTemplate的使用。

首先咱们得知道RestTemplate是基于http请求的封装，因此咱们就能够根据http请求相关属性来学习RestTemplate的使用。

1.请求链接时间和读取时间的设置

在http请求中，有一个最大的链接时间和读取时间的设置，那这个在RestTemplate中该怎么设置呢？

public RestTemplate(ClientHttpRequestFactory requestFactory) {
		this();
		setRequestFactory(requestFactory);
	}
复制代码

查看RestTemplate的构造函数，咱们能够传递一个ClientHttpRequestFactory对象进去（经过set方法也能够设置该属性）。查看源码，该对象的默认值是SimpleClientHttpRequestFactory。在SimpleClientHttpRequestFactory对象中，咱们就能够设置connectTimeout和readTimeout两个属性了。

2.如何设置请求头

在上一期使用getForObject方法的时候，咱们并无设置请求头相关的属性，若是须要设置该怎么办呢？

这个时候能够使用RestTemplate的exchange方法。

<T> ResponseEntity<T> exchange(String url, HttpMethod method, @Nullable HttpEntity<?> requestEntity,
			Class<T> responseType, Object... uriVariables) throws RestClientException;
复制代码

exchange方法中第三个参数为HttpEntity，在HttpEntity中咱们就能够设置请求头相关属性了。

另外，除了getForXXX方法外，像postForObject方法能够直接将HttpEntity对象做为request传进去。RestTemplate会自动解析。

public <T> T postForObject(String url, @Nullable Object request, Class<T> responseType,
		Object... uriVariables) throws RestClientException {

	RequestCallback requestCallback = httpEntityCallback(request, responseType);
	HttpMessageConverterExtractor<T> responseExtractor =
			new HttpMessageConverterExtractor<>(responseType, getMessageConverters(), logger);
    return execute(url, HttpMethod.POST, requestCallback,responseExtractor, uriVariables);
}
	
public <T> RequestCallback httpEntityCallback(@Nullable Object requestBody, Type responseType) {
	return new HttpEntityRequestCallback(requestBody, responseType);
}

public HttpEntityRequestCallback(@Nullable Object requestBody, @Nullable Type responseType) {
	super(responseType);
	//判断request对象属性是不是HttpEntity
	if (requestBody instanceof HttpEntity) {
		this.requestEntity = (HttpEntity<?>) requestBody;
	}
	else if (requestBody != null) {
		this.requestEntity = new HttpEntity<>(requestBody);
	}
	else {
		this.requestEntity = HttpEntity.EMPTY;
	}
}
复制代码

3.如何获取响应头及状态码信息

若是想要获取响应头相关的信息，能够经过XXXForEntity相关的方法，获取到ResponseEntity对象，经过ResponseEntity对象就能够获取到响应头和响应状态码了。

可是在默认状况下，若是响应的状态码不为200的话，依然会抛出异常。由于默认的ResponseErrorHandler就是这么干的。

private ResponseErrorHandler errorHandler = new DefaultResponseErrorHandler();

	protected void handleError(ClientHttpResponse response, HttpStatus statusCode) throws IOException {
		String statusText = response.getStatusText();
		HttpHeaders headers = response.getHeaders();
		byte[] body = getResponseBody(response);
		Charset charset = getCharset(response);
		switch (statusCode.series()) {
			case CLIENT_ERROR:
				throw HttpClientErrorException.create(statusCode, statusText, headers, body, charset);
			case SERVER_ERROR:
				throw HttpServerErrorException.create(statusCode, statusText, headers, body, charset);
			default:
				throw new UnknownHttpStatusCodeException(statusCode.value(), statusText, headers, body, charset);
		}
	}
复制代码

若是想自定义的话能够本身实现一个ResponseErrorHandler，

RestTemplate template = new RestTemplate();
template.setErrorHandler(new ResponseErrorHandler() {
    @Override
    public boolean hasError(ClientHttpResponse response) throws IOException {
        return false;
    }
    @Override
    public void handleError(ClientHttpResponse response) throws IOException {
    }
});
复制代码

这样的话即使是返回吗不为200，也不会抛出异常。方便咱们更加自定义的编码。

---

返回目录