afinal框架网络

请求网络的方式感觉平时漏掉了很多：

/**
 * Copyright (c) 2012-2013, Michael Yang 杨福海 (www.yangfuhai.com).
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package net.tsz.afinal;

import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.Executor;
import java.util.concurrent.Executors;
import java.util.concurrent.ThreadFactory;
import java.util.concurrent.atomic.AtomicInteger;
import java.util.zip.GZIPInputStream;

import net.tsz.afinal.http.AjaxCallBack;
import net.tsz.afinal.http.AjaxParams;
import net.tsz.afinal.http.HttpHandler;
import net.tsz.afinal.http.RetryHandler;
import net.tsz.afinal.http.SyncRequestHandler;

import org.apache.http.Header;
import org.apache.http.HeaderElement;
import org.apache.http.HttpEntity;
import org.apache.http.HttpRequest;
import org.apache.http.HttpRequestInterceptor;
import org.apache.http.HttpResponse;
import org.apache.http.HttpResponseInterceptor;
import org.apache.http.HttpVersion;
import org.apache.http.client.CookieStore;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpDelete;
import org.apache.http.client.methods.HttpEntityEnclosingRequestBase;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.client.methods.HttpUriRequest;
import org.apache.http.client.protocol.ClientContext;
import org.apache.http.conn.params.ConnManagerParams;
import org.apache.http.conn.params.ConnPerRouteBean;
import org.apache.http.conn.scheme.PlainSocketFactory;
import org.apache.http.conn.scheme.Scheme;
import org.apache.http.conn.scheme.SchemeRegistry;
import org.apache.http.conn.ssl.SSLSocketFactory;
import org.apache.http.entity.HttpEntityWrapper;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.impl.conn.tsccm.ThreadSafeClientConnManager;
import org.apache.http.params.BasicHttpParams;
import org.apache.http.params.HttpParams;
import org.apache.http.params.HttpConnectionParams;
import org.apache.http.params.HttpProtocolParams;
import org.apache.http.protocol.BasicHttpContext;
import org.apache.http.protocol.HttpContext;
import org.apache.http.protocol.SyncBasicHttpContext;

public class FinalHttp {

 private static final int DEFAULT_SOCKET_BUFFER_SIZE = 8 * 1024; //8KB
 private static final String HEADER_ACCEPT_ENCODING = "Accept-Encoding";
 private static final String ENCODING_GZIP = "gzip";

 private static int maxConnections = 10; //http请求最大并发连接数
 private static int socketTimeout = 10 * 1000; //超时时间，默认10秒
 private static int maxRetries = 5;//错误尝试次数，错误异常表请在RetryHandler添加
 private static int httpThreadCount = 3;//http线程池数量

 private final DefaultHttpClient httpClient;
 private final HttpContext httpContext;
 private String charset = "utf-8";

 private final Map<String, String> clientHeaderMap;
 //工厂模式
 private static final ThreadFactory  sThreadFactory = new ThreadFactory() {
  //保证现场安全，相当实用synchronized在++中保证线程安全 mCount=1
  private final AtomicInteger mCount = new AtomicInteger(1);
  public Thread newThread(Runnable r) {
   //getAndIncrement()以原子方式将当前值加 1。
   Thread tread = new Thread(r, "FinalHttp #" + mCount.getAndIncrement());
   //设置线程优先级比普通线程优先级低，目的还不了解
   tread.setPriority(Thread.NORM_PRIORITY - 1);
   return tread;
  }
 };
 //线程池放三条线程
 private static final Executor executor =Executors.newFixedThreadPool(httpThreadCount, sThreadFactory);

 public FinalHttp() {
  //这个类代表HTTP协议参数的集合。协议参数可能连接在一起形成一个层次结构。如果一个特定的参数值没有明确定义在集合本身,它的价值将来自父母的参数集合。
  BasicHttpParams httpParams = new BasicHttpParams();

  // ConnManagerParams这个类代表HTTP协议的集合参数适用于客户端连接管理器。
  //•'http.socket.timeout'：定义了套接字的毫秒级超时时间（SO_TIMEOUT），这就是等待数据，换句话说，在两个连续的数据包之间最大的闲置时间。如果超时时间是0就解释为是一个无限大的超时时间。这个参数期望得到一个java.lang.Integer类型的值。如果这个参数没有被设置，那么读取操作就不会超时（无限大的超时时间）。
  //       这定义了从ConnectionManager管理的连接池中取出连接的超时时间
  ConnManagerParams.setTimeout(httpParams, socketTimeout);
  //每个路由接口允许最大连接数。
  ConnManagerParams.setMaxConnectionsPerRoute(httpParams, new ConnPerRouteBean(maxConnections));
  // 设置允许的最大连接数。
  ConnManagerParams.setMaxTotalConnections(httpParams, 10);

  // 这定义了Socket读数据的超时时间，即从服务器获取响应数据需要等待的时间
  HttpConnectionParams.setSoTimeout(httpParams, socketTimeout);
  // 这定义了通过网络与服务器建立连接的超时时间。Httpclient包中通过一个异步线程去创建与服务器的socket连接，这就是该socket连接的超时时间
  HttpConnectionParams.setConnectionTimeout(httpParams, socketTimeout);
  // •'http.tcp.nodelay'：决定了是否使用Nagle算法。Nagle算法视图通过最小化发送的分组数量来节省带宽。当应用程序希望降低网络延迟并提高性能时，它们可以关闭Nagle算法（也就是开启TCP_NODELAY）。数据将会更早发送，增加了带宽消耗的成文。这个参数期望得到一个java.lang.Boolean类型的值。如果这个参数没有被设置，那么TCP_NODELAY就会开启（无延迟）。
  HttpConnectionParams.setTcpNoDelay(httpParams, true);
  HttpConnectionParams.setSocketBufferSize(httpParams, DEFAULT_SOCKET_BUFFER_SIZE);
  HttpProtocolParams.setVersion(httpParams, HttpVersion.HTTP_1_1);

  /* 设置我们的HttpClient支持HTTP和HTTPS两种模式 */
  //Scheme类代表了一个协议模式，比如“http”或“https”同时包含一些协议属性，比如默认端口，用来为给定协议创建java.net.Socket实例的套接字工厂。SchemeRegistry类用来维持一组Scheme，当去通过请求URI建立连接时，HttpClient可以从中选择：
  SchemeRegistry schemeRegistry = new SchemeRegistry();
  // PlainSocketFactory是创建和初始化普通的（不加密的）套接字的默认工厂。
  schemeRegistry.register(new Scheme("http", PlainSocketFactory.getSocketFactory(), 80));
  //HttpClient使用SSLSocketFactory来创建SSL连接。SSLSocketFactory允许高度定制
  schemeRegistry.register(new Scheme("https", SSLSocketFactory.getSocketFactory(), 443));
  //implements ClientConnectionManager 创建一个新的线程安全的连接管理器。
  ThreadSafeClientConnManager cm = new ThreadSafeClientConnManager(httpParams, schemeRegistry);

  httpContext = new SyncBasicHttpContext(new BasicHttpContext());
  httpClient = new DefaultHttpClient(cm, httpParams);
  httpClient.addRequestInterceptor(new HttpRequestInterceptor() {
   public void process(HttpRequest request, HttpContext context) {
    if (!request.containsHeader(HEADER_ACCEPT_ENCODING)) {
     request.addHeader(HEADER_ACCEPT_ENCODING, ENCODING_GZIP);
    }
    for (String header : clientHeaderMap.keySet()) {
     request.addHeader(header, clientHeaderMap.get(header));
    }
   }
  });

  httpClient.addResponseInterceptor(new HttpResponseInterceptor() {
   public void process(HttpResponse response, HttpContext context) {
    final HttpEntity entity = response.getEntity();
    if (entity == null) {
     return;
    }
    final Header encoding = entity.getContentEncoding();
    if (encoding != null) {
     for (HeaderElement element : encoding.getElements()) {
      if (element.getName().equalsIgnoreCase(ENCODING_GZIP)) {
       response.setEntity(new InflatingEntity(response.getEntity()));
       break;
      }
     }
    }
   }
  });
