阅读 192

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,也不会抛出异常。方便我们更加自定义的编码。


返回目录

关注下面的标签,发现更多相似文章
评论