Android 开源框架 ( 一 ) OkHttp 网络框架的基本使用
HttpClient 和 HttpURLConnection 以及 OkHttp :
在Android 2.2版本之前,HttpClient拥有较少的bug,因此使用它是最好的选择。
而在Android2.3版本及以后,HttpURLConnection则是最佳的选择。它的API简单,体积较小,因而非常适用于Android项目。压缩和缓存机制可以有效地减少网络访问的流量,在提升速度和省电方面也起到了较大的作用。对于新的应用程序应该更加偏向于使用HttpURLConnection,因为在以后的工作当中我们也会将更多的时间放在优化HttpURLConnection上面。
其实现在嘛,两者都不用,就用Okhttp. HttpUrlConnection现在的底层实现就是通过Okhttp.
一. HttpUrlConnect 介绍
1. 网络通信首先需要配置网络请求权限:
- <uses-permission android:name="android.permission.INTERNET" />
2.使用如下方式实现子线程里http请求通信:
开启线程两种常用的实现方式:一种是继承Thread类.一种是实现Runnable接口.
- new Thread(new Runnable() {
- @Override
- public void run() {
- ...
- //子线程方法异步执行
- ...
- }
- }).start();
如果在主线程(也就是我们常说的UI线程)中进行Http请求,会报如下错.(NetworkOnMainThreadException)
- java.lang.RuntimeException: Unable to start activity ComponentInfo{com.android.okhttp.okhttp/com.android.okhttp.okhttp.MainActivity}: android.os.NetworkOnMainThreadException
- at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2855)
3.使用HttpUrlConnect实现异步http get请求获取网络数据示例:
- // 1. 得到访问地址的URL
- URL url = new URL(urlStr);
- // 2. 得到网络访问对象java.net.HttpURLConnection
- HttpURLConnection connection = (HttpURLConnection) url.openConnection();
- /* 3. 设置请求参数(过期时间,输入、输出流、访问方式),以流的形式进行连接 */
- // 设置是否向HttpURLConnection输出
- connection.setDoOutput(false);
- // 设置是否从httpUrlConnection读入
- connection.setDoInput(true);
- // 设置请求方式
- connection.setRequestMethod("GET");
- // 设置是否使用缓存
- connection.setUseCaches(true);
- // 设置此 HttpURLConnection 实例是否应该自动执行 HTTP 重定向
- connection.setInstanceFollowRedirects(true);
- // 设置超时时间
- connection.setConnectTimeout(3000);
- // 连接
- connection.connect();
- // 4. 得到响应状态码的返回值 responseCode
- int code = connection.getResponseCode();
- // 5. 如果返回值正常,数据在网络中是以流的形式得到服务端返回的数据
- String msg = "";
- if (code == 200) { // 正常响应
- // 从流中读取响应信息
- BufferedReader reader = new BufferedReader(
- new InputStreamReader(connection.getInputStream()));
- String line = null;
- // 循环从流中读取
- while ((line = reader.readLine()) != null) {
- msg += line + "\n";
- }
- reader.close(); // 关闭流
- }
- // 6. 断开连接,释放资源
- connection.disconnect();
- // 显示响应结果
- Log.i("getDataByHttpUrlConnect",msg);
- //组装消息
- Message message = new Message();
- message.what = RESPONSE_OK;
- message.obj = msg;
- //发送消息
- handler.sendMessage(message);
4.在子线程进行网络请求后,将返回的信息在主线程控件上刷新显示. 使用到Handler操作.
- //定义一个Handler来接收子线程发送的消息并处理:
- Handler handler = new Handler(new Handler.Callback() {
- @Override
- public boolean handleMessage(Message message) {
- switch (message.what){
- case RESPONSE_OK:
- //将返回的消息打印在界面TextView控件上显示
- tv_response.setText(message.obj.toString());
- break;
- }
- return true;
- }
- });
二. OkHttp 介绍
Requests 和 Responses 两个属性概念解释:
Requests(请求) 每一个HTTP请求中都应该包含一个URL,一个GET或POST方法以及Header或其他参数,当然还可以含特定内容类型的数据流。
注意下Content-Type:
RequestBody的数据格式都要指定Content-Type,常见的有三种:
application/x-www-form-urlencoded 数据是个普通表单
multipart/form-data 数据里有文件
application/json 数据是个json
Responses(响应) 响应则包含一个回复代码(200代表成功,404代表未找到等灯),Header和定制可选的body。
1.项目中配置使用OkHttp
首先gradle 引入类库(AndroidStudio显示最新的是3.11.0版本-2018年7月28日):
- implementation \'com.squareup.okhttp3:okhttp:3.11.0\'
或者下载jar包:
OkHttp官网地址:http://square.github.io/okhttp/
OkHttp GitHub地址:https://github.com/square/okhttp
2. OkHttp get请求示例:
- //new OkHttpClient
- OkHttpClient okHttpClient = new OkHttpClient();
- //封装Request请求信息,get方式,请求url
- Request request = new Request.Builder().get().url(urlStr).build();
- //定义一个接受返回信息的Response
- Response response = null;
- try {
- //调用OkHttp内部真正的实现请求,并返回请求结果Response
- response = okHttpClient.newCall(request).execute();
- if(response.isSuccessful()){
- //请求回来不能再子线程里进行界面Ui更新操作,通过Handler来通知主线程界面刷新
- Message message = new Message();
- message.what = RESPONSE_OK;
- message.obj = response.body().toString();
- handler.sendMessage(message);
- }
- } catch (IOException e) {
- e.printStackTrace();
- }