• RestTemplate实践


    什么是RestTemplate?

    RestTemplate是Spring提供的用于访问Rest服务的客户端,RestTemplate提供了多种便捷访问远程Http服务的方法,能够大大提高客户端的编写效率。
    调用RestTemplate的默认构造函数,RestTemplate对象在底层通过使用java.net包下的实现创建HTTP 请求,可以通过使用ClientHttpRequestFactory指定不同的HTTP请求方式。
    ClientHttpRequestFactory接口主要提供了两种实现方式

    • 一种是SimpleClientHttpRequestFactory,使用J2SE提供的方式(既java.net包提供的方式)创建底层的Http请求连接。
    • 一种方式是使用HttpComponentsClientHttpRequestFactory方式,底层使用HttpClient访问远程的Http服务,使用HttpClient可以配置连接池和证书等信息。

    xml配置的方式

    请查看RestTemplate源码了解细节,知其然知其所以然!

    RestTemplate默认是使用SimpleClientHttpRequestFactory,内部是调用jdk的HttpConnection,默认超时为-1

    @Autowired
    RestTemplate simpleRestTemplate
    @Autowired
    RestTemplate restTemplate

    基于jdk的spring的RestTemplate

    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"
           default-autowire="byName" default-lazy-init="true">
    
        <!--方式一、使用jdk的实现-->
        <bean id="ky.requestFactory" class="org.springframework.http.client.SimpleClientHttpRequestFactory">
            <property name="readTimeout" value="10000"/>
            <property name="connectTimeout" value="5000"/>
        </bean>
    
        <bean id="simpleRestTemplate" class="org.springframework.web.client.RestTemplate">
            <constructor-arg ref="ky.requestFactory"/>
            <property name="messageConverters">
                <list>
                    <bean class="org.springframework.http.converter.FormHttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                        <property name="supportedMediaTypes">
                            <list>
                                <value>text/plain;charset=UTF-8</value>
                            </list>
                        </property>
                    </bean>
                </list>
            </property>
        </bean>
    
    </beans>

    使用Httpclient连接池的方式

    <?xml version="1.0" encoding="UTF-8"?>
    <beans xmlns="http://www.springframework.org/schema/beans"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd"
           default-autowire="byName" default-lazy-init="true">
    
        <!--方式二、使用httpclient的实现,带连接池-->
        <bean id="ky.pollingConnectionManager" class="org.apache.http.impl.conn.PoolingHttpClientConnectionManager">
            <!--整个连接池的并发-->
            <property name="maxTotal" value="1000" />
            <!--每个主机的并发-->
            <property name="defaultMaxPerRoute" value="1000" />
        </bean>
    
        <bean id="ky.httpClientBuilder" class="org.apache.http.impl.client.HttpClientBuilder" factory-method="create">
            <property name="connectionManager" ref="ky.pollingConnectionManager" />
            <!--开启重试-->
            <property name="retryHandler">
                <bean class="org.apache.http.impl.client.DefaultHttpRequestRetryHandler">
                    <constructor-arg value="2"/>
                    <constructor-arg value="true"/>
                </bean>
            </property>
            <property name="defaultHeaders">
                <list>
                    <bean class="org.apache.http.message.BasicHeader">
                        <constructor-arg value="User-Agent"/>
                        <constructor-arg value="Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.16 Safari/537.36"/>
                    </bean>
                    <bean class="org.apache.http.message.BasicHeader">
                        <constructor-arg value="Accept-Encoding"/>
                        <constructor-arg value="gzip,deflate"/>
                    </bean>
                    <bean class="org.apache.http.message.BasicHeader">
                        <constructor-arg value="Accept-Language"/>
                        <constructor-arg value="zh-CN"/>
                    </bean>
                </list>
            </property>
        </bean>
    
        <bean id="ky.httpClient" factory-bean="ky.httpClientBuilder" factory-method="build" />
    
        <bean id="ky.clientHttpRequestFactory" class="org.springframework.http.client.HttpComponentsClientHttpRequestFactory">
            <constructor-arg ref="ky.httpClient"/>
            <!--连接超时时间,毫秒-->
            <property name="connectTimeout" value="5000"/>
            <!--读写超时时间,毫秒-->
            <property name="readTimeout" value="10000"/>
        </bean>
    
        <bean id="restTemplate" class="org.springframework.web.client.RestTemplate">
            <constructor-arg ref="ky.clientHttpRequestFactory"/>
            <property name="errorHandler">
                <bean class="org.springframework.web.client.DefaultResponseErrorHandler"/>
            </property>
            <property name="messageConverters">
                <list>
                    <bean class="org.springframework.http.converter.FormHttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
                    <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                        <property name="supportedMediaTypes">
                            <list>
                                <value>text/plain;charset=UTF-8</value>
                            </list>
                        </property>
                    </bean>
                </list>
            </property>
        </bean>
    
    </beans>

    bean初始化+静态工具

    线程安全的单例(懒汉模式)

    基于jdk的spring的RestTemplate

    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.context.annotation.Lazy;
    import org.springframework.http.client.SimpleClientHttpRequestFactory;
    import org.springframework.http.converter.FormHttpMessageConverter;
    import org.springframework.http.converter.HttpMessageConverter;
    import org.springframework.http.converter.StringHttpMessageConverter;
    import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
    import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter;
    import org.springframework.stereotype.Component;
    import org.springframework.web.client.DefaultResponseErrorHandler;
    import org.springframework.web.client.RestTemplate;
    
    import javax.annotation.PostConstruct;
    import java.nio.charset.Charset;
    import java.util.ArrayList;
    import java.util.List;
    
    /**
     * @title:基于jdk的spring的RestTemplate
     * @author:liuxing
     * @date:2015-05-18 09:35
     */
    @Component
    @Lazy(false)
    public class SimpleRestClient {
    
        private static final Logger LOGGER = LoggerFactory.getLogger(SimpleRestClient.class);
    
        private static RestTemplate restTemplate;
    
        static {
            SimpleClientHttpRequestFactory requestFactory = new SimpleClientHttpRequestFactory();
            requestFactory.setReadTimeout(5000);
            requestFactory.setConnectTimeout(5000);
    
            // 添加转换器
            List<HttpMessageConverter<?>> messageConverters = new ArrayList<>();
            messageConverters.add(new StringHttpMessageConverter(Charset.forName("UTF-8")));
            messageConverters.add(new FormHttpMessageConverter());
            messageConverters.add(new MappingJackson2XmlHttpMessageConverter());
            messageConverters.add(new MappingJackson2HttpMessageConverter());
    
            restTemplate = new RestTemplate(messageConverters);
            restTemplate.setRequestFactory(requestFactory);
            restTemplate.setErrorHandler(new DefaultResponseErrorHandler());
    
            LOGGER.info("SimpleRestClient初始化完成");
        }
    
        private SimpleRestClient() {
    
        }
    
        @PostConstruct
        public static RestTemplate getClient() {
            return restTemplate;
        }
    
    }

    使用Httpclient连接池的方式

    import org.apache.http.Header;
    import org.apache.http.client.HttpClient;
    import org.apache.http.impl.client.DefaultConnectionKeepAliveStrategy;
    import org.apache.http.impl.client.DefaultHttpRequestRetryHandler;
    import org.apache.http.impl.client.HttpClientBuilder;
    import org.apache.http.impl.client.HttpClients;
    import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
    import org.apache.http.message.BasicHeader;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    import org.springframework.context.annotation.Lazy;
    import org.springframework.http.client.HttpComponentsClientHttpRequestFactory;
    import org.springframework.http.converter.FormHttpMessageConverter;
    import org.springframework.http.converter.HttpMessageConverter;
    import org.springframework.http.converter.StringHttpMessageConverter;
    import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
    import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter;
    import org.springframework.stereotype.Component;
    import org.springframework.web.client.DefaultResponseErrorHandler;
    import org.springframework.web.client.RestTemplate;
    
    import javax.annotation.PostConstruct;
    import java.nio.charset.Charset;
    import java.util.ArrayList;
    import java.util.List;
    import java.util.concurrent.TimeUnit;
    
    /**
     * @title:使用spring的restTemplate替代httpclient工具
     * @author:liuxing
     * @date:2015-05-18 08:48
     */
    public class RestClient {
    
        private static final Logger LOGGER = LoggerFactory.getLogger(SimpleRestClient.class);
    
        private static RestTemplate restTemplate;
    
        static {
            // 长连接保持30秒
            PoolingHttpClientConnectionManager pollingConnectionManager = new PoolingHttpClientConnectionManager(30, TimeUnit.SECONDS);
            // 总连接数
            pollingConnectionManager.setMaxTotal(500);
            // 同路由的并发数
            pollingConnectionManager.setDefaultMaxPerRoute(500);
    
            HttpClientBuilder httpClientBuilder = HttpClients.custom();
            httpClientBuilder.setConnectionManager(pollingConnectionManager);
            // 重试次数,默认是3次,没有开启
            httpClientBuilder.setRetryHandler(new DefaultHttpRequestRetryHandler(2, true));
            // 保持长连接配置,需要在头添加Keep-Alive
            httpClientBuilder.setKeepAliveStrategy(DefaultConnectionKeepAliveStrategy.INSTANCE);
    
            List<Header> headers = new ArrayList<>();
            headers.add(new BasicHeader("User-Agent", "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.16 Safari/537.36"));
            headers.add(new BasicHeader("Accept-Encoding", "gzip,deflate"));
            headers.add(new BasicHeader("Accept-Language", "zh-CN,zh;q=0.8,en;q=0.6"));
            headers.add(new BasicHeader("Connection", "keep-alive"));
    
            httpClientBuilder.setDefaultHeaders(headers);
    
            HttpClient httpClient = httpClientBuilder.build();
    
            // httpClient连接配置,底层是配置RequestConfig
            HttpComponentsClientHttpRequestFactory clientHttpRequestFactory = new HttpComponentsClientHttpRequestFactory(httpClient);
            // 连接超时
            clientHttpRequestFactory.setConnectTimeout(5000);
            // 数据读取超时时间,即SocketTimeout
            clientHttpRequestFactory.setReadTimeout(5000);
            // 连接不够用的等待时间,不宜过长,必须设置,比如连接不够用时,时间过长将是灾难性的
            clientHttpRequestFactory.setConnectionRequestTimeout(200);
            // 缓冲请求数据,默认值是true。通过POST或者PUT大量发送数据时,建议将此属性更改为false,以免耗尽内存。
            // clientHttpRequestFactory.setBufferRequestBody(false);
    
            // 添加内容转换器
            List<HttpMessageConverter<?>> messageConverters = new ArrayList<>();
            messageConverters.add(new StringHttpMessageConverter(Charset.forName("UTF-8")));
            messageConverters.add(new FormHttpMessageConverter());
            messageConverters.add(new MappingJackson2XmlHttpMessageConverter());
            messageConverters.add(new MappingJackson2HttpMessageConverter());
            messageConverters.add(new ByteArrayHttpMessageConverter());
    
            restTemplate = new RestTemplate(messageConverters);
            restTemplate.setRequestFactory(clientHttpRequestFactory);
            restTemplate.setErrorHandler(new DefaultResponseErrorHandler());
    
            LOGGER.info("RestClient初始化完成");
        }
    
        private RestClient() {
    
        }
    
        public static RestTemplate getClient() {
            return restTemplate;
        }
    
    }

    使用样例

    注意点

    api里面可以做自动的参数匹配:
    如:http://you domainn name/test?empNo={empNo},则下面方法的最后一个参数为数据匹配参数,会自动根据key进行查找,然后替换

    API没有声明异常,注意进行异常处理

    更多使用语法请查看API文档

    完整的实例代码

    定义一个异常

    import org.springframework.core.NestedRuntimeException;
    import org.springframework.http.HttpHeaders;
    import org.springframework.http.HttpStatus;
    import org.springframework.web.client.HttpClientErrorException;
    import org.springframework.web.client.HttpServerErrorException;
    
    /**
     * 包装一个RestClient请求时抛出的异常
     *
     * @author :liuxing
     * @since :2015-07-15 21:33
     */
    public class RestClientException extends NestedRuntimeException {
    
        /**
         * 状态码
         */
        private HttpStatus statusCode;
        /**
         * 状态码文本
         */
        private String statusText;
        /**
         * 异常时返回的内容
         */
        private String responseBody;
        /**
         * 返回的头
         */
        private HttpHeaders responseHeaders;
    
        public RestClientException(Exception exception) {
            super(exception.getMessage(), exception);
    
            if (exception instanceof HttpServerErrorException) {
                HttpServerErrorException e = (HttpServerErrorException) exception;
    
                this.statusCode = e.getStatusCode();
                this.statusText = e.getStatusText();
                this.responseBody = e.getResponseBodyAsString();
                this.responseHeaders = e.getResponseHeaders();
            } else if (exception instanceof HttpClientErrorException) {
                HttpClientErrorException e = (HttpClientErrorException) exception;
    
                this.statusCode = e.getStatusCode();
                this.statusText = e.getStatusText();
                this.responseBody = e.getResponseBodyAsString();
                this.responseHeaders = e.getResponseHeaders();
            } else {
                this.statusText = exception.getMessage();
            }
        }
    
        public HttpStatus getStatusCode() {
            return statusCode;
        }
    
        public void setStatusCode(HttpStatus statusCode) {
            this.statusCode = statusCode;
        }
    
        public String getStatusText() {
            return statusText;
        }
    
        public void setStatusText(String statusText) {
            this.statusText = statusText;
        }
    
        public String getResponseBody() {
            return responseBody;
        }
    
        public void setResponseBody(String responseBody) {
            this.responseBody = responseBody;
        }
    
        public HttpHeaders getResponseHeaders() {
            return responseHeaders;
        }
    
        public void setResponseHeaders(HttpHeaders responseHeaders) {
            this.responseHeaders = responseHeaders;
        }
    }

    工具集

    import com.dooioo.se.commons.Lang;
    import com.dooioo.se.utils.RestClientBuilder;
    import org.apache.commons.beanutils.BeanUtils;
    import org.apache.commons.collections.MapUtils;
    import org.springframework.core.ParameterizedTypeReference;
    import org.springframework.http.HttpEntity;
    import org.springframework.http.HttpHeaders;
    import org.springframework.http.HttpMethod;
    import org.springframework.http.MediaType;
    import org.springframework.util.LinkedMultiValueMap;
    import org.springframework.util.MultiValueMap;
    import org.springframework.web.client.RestTemplate;
    
    import java.lang.reflect.Field;
    import java.util.Collection;
    import java.util.HashMap;
    import java.util.Map;
    
    /**
     * httpclient工具类,基于httpclient 4.x
     * 不需要设置header的情况:
     * 1.普通的非校验型请求
     * 2.普通的表单请求
     * <p/>
     * 需要设置header的情况:
     * 1.头部带token校验的请求
     * 2.提交json数据的请求
     *
     * @author 刘兴
     * @version V1.0
     * @since 2014-3-7 下午7:48:58
     */
    public class RestClient {
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param responseType 返回的数据类型
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, Class<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, null, null, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param headers      设置的头信息
         * @param responseType 返回的数据类型
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, HttpHeaders headers, Class<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, headers, null, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param body         要提交的数据
         * @param responseType 返回数据类型
         *                     返回bean时指定Class
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, Object body, Class<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, null, body, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param httpHeaders  请求头
         * @param body         要提交的数据
         * @param responseType 返回数据类型
         *                     返回bean时指定Class
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, HttpHeaders httpHeaders, Object body, Class<T> responseType, Object... uriVariables) throws RestClientException {
            try {
                HttpEntity<?> requestEntity = new HttpEntity(body, httpHeaders);
                requestEntity = convert(requestEntity);
    
                if (uriVariables.length == 1 && uriVariables[0] instanceof Map) {
                    Map<String, ?> _uriVariables = (Map<String, ?>) uriVariables[0];
                    return getClient().exchange(url, method, requestEntity, responseType, _uriVariables).getBody();
                }
    
                return getClient().exchange(url, method, requestEntity, responseType, uriVariables).getBody();
            } catch (Exception e) {
                throw new RestClientException(e);
            }
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param responseType 返回的数据类型,例:new ParameterizedTypeReference<List<Bean>>(){}
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, ParameterizedTypeReference<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, null, null, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param headers      设置的头信息
         * @param responseType 返回的数据类型,例:new ParameterizedTypeReference<List<Bean>>(){}
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, HttpHeaders headers, ParameterizedTypeReference<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, headers, null, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param body         要提交的数据
         * @param responseType 返回数据类型,例:new ParameterizedTypeReference<List<Bean>>(){}
         *                     返回bean时指定Class
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, Object body, ParameterizedTypeReference<T> responseType, Object... uriVariables) throws RestClientException {
            return exchange(url, method, null, body, responseType, uriVariables);
        }
    
        /**
         * 执行请求
         *
         * @param url          请求地址
         * @param method       请求方式
         * @param httpHeaders  请求头
         * @param body         要提交的数据
         * @param responseType 返回数据类型,例:new ParameterizedTypeReference<List<Bean>>(){}
         *                     返回bean时指定Class
         * @param uriVariables url自动匹配替换的参数,如url为api/{a}/{b},参数为["1","2"],则解析的url为api/1/2,使用Map参数时,遵循按key匹配
         * @return 结果对象
         * @throws RestClientException RestClient异常,包含状态码和非200的返回内容
         */
        public static <T> T exchange(String url, HttpMethod method, HttpHeaders httpHeaders, Object body, ParameterizedTypeReference<T> responseType, Object... uriVariables) throws RestClientException {
            try {
                HttpEntity<?> requestEntity = new HttpEntity(body, httpHeaders);
                requestEntity = convert(requestEntity);
    
                if (uriVariables.length == 1 && uriVariables[0] instanceof Map) {
                    Map<String, ?> _uriVariables = (Map<String, ?>) uriVariables[0];
                    return getClient().exchange(url, method, requestEntity, responseType, _uriVariables).getBody();
                }
    
                return getClient().exchange(url, method, requestEntity, responseType, uriVariables).getBody();
            } catch (Exception e) {
                throw new RestClientException(e);
            }
        }
    
        /**
         * 获得一个RestTemplate客户端
         *
         * @return
         */
        public static RestTemplate getClient() {
            return RestClientBuilder.build();
        }
    
        /**
         * 获取一个application/x-www-form-urlencoded头
         *
         * @return
         */
        public static HttpHeaders buildBasicFORMHeaders() {
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);
            return headers;
        }
    
        /**
         * 获取一个application/json头
         *
         * @return
         */
        public static HttpHeaders buildBasicJSONHeaders() {
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            return headers;
        }
    
        /**
         * 获取一个text/html头
         *
         * @return
         */
        public static HttpHeaders buildBasicHTMLHeaders() {
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.TEXT_HTML);
            return headers;
        }
    
        /**
         * 构建一个json头
         *
         * @param arrays
         * @return
         */
        public static HttpHeaders buildJSONHeaders(Object... arrays) {
            if (arrays.length % 2 != 0) {
                throw new RuntimeException("arrays 长度 必须为偶数");
            }
    
            HttpHeaders headers = buildBasicJSONHeaders();
    
            for (int i = 0; i < arrays.length; i++) {
                headers.add(Lang.defaultEmptyStr(arrays[i]), Lang.defaultEmptyStr(arrays[++i]));
            }
    
            return headers;
        }
    
        /**
         * 对bean对象转表单模型做处理
         *
         * @param requestEntity
         * @return
         */
        private static HttpEntity<?> convert(HttpEntity<?> requestEntity) {
            Object body = requestEntity.getBody();
            HttpHeaders headers = requestEntity.getHeaders();
    
            if (body == null) {
                return requestEntity;
            }
    
            if (body instanceof Map) {
                MultiValueMap<String, String> multiValueMap = new LinkedMultiValueMap<>();
                Map<String, ?> _body = (Map<String, ?>) body;
                for (String key : _body.keySet()) {
                    multiValueMap.add(key, MapUtils.getString(_body, key));
                }
    
                requestEntity = new HttpEntity<>(multiValueMap, headers);
            }
    
            if (headers == null || !MediaType.APPLICATION_FORM_URLENCODED.equals(headers.getContentType())) {
                return requestEntity;
            }
    
            if (body instanceof String) {
                return requestEntity;
            }
    
            if (body instanceof Collection) {
                return requestEntity;
            }
    
            if (body instanceof Map) {
                return requestEntity;
            }
    
            MultiValueMap<String, Object> formEntity = new LinkedMultiValueMap<>();
    
            Field[] fields = body.getClass().getDeclaredFields();
            for (int i = 0; i < fields.length; i++) {
                String name = fields[i].getName();
                String value = null;
    
                try {
                    value = BeanUtils.getProperty(body, name);
                } catch (Exception e) {
                    e.printStackTrace();
                }
    
                formEntity.add(name, value);
            }
    
            return new HttpEntity<>(formEntity, headers);
        }
    
        public final static Object[] EMPTY_URI_VARIABLES = new Object[]{};
    
        public final static HttpHeaders EMPTY_HEADERS = new HttpHeaders();
    
        public final static Map<String, ?> EMPTY_BODY = new HashMap<>(1);
    
        public final static HttpEntity EMPTY_ENTITY = new HttpEntity(EMPTY_HEADERS);
    
    }

    更多

    RestTemplate API说明和使用参考

    http://docs.spring.io/spring/docs/4.1.x/javadoc-api/org/springframework/web/client/RestTemplate.html

    http://docs.spring.io/spring/docs/4.1.x/javadoc-api/org/springframework/http/client/SimpleClientHttpRequestFactory.html

    http://docs.spring.io/spring/docs/4.1.x/javadoc-api/org/springframework/http/client/HttpComponentsClientHttpRequestFactory.html

    HttpClient官方示例和参数配置说明

    http://hc.apache.org/httpcomponents-client-4.4.x/examples.html

    http://hc.apache.org/httpcomponents-client-4.4.x/tutorial/html/index.html

    依赖
    spring 3.x以上

    <dependency>
        <groupId>com.fasterxml.jackson.dataformat</groupId>
        <artifactId>jackson-dataformat-xml</artifactId>
        <version>2.5.3</version>
    </dependency>
    
    <dependency>
        <groupId>org.codehaus.jackson</groupId>
        <artifactId>jackson-mapper-asl</artifactId>
        <version>1.9.13</version>
    </dependency>

    注意点

    1.关于httpclient配置的defaultMaxPerRoutemaxTotal
    defaultMaxPerRoute:最大路由并发数,以主机为单位
    maxTotal:整个连接池的并发数

    例如:
    defaultMaxPerRoute为10,maxTotal为100
    假设只会访问http://www.baidu.com和http://www.google.com
    那么能同时并发到客源的只能是10,房源也是10,整个连接永远不会到100

    2.部分方法注意查看源码,默认构造里面会新增常用的数据转换器,spring对jackson比较情有独钟,在解析xml和json时,优先使用jackson

    /**
     * Create a new instance of the {@link RestTemplate} using default settings.
     * Default {@link HttpMessageConverter}s are initialized.
     */
    public RestTemplate() {
        this.messageConverters.add(new ByteArrayHttpMessageConverter());
        this.messageConverters.add(new StringHttpMessageConverter());
        this.messageConverters.add(new ResourceHttpMessageConverter());
        this.messageConverters.add(new SourceHttpMessageConverter<Source>());
        this.messageConverters.add(new AllEncompassingFormHttpMessageConverter());
    
        if (romePresent) {
                this.messageConverters.add(new AtomFeedHttpMessageConverter());
                this.messageConverters.add(new RssChannelHttpMessageConverter());
        }
        if (jackson2XmlPresent) {
                messageConverters.add(new MappingJackson2XmlHttpMessageConverter());
        }
        else if (jaxb2Present) {
                this.messageConverters.add(new Jaxb2RootElementHttpMessageConverter());
        }
        if (jackson2Present) {
                this.messageConverters.add(new MappingJackson2HttpMessageConverter());
        }
        else if (gsonPresent) {
                this.messageConverters.add(new GsonHttpMessageConverter());
        }
    }
    
    /**
     * Create a new instance of the {@link RestTemplate} based on the given {@link ClientHttpRequestFactory}.
     * @param requestFactory HTTP request factory to use
     * @see org.springframework.http.client.SimpleClientHttpRequestFactory
     * @see org.springframework.http.client.HttpComponentsClientHttpRequestFactory
     */
    public RestTemplate(ClientHttpRequestFactory requestFactory) {
        this();
        setRequestFactory(requestFactory);
    }

    再看添加转换器的方法外部添加转换器时,this.messageConverters.clear();会先清除已有的,需要注意

    /**
     * Create a new instance of the {@link RestTemplate} using the given list of
     * {@link HttpMessageConverter} to use
     * @param messageConverters the list of {@link HttpMessageConverter} to use
     * @since 3.2.7
     */
    public RestTemplate(List<HttpMessageConverter<?>> messageConverters) {
        Assert.notEmpty(messageConverters, "'messageConverters' must not be empty");
        this.messageConverters.addAll(messageConverters);
    }
    
    
    /**
     * Set the message body converters to use.
     * <p>These converters are used to convert from and to HTTP requests and responses.
     */
    public void setMessageConverters(List<HttpMessageConverter<?>> messageConverters) {
        Assert.notEmpty(messageConverters, "'messageConverters' must not be empty");
        // Take getMessageConverters() List as-is when passed in here
        if (this.messageConverters != messageConverters) {
                this.messageConverters.clear();
                this.messageConverters.addAll(messageConverters);
        }
    }

    本文转自:http://liuxing.info/2015/05/21/RestTemplate%E5%AE%9E%E8%B7%B5/#基于jdk的spring的RestTemplate

  • 相关阅读:
    【BZOJ2434】[NOI2011]阿狸的打字机 AC自动机+DFS序+树状数组
    【BZOJ1030】[JSOI2007]文本生成器 AC自动机+动态规划
    【BZOJ3943】[Usaco2015 Feb]SuperBull 最大生成树
    【BZOJ3940】【BZOJ3942】[Usaco2015 Feb]Censoring AC自动机/KMP/hash+栈
    【BZOJ3172】[Tjoi2013]单词 AC自动机
    【HDU2896】病毒侵袭 AC自动机
    【HDU2222】Keywords Search AC自动机
    【BZOJ1662】[Usaco2006 Nov]Round Numbers 圆环数 数位DP
    结婚晚了
    无毒食品
  • 原文地址:https://www.cnblogs.com/dreammyle/p/5497091.html
Copyright © 2020-2023  润新知