OkHttpClient使用和封装

OkHttpClient使用和封装

最近的项目用到了底部弹窗的效果,网上百度了很多类似写好的控件,其中也不乏好的实现。但是为了方便以后扩展,总结了一下前人的经验自己写了实现了一个类:


文章目录

  • OkHttpClient使用和封装
    • 环境配置
    • 同步GET请求
    • 异步GET请求
    • 异步POST请求
    • OkHttpUtil工具类封装 让网络请求更轻松


环境配置

目前安卓开发者普遍使用AS开发,所以这里只介绍引入依赖的配置方式,同时引入Gson作为后面数据解析的工具。

implementation 'com.squareup.okhttp3:okhttp:3.2.0'
implementation 'com.google.code.gson:gson:2.3.1'

引入库以后,需要在AndroidManifest文件中获取网络访问权限

 <uses-permission android:name="android.permission.INTERNET" />

同步GET请求

//同步GET方法,execute()方法会抛出IOException异常
    private void syncNetAccess() throws IOException {

        //创建OkHttpClient实例,主要用于请求网络
        OkHttpClient okHttpClient = new OkHttpClient();

        //创建Request实例,可以配置接口地址和请求头
        Request okRequest = new Request.Builder().url("http://toutiao-ali.juheapi.com/toutiao/index?type=caijing").build();

        //GET请求,用Response接受相应结果
        Response response = okHttpClient.newCall(okRequest).execute();

        //response.body()为请求返回数据 JSON格式
        Log.d("+++++++++++++++++++++",response.body().string();
    }

这里值得注意的一点,response.body()这个方法很奇怪只能获取一次,再调用只能得到null,所以有打印结果习惯的不要入坑。

另外一个坑就是线程的问题,现在的系统版本不支持在主线程,这样请求的话会报错:NetworkOnMainThreadException。

解决的办法有两种:一是添加StrictMode约束。

StrictMode.ThreadPolicy policy = new StrictMode.ThreadPolicy.Builder().permitAll().build();
StrictMode.setThreadPolicy(policy);

另外一种就是创建一个新的线程Thread,因为代码比较多,为了不干扰本文的主题在这里就不详说了。

那么,既然同步请求这么坑爹,为什么不直接使用异步请求呢?

异步GET请求

 //异步GET方法
    private void asyncNetAccess() throws IOException {

        //创建OkHttpClient实例,主要用于请求网络
        OkHttpClient okHttpClient = new OkHttpClient();

        //创建Request实例,这里配置了请求头 addHeader()
        Request okRequest = new Request.Builder().url("http://toutiao-ali.juheapi.com/toutiao/index?type=caijing").addHeader("name","value").build();

        //GET请求,回调函数中获取相应结果
       okHttpClient.newCall(okRequest).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                Log.d("+++++++++++++++++++++",e.getMessage());
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                Log.d("+++++++++++++++++++++",response.body().string());
            }
        });

    }

异步请求初始化的方式差不多,只是在最后请求网络的时候改为enqueue()方法,并且创建了一个Callback来异步处理返回的结果,不在需要Response接收。其中,onFailure和onResponse分别是访问失败和成功的回调。

值得注意的,这里创建Request实例的时候加入了响应头Header,应用场景嘛比如一些公共的接口会需要身份验证,就需要添加响应头。这里是通过addHeader()方法添加key-value值,有点类似Map。

具体使用:
addHeader(“name”,“value”) 。当然响应头可以add多次,并且后面也会讲到批量添加的方法。

异步POST请求

POST请求也有异步和同步之分,发送请求的时候与GET请求是一样的,在这里不再介绍赘述。参照异步POST请求代码就知道同步代码是什么样的了。

 //异步POST方法
    private void asyncPostAccess() throws IOException {

        //创建OkHttpClient实例,主要用于请求网络
        OkHttpClient okHttpClient = new OkHttpClient();

        //创建表单请求体
        FormBody.Builder formBody = new FormBody.Builder();
        //传递键值对参数
        formBody.add("name","shuaige");

        //创建Request实例,设置POST参数
        Request okRequest = new Request.Builder().url("http://toutiao-ali.juheapi.com/toutiao/index?type=caijing").post(formBody.build()).build();

        //POST异步请求,回调函数中获取相应结果
        okHttpClient.newCall(okRequest).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                Log.d("+++++++++++++++++++++",e.getMessage());
            }
            @Override
            public void onResponse(Call call, Response response) throws IOException {
                Log.d("+++++++++++++++++++++",response.body().string());
            }
        });

    }

