httpclient 连接管理器

时间:2024-01-14 21:40:38

连接操作器

连接操作是客户端的底层套接字或可以通过外部实体,通常称为连接操作的被操作的状态的连接。
OperatedClientConnection接口扩展了HttpClientConnection接口而且定义了额外的控制连接套接字的方法。
ClientConnectionOperator接口代表了创建实例和更新那些对象底层套接字的策略。实现类最有可能利用SocketFactory来创建java.net.Socket实例。
ClientConnectionOperator接口可以让HttpClient的用户提供一乐连接操作的定制策略和提供可选实现OperatedClientConnection接口的能力。

管理连接和连接管理器

HTTP连接是复杂的,有状态,线程不安全的对象需要正确的管理以便正确的执行功能。http连接在同一时间仅仅只能由一个执行线程来使用。

Httpclient使用一个叫做http连接管理器的特殊实体类来管理http连接,这个实体类要实现HttpClientConnectionManager接口。
Http连接管理器作用:
Http连接管理器在新建http连接时,作为工厂类;
管理持久http连接的生命周期;
同步持久连接(确保线程安全,即一个http连接同一个时间只能被一个线程访问); http连接管理器和ManagedHttpClientConnection的实例类一起工作,为一个真实连接去充当一个代理服务,以管理连接状态和控制执行I/O操作。
ManagedHttpClientConnection实体类可以看做http连接的一个代理服务器,管理IO操作。
如果一个http连接被释放或者被它的消费者明确的表示要关闭,那么底层的连接就会和它的代理进行分离,并且该连接会被交还给连接管理器。
即使服务消费者仍然持有代理的引用,但它不能再执行IO操作,或者更改http连接的状态。
HttpClientContext context = HttpClientContext.create();
HttpClientConnectionManager connMrg = new BasicHttpClientConnectionManager();
HttpRoute route = new HttpRoute(new HttpHost("localhost",80));
//获取新的连接,这里可能耗费很多时间
ConnectionRequest connRequest = connMrg.requestConnection(route,null);
//10秒超时
HttpClientConnection conn = connRequest.get(10,TimeUnit.SECONDS);
try{
 //如果创建失败
 if(!conn.isOpen()){
  //establish connection based on its route info
   connMrg.connect(conn,route,1000,context);
}else{
   //and mark it as route complete
   connMrg.routeComplete(conn,route,context);
}
}finally{
 connMrg.releaseConnection(conn,null,1,TimeUnit.MINUTES);
}
如果要终止连接,可以调用ConnectionRequest的cancel()方法。这个方法会解锁被ConnectionRequest类get()方法阻塞的线程。

简单连接管理器

BasicHttpClientConnectionManager是一个简单的连接管理器,它一次只能管理一个连接。尽管这个类是线程安全的,它在同一个时间也只能被一个线程使用。
BasicHttpClientConnectionManager会尽量重用旧的连接来发送后续的请求,并且使用相同的路由。如果后续请求的路由和旧连接中的路由不匹配,BasichttpClientConnectionManager就会关闭当前连接,使用请求中的路由重新建立连接。如果当前的连接正在被占用,会抛出java.lang.IllegalStateException异常。
ClientConnectionRequest connRequest = connMrg.requestConnection(
new HttpRoute(new HttpHost("localhost", 80)), null);
ManagedClientConnection conn = connRequest.getConnection(10, TimeUnit.SECONDS);
try {
  BasicHttpRequest request = new BasicHttpRequest("GET", "/");
  conn.sendRequestHeader(request);
  HttpResponse response = conn.receiveResponseHeader();
  conn.receiveResponseEntity(response);
  HttpEntity entity = response.getEntity();
  if (entity != null) {
     BasicManagedEntity managedEntity = new BasicManagedEntity(entity, conn, true);
     // 替换实体
     response.setEntity(managedEntity);
  }
  // 使用响应对象做有用的事情。当响应内容被消耗后这个连接将会自动释放。
  connMrg.releaseConnection(conn,null,1,TimeUnit.MINUTES);
} catch (IOException ex) {
  //在I/O error之上终止连接。
 conn.cancel();
 throw ex;
}

连接池管理器

相对BasicHttpClientConnectionManager来说,PoolingHttpClientConnectionManager是一个复杂的类,它管理着客户端连接池,可以同时为很多线程提供Http连接请求。
当请求一个新的连接时,如果连接池有可用的持久连接,连接管理器就会使用其中的一个,而不是在创建一个新的连接。PoolingHttpClientConnectionManager维护的连接数在每个路由基础和总数上都有限制,默认每个路由基础上的连接不超过2个,总连接数不能超过20.
在实际应用中,这个限制可能会太小了,尤其是当服务器也使用http协议时。 PoolingHttpClientConnectionManager cm = new PoolingHttpClientConnectionManager();
cm.setMaxTotal(200);
cm.setDefaultMaxPerRoute(20);
HttpHost localhost = new HttpHost("localhost",80);
cm.setMaxPerRoute(new HttpRoute(localhost),50);
CloseableHttpClient httpClient = HttpClients.custom()
                                          .setConnectionManager(cm)
                                          .build();

连接管理器关闭

当一个HttpClient实例不在需要并且即将离开其作用范围的时候,要关闭它的连接管理器以确保所有连接在管理器被关闭后保持活跃,并且这些连接的系统资源会被释放掉。
CloseableHttpClient httpClient=<....>
httpClient.close();
DefaultHttpClient httpclient = new DefaultHttpClient();
HttpGet httpget = new HttpGet("http://www.google.com/");
HttpResponse response = httpclient.execute(httpget);
HttpEntity entity = response.getEntity();
System.out.println(response.getStatusLine());
if (entity != null) {
  entity.consumeContent();
}
httpclient.getConnectionManager().shutdown();

连接管理参数

http.conn-manager.timeout
定义了当从ClientConnectionManager中检索ManagedClientConnection实例时使用的毫秒级超时时间。
如果这个参数没有设置就不会超时(默认无限大超时)
http.conn-manager.max-per-route
定义了每个路由连接的最大数量。这个限制由客户端连接管理器来解释,而且应用与独立的管理器实例,为ConnPerRoute类型的值
http.conn-manager.max-total
定义了总共连接的最大数目。这个限制由客户端连接管理器来解释,而且应用于独立的管理器实例。Integer类型的值。