//重试
  httpClient.setHttpRequestRetryHandler(new RetryHandler(maxRetries));

  clientHeaderMap = new HashMap<String, String>();

 }

 public HttpClient getHttpClient() {
  return this.httpClient;
 }

 public HttpContext getHttpContext() {
  return this.httpContext;
 }

 public void configCharset(String charSet){
  if(charSet!=null && charSet.trim().length()!=0)
   this.charset = charSet;
 }

 public void configCookieStore(CookieStore cookieStore) {
  httpContext.setAttribute(ClientContext.COOKIE_STORE, cookieStore);
 }

 public void configUserAgent(String userAgent) {
  HttpProtocolParams.setUserAgent(this.httpClient.getParams(), userAgent);
 }

 /**
  * 设置网络连接超时时间，默认为10秒钟
  * @param timeout
  */
 public void configTimeout(int timeout){
  final HttpParams httpParams = this.httpClient.getParams();
  ConnManagerParams.setTimeout(httpParams, timeout);
  HttpConnectionParams.setSoTimeout(httpParams, timeout);
  HttpConnectionParams.setConnectionTimeout(httpParams, timeout);
 }

 /**
  * 设置https请求时  的 SSLSocketFactory
  * @param sslSocketFactory
  */
 public void configSSLSocketFactory(SSLSocketFactory sslSocketFactory) {
  Scheme scheme = new Scheme("https", sslSocketFactory, 443);
  this.httpClient.getConnectionManager().getSchemeRegistry().register(scheme);
 }

 /**
  * 配置错误重试次数
  * @param retry
  */
 public void configRequestExecutionRetryCount(int count){
  this.httpClient.setHttpRequestRetryHandler(new RetryHandler(count));
 }

 /**
  * 添加http请求头
  * @param header
  * @param value
  */
 public void addHeader(String header, String value) {
  clientHeaderMap.put(header, value);
 }

 //------------------get 请求-----------------------
 public void get( String url, AjaxCallBack<? extends Object> callBack) {
  get( url, null, callBack);
 }

 public void get( String url, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
  sendRequest(httpClient, httpContext, new HttpGet(getUrlWithQueryString(url, params)), null, callBack);
 }

 public void get( String url, Header[] headers, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
  HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
  if(headers != null) request.setHeaders(headers);
  sendRequest(httpClient, httpContext, request, null, callBack);
 }

 public Object getSync( String url) {
  return getSync( url, null);
 }

 public Object getSync( String url, AjaxParams params) {
  HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
  return sendSyncRequest(httpClient, httpContext, request, null);
 }

 public Object getSync( String url, Header[] headers, AjaxParams params) {
  HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
  if(headers != null) request.setHeaders(headers);
  return sendSyncRequest(httpClient, httpContext, request, null);
 }

 //------------------post 请求-----------------------
 public void post(String url, AjaxCallBack<? extends Object> callBack) {
  post(url, null, callBack);
 }

 public void post(String url, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
  post(url, paramsToEntity(params), null, callBack);
 }

 public void post( String url, HttpEntity entity, String contentType, AjaxCallBack<? extends Object> callBack) {
  sendRequest(httpClient, httpContext, addEntityToRequestBase(new HttpPost(url), entity), contentType, callBack);
 }

 public <T> void post( String url, Header[] headers, AjaxParams params, String contentType,AjaxCallBack<T> callBack) {
  HttpEntityEnclosingRequestBase request = new HttpPost(url);
  if(params != null) request.setEntity(paramsToEntity(params));
  if(headers != null) request.setHeaders(headers);
  sendRequest(httpClient, httpContext, request, contentType, callBack);
 }

 public void post( String url, Header[] headers, HttpEntity entity, String contentType,AjaxCallBack<? extends Object> callBack) {
  HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPost(url), entity);
  if(headers != null) request.setHeaders(headers);
  sendRequest(httpClient, httpContext, request, contentType, callBack);
 }

 public Object postSync(String url) {
  return postSync(url, null);
 }

 public Object postSync(String url, AjaxParams params) {
  return postSync(url, paramsToEntity(params), null);
 }

 public Object postSync( String url, HttpEntity entity, String contentType) {
  return sendSyncRequest(httpClient, httpContext, addEntityToRequestBase(new HttpPost(url), entity), contentType);
 }

 public Object postSync( String url, Header[] headers, AjaxParams params, String contentType) {
  HttpEntityEnclosingRequestBase request = new HttpPost(url);
  if(params != null) request.setEntity(paramsToEntity(params));
  if(headers != null) request.setHeaders(headers);
  return sendSyncRequest(httpClient, httpContext, request, contentType);
 }

 public Object postSync( String url, Header[] headers, HttpEntity entity, String contentType) {
  HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPost(url), entity);
  if(headers != null) request.setHeaders(headers);
  return sendSyncRequest(httpClient, httpContext, request, contentType);
 }

 //------------------put 请求-----------------------

 public void put(String url, AjaxCallBack<? extends Object> callBack) {
  put(url, null, callBack);
 }

 public void put( String url, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
  put(url, paramsToEntity(params), null, callBack);
 }

 public void put( String url, HttpEntity entity, String contentType, AjaxCallBack<? extends Object> callBack) {
  sendRequest(httpClient, httpContext, addEntityToRequestBase(new HttpPut(url), entity), contentType, callBack);
 }

 public void put(String url,Header[] headers, HttpEntity entity, String contentType, AjaxCallBack<? extends Object> callBack) {
  HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPut(url), entity);
  if(headers != null) request.setHeaders(headers);
  sendRequest(httpClient, httpContext, request, contentType, callBack);
 }

 public Object putSync(String url) {
  return putSync(url, null);
 }

 public Object putSync( String url, AjaxParams params) {
  return putSync(url, paramsToEntity(params),null);
 }

 public Object putSync(String url, HttpEntity entity, String contentType) {
  return putSync(url,null, entity, contentType);
 }

 public Object putSync(String url,Header[] headers, HttpEntity entity, String contentType) {
  HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPut(url), entity);
  if(headers != null) request.setHeaders(headers);
  return sendSyncRequest(httpClient, httpContext, request, contentType);
 }

 //------------------delete 请求-----------------------
 public void delete( String url, AjaxCallBack<? extends Object> callBack) {
  final HttpDelete delete = new HttpDelete(url);
  sendRequest(httpClient, httpContext, delete, null, callBack);
 }

 public void delete( String url, Header[] headers, AjaxCallBack<? extends Object> callBack) {
  final HttpDelete delete = new HttpDelete(url);
  if(headers != null) delete.setHeaders(headers);
  sendRequest(httpClient, httpContext, delete, null, callBack);
 }

 public Object deleteSync(String url) {
  return deleteSync(url,null);
 }

 public Object deleteSync( String url, Header[] headers) {
  final HttpDelete delete = new HttpDelete(url);
  if(headers != null) delete.setHeaders(headers);
  return sendSyncRequest(httpClient, httpContext, delete, null);
 }

 //---------------------下载---------------------------------------
 public HttpHandler<File> download(String url,String target,AjaxCallBack<File> callback){
  return download(url, null, target, false, callback);
 }

 public HttpHandler<File> download(String url,String target,boolean isResume,AjaxCallBack<File> callback){
  return download(url, null, target, isResume, callback);
 }

 public HttpHandler<File> download( String url,AjaxParams params, String target, AjaxCallBack<File> callback) {
  return download(url, params, target, false, callback);
 }

 public HttpHandler<File> download( String url,AjaxParams params, String target,boolean isResume, AjaxCallBack<File> callback) {
  final HttpGet get =  new HttpGet(getUrlWithQueryString(url, params));
  HttpHandler<File> handler = new HttpHandler<File>(httpClient, httpContext, callback,charset);
  handler.executeOnExecutor(executor,get,target,isResume);
  return handler;
 }

 protected <T> void sendRequest(DefaultHttpClient client, HttpContext httpContext, HttpUriRequest uriRequest, String contentType, AjaxCallBack<T> ajaxCallBack) {
  if(contentType != null) {
   uriRequest.addHeader("Content-Type", contentType);
  }

  new HttpHandler<T>(client, httpContext, ajaxCallBack,charset)
  .executeOnExecutor(executor, uriRequest);

 }

 protected Object sendSyncRequest(DefaultHttpClient client, HttpContext httpContext, HttpUriRequest uriRequest, String contentType) {
  if(contentType != null) {
   uriRequest.addHeader("Content-Type", contentType);
  }
  return new SyncRequestHandler(client, httpContext,charset).sendRequest(uriRequest);
 }

 public static String getUrlWithQueryString(String url, AjaxParams params) {
  if(params != null) {
   String paramString = params.getParamString();
   url += "?" + paramString;
  }
  return url;
 }

 private HttpEntity paramsToEntity(AjaxParams params) {
  HttpEntity entity = null;

  if(params != null) {
   entity = params.getEntity();
  }

  return entity;
 }

 private HttpEntityEnclosingRequestBase addEntityToRequestBase(HttpEntityEnclosingRequestBase requestBase, HttpEntity entity) {
  if(entity != null){
   requestBase.setEntity(entity);
  }

  return requestBase;
 }

 private static class InflatingEntity extends HttpEntityWrapper {
  public InflatingEntity(HttpEntity wrapped) {
   super(wrapped);
  }

  @Override
  public InputStream getContent() throws IOException {
   return new GZIPInputStream(wrappedEntity.getContent());
  }

  @Override
  public long getContentLength() {
   return -1;
  }
 }
}