【Android开源框架】FinalHttp的简要介绍与使用

在之前的一篇文章中，我们简单的介绍了下FinalBitmap的使用，这一篇文章将继续介绍AFinal开发框架的使用，这一次的主角是FinalHttp。

FinalHttp，顾名思义，就是一个用于实现客户端与服务器之间网络通信的类，这个类主要通过对Apache的HttpClient开源项目进行封装，实现了http、https协议下的"GET"和"Post"两种请求方式，以及put、delete、download等功能，我们主要介绍使用FinalHttp实现与服务器的"GET"和"Post"两种交互方式。

private static final ThreadFactory  sThreadFactory = new ThreadFactory() {
        private final AtomicInteger mCount = new AtomicInteger(1);
        public Thread newThread(Runnable r) {
        	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);

首先，FinalHttp采用的是线程池的方式，提供对请求的异步加载，默认的是启动3个固定的线程。而且，

tread.setPriority(Thread.NORM_PRIORITY - 1);

这句代码将这些线程的优先级设置的比普通线程低，目前不知道是出于何种考虑。

另外，在FinalHttp的构造函数中，进行了很多属性的初始化操作，包括添加请求头、设置超时的时间、设置重试次数等，代码较多，还请读者自己去阅读。

FinalHttp对"GET"和"Post"进行了非常好的封装，所以使用起来非常简单，下面，我们简要的学习一下FinalHttp的使用。

首先，我们可以通过

FinalHttp http =new FinalHttp();

就可以很方便的获取到一个FinalHttp的对象。

如果我们想实现最简单的GET请求，比如我们用GET方式，请求百度的主页，我们可以这样做

public void get(View view) {
		//这是最简单的get请求，前面是请求地址，不要忘记添加http://
		//后面是一个回调函数，比较常用的方法有下面两个
		http.get("http://www.baidu.com", new AjaxCallBack() {

			//当我们请求失败的时候会被调用，errorNo是请求失败之后，服务器的错误码,StrMsg则是错误信息
			@Override
			public void onFailure(Throwable t, int errorNo, String strMsg) {
				super.onFailure(t, errorNo, strMsg);
				Log.d(TAG, strMsg);
			}

			//如果请求成功，则调用这个回调函数，t就是服务器返回的字符串信息
			@Override
			public void onSuccess(String t) {
				super.onSuccess(t);
				Log.d(TAG, t);
			}

		});
	}

我们可以看到，用FinalHttp实现GET网络请求，我们不需要自己开线程，因为框架已经封装好了，在内部给我们开的线程，实现网络的异步调用。其实不光有get方法，还有一个getSync，这个方法就是没有进行另起线程的请求，所以，如果我们想用getSync这个方法，我们需要自己开启线程，否则在最新版本的主线程中开启网络服务，会抛异常。

当然，这只是最简单的get方法的使用，FinalHttp一共提供了get方法的三种重载，代码如下

//------------------get 请求-----------------------
    public void get( String url, AjaxCallBack callBack) {
        get( url, null, callBack);
    }

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

第二种方式增加了AjaxParams参数，这个参数负责设置get请求的请求值，就是get请求时url地址后面的 &key1=values1 &key2=values2这种形式的请求参数的设置，内部其实就是通过Map实现的，所以使用也和Map一样。但是这个AjaxParams比较强大，我们可以往里面添加很多东西，比如说文件，流等。

第三种方式又增加了一个Header数组，这个数组用于设置请求的头信息，其他与以上两种相同。

 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);
    }

上面这是getSync的实现，其实和get方法一样，只不过因为需要自己另开线程，所以没有了回调函数这个参数，使用方法相同。

下面我们看一下post方法使用。

//------------------post 请求-----------------------
    public void post(String url, AjaxCallBack callBack) {
        post(url, null, callBack);
    }

    public void post(String url, AjaxParams params, AjaxCallBack callBack) {
        post(url, paramsToEntity(params), null, callBack);
    }

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

    public  void post( String url, Header[] headers, AjaxParams params, String contentType,AjaxCallBack 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 callBack) {
        HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPost(url), entity);
        if(headers != null) request.setHeaders(headers);
        sendRequest(httpClient, httpContext, request, contentType, callBack);
    }

从上面的代码中，我们可以看出，post与get方法的使用几乎相同，只不过增加了几个新的参数而已。

下面是调用post方法的一个简单的示例

public void post(View view) {
		http.post("http://www.baidu.com", new AjaxCallBack() {

			@Override
			public void onFailure(Throwable t, int errorNo, String strMsg) {
				super.onFailure(t, errorNo, strMsg);
				Log.d(TAG, strMsg);
			}

			@Override
			public void onSuccess(String t) {
				super.onSuccess(t);
				Log.d(TAG, t);
			}

		});

我们通过AjaxParams可以来添加文件，然后就可以使用post方法，将文件提交到服务器，实现文件的上传。

AjaxParams params = new AjaxParams();
  params.put("username", "michael yang");
  params.put("password", "123456");
  params.put("email", "[email protected]");
  params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件
  params.put("profile_picture2", inputStream); // 上传数据流
  params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流