OkGo一个好用的网络加载框架

OkGo使用分享

 

       OkGo这个框架可能很多人听过,但是okHttp开发安卓的人士一定听过,可能还在使用。现在最火的两个框架一个是OkHttp另一个是Retrofit,Retrofit用过一次感觉不太好,主要是我同学没有封装好用起来一点都不顺,所以对Retrofit就没啥好感了。

闲话不多说我们进入正题

OkGo使用步骤:

          一、导包

 github项目:https://github.com/jeasonlzy/okhttp-OkGo

 

 Android Studio用户

 一般来说,只需要添加第一个okgo的核心包即可,其余的三个库根据自己的需要选择添加!!!

//必须使用
compile 'com.lzy.net:okgo:3.0.4'

//以下三个选择添加,okrx和okrx2不能同时使用
compile 'com.lzy.net:okrx:1.0.2'
compile 'com.lzy.net:okrx2:2.0.2'  
compile 'com.lzy.net:okserver:2.0.5'

 Eclipse的用户(赶紧换AS吧),可以选择添加本项目根目录中 /jar 目录下的jar包:

 一般来说,至少需要okhttp、okio、okgo三个jar包,其余的三个扩展jar包根据自己的需要选择添加!!!

 必须使用

 okhttp-3.8.1.jar
 okio-1.13.0.jar
 okgo-3.0.4.jar

 以下三个选择添加,okrx和okrx2不能同时使用

 okrx-1.0.2.jar
 okrx2-2.0.2.jar
 okserver-2.0.5.jar

 

          二、初始化

 

         在自己的Application的onCreate方法里面初始化(上面的设置自己想要啥设置啥)

 

public class GApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        initOkGo();
    }

    private void initOkGo() {
        //---------这里给出的是示例代码,告诉你可以这么传,实际使用的时候,根据需要传,不需要就不传-------------//
        HttpHeaders headers = new HttpHeaders();
        headers.put("commonHeaderKey1", "commonHeaderValue1");    //header不支持中文,不允许有特殊字符
        headers.put("commonHeaderKey2", "commonHeaderValue2");
        HttpParams params = new HttpParams();
        params.put("commonParamsKey1", "commonParamsValue1");     //param支持中文,直接传,不要自己编码
        params.put("commonParamsKey2", "这里支持中文参数");
        //----------------------------------------------------------------------------------------//

        OkHttpClient.Builder builder = new OkHttpClient.Builder();
        //log相关
        HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor("OkGo");
        loggingInterceptor.setPrintLevel(HttpLoggingInterceptor.Level.BODY);        //log打印级别,决定了log显示的详细程度
        loggingInterceptor.setColorLevel(Level.INFO);                               //log颜色级别,决定了log在控制台显示的颜色
        builder.addInterceptor(loggingInterceptor);                                 //添加OkGo默认debug日志
        //第三方的开源库,使用通知显示当前请求的log,不过在做文件下载的时候,这个库好像有问题,对文件判断不准确
        //builder.addInterceptor(new ChuckInterceptor(this));

        //超时时间设置,默认60秒
        builder.readTimeout(OkGo.DEFAULT_MILLISECONDS, TimeUnit.MILLISECONDS);      //全局的读取超时时间
        builder.writeTimeout(OkGo.DEFAULT_MILLISECONDS, TimeUnit.MILLISECONDS);     //全局的写入超时时间
        builder.connectTimeout(OkGo.DEFAULT_MILLISECONDS, TimeUnit.MILLISECONDS);   //全局的连接超时时间

        //自动管理cookie(或者叫session的保持),以下几种任选其一就行
        //builder.cookieJar(new CookieJarImpl(new SPCookieStore(this)));            //使用sp保持cookie,如果cookie不过期,则一直有效
        builder.cookieJar(new CookieJarImpl(new DBCookieStore(this)));              //使用数据库保持cookie,如果cookie不过期,则一直有效
        //builder.cookieJar(new CookieJarImpl(new MemoryCookieStore()));            //使用内存保持cookie,app退出后,cookie消失

        //https相关设置,以下几种方案根据需要自己设置
        //方法一:信任所有证书,不安全有风险
        HttpsUtils.SSLParams sslParams1 = HttpsUtils.getSslSocketFactory();
        //方法二:自定义信任规则,校验服务端证书
        HttpsUtils.SSLParams sslParams2 = HttpsUtils.getSslSocketFactory(new SafeTrustManager());
        //方法三:使用预埋证书,校验服务端证书(自签名证书)
        //HttpsUtils.SSLParams sslParams3 = HttpsUtils.getSslSocketFactory(getAssets().open("srca.cer"));
        //方法四:使用bks证书和密码管理客户端证书(双向认证),使用预埋证书,校验服务端证书(自签名证书)
        //HttpsUtils.SSLParams sslParams4 = HttpsUtils.getSslSocketFactory(getAssets().open("xxx.bks"), "123456", getAssets().open("yyy.cer"));
        builder.sslSocketFactory(sslParams1.sSLSocketFactory, sslParams1.trustManager);
        //配置https的域名匹配规则,详细看demo的初始化介绍,不需要就不要加入,使用不当会导致https握手失败
        builder.hostnameVerifier(new SafeHostnameVerifier());

        // 其他统一的配置
        // 详细说明看GitHub文档:https://github.com/jeasonlzy/
        OkGo.getInstance().init(this)                           //必须调用初始化
                .setOkHttpClient(builder.build())               //建议设置OkHttpClient,不设置会使用默认的
                .setCacheMode(CacheMode.NO_CACHE)               //全局统一缓存模式,默认不使用缓存,可以不传
                .setCacheTime(CacheEntity.CACHE_NEVER_EXPIRE)   //全局统一缓存时间,默认永不过期,可以不传
                .setRetryCount(3)                               //全局统一超时重连次数,默认为三次,那么最差的情况会请求4次(一次原始请求,三次重连请求),不需要可以设置为0
                .addCommonHeaders(headers)                      //全局公共头
                .addCommonParams(params);                       //全局公共参数
    }

    /**
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 重要的事情说三遍,以下代码不要直接使用
     */
    private class SafeTrustManager implements X509TrustManager {
        @Override
        public void checkClientTrusted(X509Certificate[] chain, String authType) throws CertificateException {
        }

        @Override
        public void checkServerTrusted(X509Certificate[] chain, String authType) throws CertificateException {
            try {
                for (X509Certificate certificate : chain) {
                    certificate.checkValidity(); //检查证书是否过期,签名是否通过等
                }
            } catch (Exception e) {
                throw new CertificateException(e);
            }
        }

        @Override
        public X509Certificate[] getAcceptedIssuers() {
            return new X509Certificate[0];
        }
    }

    /**
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 这里只是我谁便写的认证规则,具体每个业务是否需要验证,以及验证规则是什么,请与服务端或者leader确定
     * 重要的事情说三遍,以下代码不要直接使用
     */
    private class SafeHostnameVerifier implements HostnameVerifier {
        @Override
        public boolean verify(String hostname, SSLSession session) {
            //验证主机名是否匹配
            //return hostname.equals("server.jeasonlzy.com");
            return true;
        }
    }
}

