在之前的一篇文章中,我们简单的介绍了下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<String>() {
//当我们请求失败的时候会被调用,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<? 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);
}
第二种方式增加了AjaxParams参数,这个参数负责设置get请求的请求值,就是get请求时url地址后面的 &key1=values1 &key2=values2这种形式的请求参数的设置,内部其实就是通过Map<String,String>实现的,所以使用也和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<? 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);
}
从上面的代码中,我们可以看出,post与get方法的使用几乎相同,只不过增加了几个新的参数而已。
下面是调用post方法的一个简单的示例
public void post(View view) {
http.post("http://www.baidu.com", new AjaxCallBack<String>() {
@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", "test@tsz.net");
params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件
params.put("profile_picture2", inputStream); // 上传数据流
params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流