自己学习android也有一段时间了,在实际开发中,频繁的接触网络请求,而网络请求的方式很多,最常见的那么几个也就那么几个。本篇文章对常见的网络请求库进行一个总结。
HttpUrlConnection
最开始学android的时候用的网络请求是HttpUrlConnection,当时很多东西还不知道,但是在android 2.2及以下版本中HttpUrlConnection存在着一些bug,所以建议在android 2.3以后使用HttpUrlConnection,之前使用HttpClient。
在Android 2.2版本之前,HttpClient拥有较少的bug,因此使用它是最好的选择。而在Android 2.3版本及以后,HttpURLConnection则是最佳的选择。它的API简单,体积较小,因而非常适用于Android项目。压缩和缓存机制可 以有效地减少网络访问的流量,在提升速度和省电方面也起到了较大的作用。对于新的应用程序应该更加偏向于使用HttpURLConnection,因为在 以后的工作当中我们也会将更多的时间放在优化HttpURLConnection上面。
特点
- 比较轻便,灵活,易于扩展
- 在3.0后以及4.0中都进行了改善,如对HTTPS的支持
- 在4.0中,还增加了对缓存的支持
用法
- 首先我们需要获取到一个HttpURLConnection实例,一般需要new出一个URL对象,并传入目标网络地址,通过调用openConnection()方法获得HttpURLConnection实例。
- 得到该实例后。我们需要设置一下http请求的的方法,这里我们主要研究get和post,默认是使用get方法。get一般用于从服务器获取数据,post一般用于向服务器提交数据,设置请求方法使用函数setRequestMethod(“POST”)进行设置。
- 此外可以进行一些请求的限制,比如连接超时的时间等,可以通过setConnectTimeout设置超时时间。
- 获取服务器返回的输入流,使用getInputStream方法获取。
- 读取内容并处理
- 关闭连接,通过调用disconnect方法关闭当前的连接。
关键代码如下
使用过程中不要忘记添加权限
|
1
|
>
|
- GET
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
{
;
;
{
;
//获得URL对象
;
//获得HttpURLConnection对象
;
// 默认为GET
;
//不使用缓存
;
//设置超时时间
;
//设置读取超时时间
;
//设置是否从httpUrlConnection读入,默认情况下是true;
{
//相应码是否为200
;
//获得输入流
;
//包装字节流为字符流
;
;
{
;
}
;
}
{
;
{
{
;
;
}
{
{
;
;
{
;
}
}
}
;
}
|
- POST
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
{
{
;
}
;
;
;
;
;
{
;
//获得URL对象
;
//获得HttpURLConnection对象
;
// 设置请求方法为post
;
//不使用缓存
;
//设置超时时间
;
//设置读取超时时间
;
//设置是否从httpUrlConnection读入,默认情况下是true;
;
//设置为true后才能写入参数
;
;
;
;
//写入参数
{
//相应码是否为200
;
//获得输入流
;
//包装字节流为字符流
;
;
{
;
}
;
}
{
;
{
//关闭
{
{
;
{
;
}
}
{
{
;
{
;
}
}
{
;
;
}
}
;
}
{
;
;
{
;
;
;
;
{
;
}
}
;
}
|
以上代码参考了部分LessCode项目
HttpClient
特点
- 高效稳定,但是维护成本高昂,故android 开发团队不愿意在维护该库而是转投更为轻便的HttpUrlConnection
用法
- HttpClient是一个接口,因此无法直接创建它的实例,一般都是创建一个DefaultHttpClient实例
- 如果要发起Get请求,需要创建一个HttpGet对象,并传入请求地址
- 如果要发起Post请求,需要创建一个HttpPost对象。并传入请求地址,通过setEntity函数设置请求参数
- 调用execute方法,传入HttpGet或者HttpPost实例,执行后返回HttpResponse对象,判断响应状态码
- 解析响应结果,通过调用getEntity函数获得一个HttpEntity对象,之后可以通过EntityUtils.toString方法将其转换为字符串
由于在android2.3之后就被HttpUrlConnection取代了,这里也不过多介绍了,不过当初学习它的时候还没接触到其他库,就感觉它好方便,下面简单贴出使用方法
- GET
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
{
;
;
{
;
;
;
{
;
;
}
{
;
}
;
}
|
- POST
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
{
;
;
{
;
;
;
;
{
;
;
}
{
;
}
;
}
|
以上代码参考了郭霖《第一行代码》——HttpClient部分
Android Asynchronous Http Client
Android Asynchronous Http Client一看名字就知道它是基于Http Client的,但是呢在安卓中Http Client已经废弃了,所以也不建议使用这个库了。然后仍然有一些可取的内容值得学习,所以这里也介绍一下。
特点
- 所以请求在子线程中完成,请求回调在调用该请求的线程中完成
- 使用线程池
- 使用RequestParams类封装请求参数
- 支持文件上传
- 持久化cookie到SharedPreferences,个人感觉这一点也是这个库的重要特点,可以很方便的完成一些模拟登录
- 支持json
- 支持HTTP Basic Auth
用法
- 编写一个静态的HttpClient
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
;
;
;
;
/**
* Created by lizhangqu on 2015/5/7.
*/
{
;
;
{
;
}
{
;
}
{
;
}
}
|
- 调用get或者post方法
参数通过RequestParams传递,没有参数则传递null
|
1
2
|
;
;
|
- 如果要保存cookie,在发起请求之前调用以下代码
|
1
2
|
;
;
|
之后请求所得到的cookie都会自动持久化
如果要自己添加cookie,则调用以下代码
|
1
2
3
4
5
|
;
;
;
;
;
|
- 使用
在回调函数中处理返回结果
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
{
{
@Override
{
}
@Override
{
}
;
}
{
;
;
;
;
{
@Override
{
}
@Override
{
}
;
}
|
Volley
既然在android2.2之后不建议使用Http Client,那么有没有一个库是android2.2及以下版本使用Http Client,而android2.3及以上版本使用HttpUrlConnection的呢,答案是肯定的,就是Volley,它是android开发 团队在2013年Google I/O大会上推出了一个新的网络通信框架
Volley可以说是把AsyncHttpClient和Universal-Image-Loader的优点集于了一 身,既可以像AsyncHttpClient一样非常简单地进行HTTP通信,也可以像Universal-Image-Loader一样轻松加载网络上 的图片。除了简单易用之外,Volley在性能方面也进行了大幅度的调整,它的设计目标就是非常适合去进行数据量不大,但通信频繁的网络操作,而对于大数 据量的网络操作,比如说下载文件等,Volley的表现就会非常糟糕
特点
- Volley的优势在于处理小文件的http请求;
- 在Volley中也是可以使用Okhttp作为传输层
- Volley在处理高分辨率的图像压缩上有很好的支持;
- NetworkImageView在GC的使用模式上更加保守,在请求清理上也更加积极,networkimageview仅仅依赖于强大的内存引用,并当一个新请求是来自ImageView或ImageView离开屏幕时 会清理掉所有的请求数据。
用法
- 创建一个RequestQueue对象。
- 创建一个Request对象。
- 将Request对象添加到RequestQueue里面。
下面一步一步来学习其用法
- GET
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
{
;
;
{
@Override
{
;
}
{
@Override
{
}
;
;
}
|
- POST
通过指定请求方法为Request.Method.POST使其成为post请求,然后重新getParams方法设置请求参数。当发出POST请求的时 候,Volley会尝试调用StringRequest的父类——Request中的getParams()方法来获取POST参数
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
|
{
;
;
{
@Override
{
;
}
{
@Override
{
}
{
//重写getParams方法设置参数
@Override
{
;
;
;
;
;
}
;
;
}
|
- 加载图片
加载图像的方法和前面类似,只不过不在是StringRequest而是ImageRequest。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
{
;
;
//第三第四个参数分别用于指定允许图片最大的宽度和高度,如果指定的网络图片的宽度或高度大于这里的最大值,则会对图片进行压缩,指定成0的话就表示不管图片有多大,都不会进行压缩。
//第五个参数就是ImageView里中的属性ScaleType
//第六个参数用于指定图片的颜色属性
{
@Override
{
;
;
}
{
@Override
{
}
;
;
}
|
其实加载图片的功能还远远不止这些,使用ImageLoader可以实现对图片的缓存,还可以过滤重复链接,避免发送重复的请求
ImageLoader的使用方法概括为以下几步
1. 创建一个RequestQueue对象。
2. 创建一个ImageLoader对象。
3. 获取一个ImageListener对象。
4. 调用ImageLoader的get()方法加载网络上的图片。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
//继承ImageCache,使用LruCache实现缓存
{
;
{
;
{
@Override
{
;
}
;
}
@Override
{
;
}
@Override
{
;
}
}
{
;
;
;
;
// 第一个参数指定用于显示图片的ImageView控件
// 第二个参数指定加载图片的过程中显示的图片
// 第三个参数指定加载图片失败的情况下显示的图片
;
// 调用ImageLoader的get()方法来加载图片
// 第一个参数就是图片的URL地址
// 第二个参数则是刚刚获取到的ImageListener对象
// 如果想对图片的大小进行限制,也可以使用get()方法的重载,指定图片允许的最大宽度和高度,即通过第三第四个参数指定
;
}
|
最后,Volley提供了一种自定义ImageView来加载图片,其使用方法可概括为
1. 创建一个RequestQueue对象。
2. 创建一个ImageLoader对象。
3. 在布局文件中添加一个NetworkImageView控件。
4. 在代码中获取该控件的实例。
5. 设置要加载的图片地址。
我们在布局中申明该控件
|
1
2
3
4
5
6
|
NetworkImageView
>
|
在程序中实现加载
|
1
2
3
4
5
6
7
8
|
{
;
;
;
//设置加载中显示的图片
//设置加载失败时显示的图片
//设置目标图片的URL地址
}
|
- 自定义Request
在实际应用中,往往需要将http请求与json进行集成,而Volley正恰恰支持这样的方式,不过需要我们自己自定义Request,这里我们使用google的Gson库进行集成。
1. 继承Request类
2. 重写parseNetworkResponse,实现json与实体类转换,由于实体类未定,所以采用泛型
下文用到的json字符串如下
|
1
|
}
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
;
;
;
;
;
;
;
;
/**
* Created by lizhangqu on 2015/5/7.
*/
{
;
;
;
,
{
;
;
;
;
}
,
{
;
}
@Override
{
{
,
;
,
;
{
;
}
}
@Override
{
;
}
}
|
编写测试实体类,两个字段一个name一个age
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
;
/**
* Created by lizhangqu on 2015/5/7.
*/
{
;
;
{
;
}
{
;
}
{
;
}
{
;
}
@Override
{
+
+
+
;
}
}
|
调用方法和StringRequest是一样的。如下所示
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
{
;
;
{
@Override
{
;
}
{
@Override
{
}
;
;
}
|
以上代码参考了郭霖三篇Volley博客文章,分别为
Android Volley完全解析(一),初识Volley的基本用法
Android Volley完全解析(二),使用Volley加载网络图片
Android Volley完全解析(三),定制自己的Request
okHttp
okhttp 是一个 Java 的 HTTP+SPDY 客户端开发包,同时也支持 Android。需要Android 2.3以上。
特点
- OKHttp是Android版Http客户端。非常高效,支持SPDY、连接池、GZIP和 HTTP 缓存。
- 默认情况下,OKHttp会自动处理常见的网络问题,像二次连接、SSL的握手问题。
- 如果你的应用程序中集成了OKHttp,Retrofit默认会使用OKHttp处理其他网络层请求。
- 从Android4.4开始HttpURLConnection的底层实现采用的是okHttp.
用法
- 新建一个OkHttpClient对象
- 通过Request.Builder对象新建一个Request对象
- 返回执行结果
- GET
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
{
;
)
)
;
;
{
;
;
{
;
}
;
}
|
- POST
POST需要使用RequestBody对象,之后再构建Request对象时调用post函数将其传入即可
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
{
;
)
)
)
)
;
)
)
)
;
;
{
;
;
{
;
}
;
}
|
此外,post的使用方法还支持文件等操作,具体使用方法有兴趣的可以自行查阅
- 对Gson的支持
okHttp还自带了对Gson的支持
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
{
;
;
)
)
;
;
{
;
;
;
{
;
}
;
}
|
- 异步操作
以上的两个例子必须在子线程中完成,同时okHttp还提供了异步的方法调用,通过使用回调来进行异步调用,然后okHttp的回调依然不在主线程中,因此该回调中不能操作UI
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
{
;
)
)
;
;
{
@Override
{
}
@Override
{
;
;
//不能操作ui,回调依然在子线程
;
}
;
}
|
okHttp的使用还有很多内容,这里也不过多介绍,更多内容,参考官方网址
Retrofit
特点
- 性能最好,处理最快
- 使用REST API时非常方便;
- 传输层默认就使用OkHttp;
- 支持NIO;
- 拥有出色的API文档和社区支持
- 速度上比volley更快;
- 如果你的应用程序中集成了OKHttp,Retrofit默认会使用OKHttp处理其他网络层请求。
- 默认使用Gson
使用
Retrofit支持同步和异步两种方式,在使用时,需要将请求地址转换为接口,通过注解来指定请求方法,请求参数,请求头,返回值等信息。还是使 用之前的person的那段json值,get请求到服务器后从数据库查询数据,返回值为查询到的数据,post请求向服务器提交一条数据,返回值为提交 的数据。
首先完成请求所用的service,是一个interface,完全通过注解完成配置
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
;
;
;
;
;
;
;
;
;
/**
* Created by lizhangqu on 2015/5/11.
*/
{
{
,
)
//通过注解设置请求头
)
//设置请求方法为get,相对路径为注解内内容,其中{test}会被@Path注解指定内容替换
;
//@Query用于指定参数
@FormUrlEncoded
//urlencode
)
//post提交
;
//@Field提交的域
)
;
//异步回调,不能指定返回值
}
|
- GET
使用时,通过RestAdapter的实例获得一个接口的实例,其本质是动态代理,注意含有返回值的方法是同步的,不能UI线程中调用,应该在子线程中完成
|
1
2
3
4
5
6
|
)
)
;
;
;
;
|
- POST
POST的调用同Get,获得adapter后获得一个代理对象,然后通过这个代理对象进行网络请求
|
1
2
|
;
;
|
- 异步请求
如果要使用异步请求,需要将接口中的方法返回值修改会void,再加入回调参数Callback,就如PersonService中第三个方法一样,请求完成后会回调该callback对象的success或者fail方法。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
)
)
;
;
{
@Override
{
;
}
@Override
{
}
;
|
Retrofit的使用还有很多内容,剩下的就留给各位读者自行去发现了,而其官网页提供了及其详细的说明。下面提供官方网址
这个库里面有很多精华的内容,建议各位仔细的阅读下官方的文档。
RoboSpice
见之前写的一篇博文
总结
网络请求库多种多样,最终其本质思想是一致的,要学会融汇贯通,还是要fucking the source code。由于本篇文章已经过长,所以图片的网络加载准备另开一篇博客进行整理。