三、请求网络数据 (这里要注意了params()这个方法可以传递map集合   如果你使用这样穿第参数的话会接收不到返回结果  你可以用HttpParams()对象包一层就好了)

 

      Get方式:    

 

OkGo.<String>get(Urls.URL_METHOD)//
        .tag(this)//
        .headers("header1", "headerValue1")//
        .params("param1", "paramValue1")//
        .execute(new StringCallback() {
            @Override
            public void onSuccess(Response<String> response) {
                //注意这里已经是在主线程了
                String data = response.body();//这个就是返回来的结果
            }

            @Override
            public void onError(Response<String> response) {
                super.onError(response);
            }
        });

 

 post方式:(这里要注意了params()这个方法可以传递map集合   如果你使用这样穿第参数的话会接收不到返回结果  你可以用HttpParams()对象包一层就好了)

 

OkGo.<String>post("http://gprs.syxzlg.com/Device/getdeviceList.html")//
        .tag(this)//
        .headers("header1", "headerValue1")//
        .params("uid", "paramValue1")//
        .isMultipart(true)         //强制使用 multipart/form-data 表单上传(只是演示,不需要的话不要设置。默认就是false)
        .execute(new StringCallback() {
            @Override
            public void onSuccess(Response<String> response) {
                //注意这里已经是在主线程了
                String data = response.body();//这个就是返回来的结果
            }

            @Override
            public void onError(Response<String> response) {
                super.onError(response);
            }
        });

 

 注意:上面有一setTag()方法看起来没啥用 其实他是用来取消网络请求用的 ,传递的参数就是这次网络的标识。那如何中

断此次请求呢
OkGo.cancelTag(OkGo.getInstance().getOkHttpClient(),tag);

 四、文件上传(这里要注意了params()这个方法可以传递map集合   如果你使用这样穿第参数的话会接收不到返回结果  你可以用HttpParams()对象包一层就好了)

 

        //拼接参数
        OkGo.<String>post("http://gprs.syxzlg.com/User/uploadImage")//
                .tag(this)//
                .headers("header1", "headerValue1")//
                .headers("header2", "headerValue2")//
                .params("param1", "paramValue1")//
                .params("param2", "paramValue2")//
//                .params("file1",new File("文件路径"))   //这种方式为一个key,对应一个文件
//                .params("file2",new File("文件路径"))
//                .params("file3",new File("文件路径"))
                .addFileParams("filename", files)           // 这种方式为同一个key,上传多个文件
                .execute(new JsonCallback<String>() {
                    @Override
                    public void onStart(Request<String, ? extends Request> request) {
                        btnFormUpload.setText("正在上传中...");
                    }

                    @Override
                    public void onSuccess(Response<String> response) {
                        btnFormUpload.setText("上传完成"+response.body());
                    }

                    @Override
                    public void onError(Response<String> response) {
                        btnFormUpload.setText("上传出错");
                    }

                    @Override
                    public void uploadProgress(Progress progress) {
                        System.out.println("uploadProgress: " + progress);
                    }
                });

 

 

 

五、文件下载(这里要注意了params()这个方法可以传递map集合   如果你使用这样穿第参数的话会接收不到返回结果  你可以用HttpParams()对象包一层就好了)

 

OkGo.<File>get(Urls.URL_DOWNLOAD)//
        .tag(this)//
        .headers("header1", "headerValue1")//
        .params("param1", "paramValue1")//
        .execute(new FileCallback("OkGo.apk") {

            @Override
            public void onStart(Request<File, ? extends Request> request) {
                btnFileDownload.setText("正在下载中");
            }

            @Override
            public void onSuccess(Response<File> response) {
                btnFileDownload.setText("下载完成"+response.body());
            }

            @Override
            public void onError(Response<File> response) {
                btnFileDownload.setText("下载出错");
            }

            @Override
            public void downloadProgress(Progress progress) {
                System.out.println(progress);
            }
        });

 

基础开发的网络请求在上面都有了想要详细的请到这https://github.com/jeasonlzy/okhttp-OkGo

 

上面就是两只常用的网络请求他还有其他请求方式HEAD,OPTIONS,PUT,DELETE, PATCH, TRACE

 

后期补充

注意:这里要注意了params()这个方法可以传递map集合   如果你使用这样穿第参数的话会接收不到返回结果  你可以用HttpParams()对象包一层就好了

 

评论 7
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值