FormBody.Builder作为请求参数的创建,配置request时候调用post()方法传入请求参数的同时规定了请求方式,就是这么简单~

OkHttpUtil工具类封装 让网络请求更轻松

通过上面的例子我们不难发现,在每次请求网络之前都会创建一个实例:
OkHttpClient okHttpClient = new OkHttpClient();

并且每次网络访问都需要
okHttpClient.newCall() 来实现。

这显然不符合面向对象的的三要素的要求(更不符合懒蛋程序猿的要求)。作为当之无愧的程序猿,我义无反顾的对网络请求做了一个封装,方便以后其他项目上使用。

首先创建一个工具类:OkHttpUtil,这里为了节省一下内存我用了单例模式来封装,毕竟网络请求是APP的核心嘛,用的次数不要太多。

至于单例怎么写本着能省则省态度,以后找一章专门来记录。不多说,下面上代码。

package com.dzh.goldmarket.util;

import okhttp3.Callback;
import okhttp3.Headers;
import okhttp3.OkHttpClient;
import okhttp3.Request;

public class OkHttpUtil {

    private volatile static OkHttpUtil okHttpUtil = null;
    private static OkHttpClient okHttpClient = null;

    public static OkHttpUtil getInstance(){
        if(okHttpUtil == null){
            synchronized (OkHttpUtil.class){
                if(okHttpUtil == null){
                    okHttpUtil=new OkHttpUtil();
                    if(okHttpClient==null)
                        okHttpClient = new OkHttpClient();
                }
            }
        }
        return okHttpUtil;
    }

    public void doGet(String url, Headers headers, Callback callback){

        Request.Builder builder = new Request.Builder().url(url);
        //添加响应头集合
        if(headers!=null)
            builder.headers(headers);

        Request okRequest = builder.build();
        okHttpClient.newCall(okRequest).enqueue(callback);
    }

    public void doGet(String url, Callback callback){
        this.doGet(url,null,callback);
    }

}


这里doGet()实现了一个异步GET请求,其中Headers参数是响应头集合,Callback作为回调函数用法跟之前差不多,下面是具体的调用方法:

private void getNewsList() throws IOException, JSONException {
        String url="http://toutiao-ali.juheapi.com/toutiao/index?type=caijing";
        //name-value格式,可以多个header, 如("name1","value1","name2","value2")
        Headers headers =Headers.of("Authorization","APPCODE vjpawenapasj23sfln3");
        Request okRequest = new Request.Builder().url("http://toutiao-ali.juheapi.com/toutiao/index?type=caijing").addHeader("Authorization","APPCODE 545beb7b4c744411988486b946bca3cd").build();
        OkHttpUtil.getInstance().doGet(url,headers,new Callback(){

            @Override
            public void onFailure(Call call, IOException e) {
                Log.d("+++++++++++++++++++++",e.getMessage());
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                String bodyStr = response.body().string();
				//Gson解析返回结果
                newsEntities = new Gson().fromJson(bodyStr, NewsResultEntity.class);

                //多线程,需要在UI线程中更新APP界面
                getActivity().runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        newListView.setAdapter(new NewsAdapter(newsEntities.getResult().getData(),getActivity()));
                    }
                });
            }
        });

    }

需要注意一点:异步网络请求是多线程调用的,一般网络请求伴随的就是更新UI界面,所以需要调用runOnUiThread()方法在主线程中更新APP界面。

OK,使用方法和封装方法到此结束,开发中遇到的坑也一一列举。另外网络请求的一些配置,如超时、缓存等,以后有需要再慢慢补充。

(督促自己养成编写项目笔记的习惯,留作日后复习使用)

你可能感兴趣的:(Android,安卓,OKHTTPclient,封装,使用)