Spring RestTemplate简单说明
现在REST服务已经很普及了，在我们的程序中，经常会需要调用REST API，这时候会有很多选择，原始一点的JDK自带的，再进一步点使用HttpClient，或者说如果我们使用Jersey这种框架的话，也会自带rest client。但是我们项目使用的SpringMVC，所以直接使用RestTemplate。使用RestTemplate比直接使用Httpclient简单很多，同时也可以借助httpclient来实现RestTemplate。
通过使用RestTemplate仅仅只需要写几行代码，就可以完成直接使用httpclient很多行代码的事情,具体见：https://spring.io/blog/2009/03/27/rest-in-spring-3-resttemplate
RestTemplate有三个构造函数：
默认构造函数，默认使用SimpleClientHttpRequestFactory，使用JDK自带的java.net包进行网络传输。
public RestTemplate(ClientHttpRequestFactory requestFactory)。传入一个ClientHttpRequestFactory，ClientHttpRequestFactory在Spring中的实现有很多个，如HttpComponentsClientHttpRequestFactory，Netty4ClientHttpRequestFactory等，具体的可以看代码，这里只介绍HttpComponentsClientHttpRequestFactory，需要用到 HttpClient4.
public RestTemplate(List<HTTPMESSAGECONVERTER<?>> messageConverters),使用SpringMvc的应该对HttpMessageConverter很熟悉了，RestTemplate默认会给我们设置好常用的HttpMessageConverter，我一般很少使用到这个构造方法。
HttpComponentsClientHttpRequestFactory
这里主要讨论的是通过第二个构造方法来使用HttpClient4 来进行网络传输。下面我们来看下HttpComponentsClientHttpRequestFactory这个类。先看看他的构造方法
/**
* Create a new instance of the {@code HttpComponentsClientHttpRequestFactory}
* with a default {@link HttpClient}.
*/
public HttpComponentsClientHttpRequestFactory() {
this(HttpClients.createSystem());
}
/**
* Create a new instance of the {@code HttpComponentsClientHttpRequestFactory}
* with the given {@link HttpClient} instance.
* <p>As of Spring Framework 4.0, the given client is expected to be of type
* {@link CloseableHttpClient} (requiring HttpClient 4.3+).
* @param httpClient the HttpClient instance to use for this request factory
*/
public HttpComponentsClientHttpRequestFactory(HttpClient httpClient) {
Assert.notNull(httpClient,
"'httpClient' must not be null");
Assert.isInstanceOf(CloseableHttpClient.class, httpClient,
"'httpClient' is not of type CloseableHttpClient");
this.httpClient = (CloseableHttpClient) httpClient;
}
如果我们不指定一个HttpClient的话，会默认帮我们创建一个，如果我们程序调用比较频繁的话，为了提高性能，会考虑使用PoolingHttpClientConnectionManager来构建HttpClient，这时候就会使用到第二个。如何使用PoolingHttpClientConnectionManager来创建HttpClient呢？可以参考几个文章： 以及我前面的一篇： ，这里就不具体讲了，可以网上搜索相关资料。
下面写写代码来描述下怎么通过HttpComponentsClientHttpRequestFactory来创建RestTemplate,为了方便创建HttpClient的代码我就直接使用我前面文章中的代码:
import org.apache.http.config.Registry;
import org.apache.http.config.RegistryBuilder;
import org.apache.http.conn.socket.ConnectionSocketFactory;
import org.apache.http.conn.socket.PlainConnectionSocketFactory;
import org.apache.http.conn.ssl.NoopHostnameVerifier;
import org.apache.http.conn.ssl.SSLConnectionSocketFactory;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;
import org.apache.http.ssl.SSLContextBuilder;
import org.apache.http.ssl.TrustStrategy;
import javax.net.ssl.HostnameVerifier;
import javax.net.ssl.SSLContext;
import java.security.KeyManagementException;
import java.security.KeyStoreException;
import java.security.NoSuchAlgorithmException;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
/**
* Created by Administrator on 2015/6/8.
*/
public class HttpClientUtils {
public static CloseableHttpClient acceptsUntrustedCertsHttpClient() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException {
HttpClientBuilder b = HttpClientBuilder.create();
// setup a Trust Strategy that allows all certificates.
//
SSLContext sslContext =
new SSLContextBuilder().loadTrustMaterial(
null,
new TrustStrategy() {
public boolean isTrusted(X509Certificate[] arg0, String arg1) throws CertificateException {
return true;
}
}).build();
b.setSSLContext(sslContext);
// don't check Hostnames, either.
//
-- use SSLConnectionSocketFactory.getDefaultHostnameVerifier(), if you don't want to weaken
HostnameVerifier hostnameVerifier = NoopHostnameVerifier.INSTANCE;
// here's the special part:
//
-- need to create an SSL Socket Factory, to use our weakened "trust strategy";
//
-- and create a Registry, to register it.
//
SSLConnectionSocketFactory sslSocketFactory =
new SSLConnectionSocketFactory(sslContext, hostnameVerifier);
Registry<ConnectionSocketFactory> socketFactoryRegistry = RegistryBuilder.<ConnectionSocketFactory>create()
.register(
"http", PlainConnectionSocketFactory.getSocketFactory())
.register(
"https", sslSocketFactory)
.build();
// now, we create connection-manager using our Registry.
//
-- allows multi-threaded use
PoolingHttpClientConnectionManager connMgr =
new PoolingHttpClientConnectionManager( socketFactoryRegistry);
connMgr.setMaxTotal(
200);
connMgr.setDefaultMaxPerRoute(
100);
b.setConnectionManager( connMgr);
// finally, build the HttpClient;
//
-- done!
CloseableHttpClient client = b.build();
return client;
}
}
创建并使用RestTemplate
CloseableHttpClient httpClient = HttpClientUtils.acceptsUntrustedCertsHttpClient();
HttpComponentsClientHttpRequestFactory clientHttpRequestFactory =
new HttpComponentsClientHttpRequestFactory(httpClient);
RestTemplate restTemplate =
new RestTemplate(clientHttpRequestFactory);
String result = restTemplate.getForObject(
"http://www.baidu.com",String.class);
System.out.println(result);
