com.lzy.okgo.model.HttpHeaders Java Examples

public Request(String url) {
    this.url = url;
    baseUrl = url;
    OkGo go = OkGo.getInstance();
    //默认添加 Accept-Language
    String acceptLanguage = HttpHeaders.getAcceptLanguage();
    if (!TextUtils.isEmpty(acceptLanguage)) headers(HttpHeaders.HEAD_KEY_ACCEPT_LANGUAGE, acceptLanguage);
    //默认添加 User-Agent
    String userAgent = HttpHeaders.getUserAgent();
    if (!TextUtils.isEmpty(userAgent)) headers(HttpHeaders.HEAD_KEY_USER_AGENT, userAgent);
    //添加公共请求参数
    if (go.getCommonParams() != null) params(go.getCommonParams());
    if (go.getCommonHeaders() != null) headers(go.getCommonHeaders());
    //添加缓存模式
    retryCount = go.getRetryCount();
    cacheMode = go.getCacheMode();
    cacheTime = go.getCacheTime();
}
 

/**
 * 解析文件头
 * Content-Disposition:attachment;filename=FileName.txt
 * Content-Disposition: attachment; filename*="UTF-8''%E6%9B%BF%E6%8D%A2%E5%AE%9E%E9%AA%8C%E6%8A%A5%E5%91%8A.pdf"
 */
private static String getHeaderFileName(Response response) {
    String dispositionHeader = response.header(HttpHeaders.HEAD_KEY_CONTENT_DISPOSITION);
    if (dispositionHeader != null) {
        //文件名可能包含双引号，需要去除
        dispositionHeader = dispositionHeader.replaceAll("\"", "");
        String split = "filename=";
        int indexOf = dispositionHeader.indexOf(split);
        if (indexOf != -1) {
            return dispositionHeader.substring(indexOf + split.length(), dispositionHeader.length());
        }
        split = "filename*=";
        indexOf = dispositionHeader.indexOf(split);
        if (indexOf != -1) {
            String fileName = dispositionHeader.substring(indexOf + split.length(), dispositionHeader.length());
            String encode = "UTF-8''";
            if (fileName.startsWith(encode)) {
                fileName = fileName.substring(encode.length(), fileName.length());
            }
            return fileName;
        }
    }
    return null;
}
 

/** 通用的拼接请求头 */
    public static Request.Builder appendHeaders(Request.Builder builder, HttpHeaders headers) {
        if (headers.headersMap.isEmpty()) return builder;
        Headers.Builder headerBuilder = new Headers.Builder();
        try {
            for (Map.Entry<String, String> entry : headers.headersMap.entrySet()) {
                //对头信息进行 utf-8 编码,防止头信息传中文,这里暂时不编码,可能出现未知问题,如有需要自行编码
//                String headerValue = URLEncoder.encode(entry.getValue(), "UTF-8");
                headerBuilder.add(entry.getKey(), entry.getValue());
            }
        } catch (Exception e) {
            OkLogger.printStackTrace(e);
        }
        builder.headers(headerBuilder.build());
        return builder;
    }
 

/** 通用的拼接请求头 */
    public static Request.Builder appendHeaders(Request.Builder builder, HttpHeaders headers) {
        if (headers.headersMap.isEmpty()) return builder;
        Headers.Builder headerBuilder = new Headers.Builder();
        try {
            for (Map.Entry<String, String> entry : headers.headersMap.entrySet()) {
                //对头信息进行 utf-8 编码,防止头信息传中文,这里暂时不编码,可能出现未知问题,如有需要自行编码
//                String headerValue = URLEncoder.encode(entry.getValue(), "UTF-8");
                headerBuilder.add(entry.getKey(), entry.getValue());
            }
        } catch (Exception e) {
            OkLogger.printStackTrace(e);
        }
        builder.headers(headerBuilder.build());
        return builder;
    }
 

public Request(String url) {
    this.url = url;
    baseUrl = url;
    OkGo go = OkGo.getInstance();
    //默认添加 Accept-Language
    String acceptLanguage = HttpHeaders.getAcceptLanguage();
    if (!TextUtils.isEmpty(acceptLanguage)) headers(HttpHeaders.HEAD_KEY_ACCEPT_LANGUAGE, acceptLanguage);
    //默认添加 User-Agent
    String userAgent = HttpHeaders.getUserAgent();
    if (!TextUtils.isEmpty(userAgent)) headers(HttpHeaders.HEAD_KEY_USER_AGENT, userAgent);
    //添加公共请求参数
    if (go.getCommonParams() != null) params(go.getCommonParams());
    if (go.getCommonHeaders() != null) headers(go.getCommonHeaders());
    //添加缓存模式
    retryCount = go.getRetryCount();
    cacheMode = go.getCacheMode();
    cacheTime = go.getCacheTime();
}
 

/**
 * 解析文件头
 * Content-Disposition:attachment;filename=FileName.txt
 * Content-Disposition: attachment; filename*="UTF-8''%E6%9B%BF%E6%8D%A2%E5%AE%9E%E9%AA%8C%E6%8A%A5%E5%91%8A.pdf"
 */
private static String getHeaderFileName(Response response) {
    String dispositionHeader = response.header(HttpHeaders.HEAD_KEY_CONTENT_DISPOSITION);
    if (dispositionHeader != null) {
        //文件名可能包含双引号，需要去除
        dispositionHeader = dispositionHeader.replaceAll("\"", "");
        String split = "filename=";
        int indexOf = dispositionHeader.indexOf(split);
        if (indexOf != -1) {
            return dispositionHeader.substring(indexOf + split.length(), dispositionHeader.length());
        }
        split = "filename*=";
        indexOf = dispositionHeader.indexOf(split);
        if (indexOf != -1) {
            String fileName = dispositionHeader.substring(indexOf + split.length(), dispositionHeader.length());
            String encode = "UTF-8''";
            if (fileName.startsWith(encode)) {
                fileName = fileName.substring(encode.length(), fileName.length());
            }
            return fileName;
        }
    }
    return null;
}
 

protected okhttp3.Request.Builder generateRequestBuilder(RequestBody requestBody) {
    try {
        headers(HttpHeaders.HEAD_KEY_CONTENT_LENGTH, String.valueOf(requestBody.contentLength()));
    } catch (IOException e) {
        OkLogger.printStackTrace(e);
    }
    okhttp3.Request.Builder requestBuilder = new okhttp3.Request.Builder();
    return HttpUtils.appendHeaders(requestBuilder, headers);
}
 

public static <T> CacheEntity<T> parseCursorToBean(Cursor cursor) {
    CacheEntity<T> cacheEntity = new CacheEntity<>();
    cacheEntity.setKey(cursor.getString(cursor.getColumnIndex(KEY)));
    cacheEntity.setLocalExpire(cursor.getLong(cursor.getColumnIndex(LOCAL_EXPIRE)));
    cacheEntity.setResponseHeaders((HttpHeaders) IOUtils.toObject(cursor.getBlob(cursor.getColumnIndex(HEAD))));
    //noinspection unchecked
    cacheEntity.setData((T) IOUtils.toObject(cursor.getBlob(cursor.getColumnIndex(DATA))));
    return cacheEntity;
}
 

protected okhttp3.Request.Builder generateRequestBuilder(RequestBody requestBody) {
    try {
        headers(HttpHeaders.HEAD_KEY_CONTENT_LENGTH, String.valueOf(requestBody.contentLength()));
    } catch (IOException e) {
        OkLogger.printStackTrace(e);
    }
    okhttp3.Request.Builder requestBuilder = new okhttp3.Request.Builder();
    return HttpUtils.appendHeaders(requestBuilder, headers);
}
 

@OnClick(R.id.btn3)
public void btn3(View view) {
    OkGo.<String>get("asdfasf")//
            .tag(this)//
            .headers(HttpHeaders.HEAD_KEY_USER_AGENT, "abcd")//
            .execute(new StringCallback() {
                @Override
                public void onSuccess(Response<String> response) {

                }
            });
}
 

public static <T> Observable<T> getData(Type type, String url, String header, String param) {
    HttpHeaders headers = new HttpHeaders();
    headers.put("aaa", header);
    HttpParams params = new HttpParams();
    params.put("bbb", param);
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    return RxUtils.request(HttpMethod.POST, url, type, params, headers);
}
 

public static Observable<String> getString(String header, String param) {
    HttpHeaders headers = new HttpHeaders();
    headers.put("aaa", header);
    HttpParams params = new HttpParams();
    params.put("bbb", param);
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    //这个RxUtils的封装其实没有必要，只是有些人喜欢这么干，我就多此一举写出来了。。
    return RxUtils.request(HttpMethod.GET, Urls.URL_METHOD, String.class, params, headers);
}
 

public static <T> CacheEntity<T> parseCursorToBean(Cursor cursor) {
    CacheEntity<T> cacheEntity = new CacheEntity<>();
    cacheEntity.setKey(cursor.getString(cursor.getColumnIndex(KEY)));
    cacheEntity.setLocalExpire(cursor.getLong(cursor.getColumnIndex(LOCAL_EXPIRE)));
    cacheEntity.setResponseHeaders((HttpHeaders) IOUtils.toObject(cursor.getBlob(cursor.getColumnIndex(HEAD))));
    //noinspection unchecked
    cacheEntity.setData((T) IOUtils.toObject(cursor.getBlob(cursor.getColumnIndex(DATA))));
    return cacheEntity;
}
 

public void initOkGo() throws IOException {
        HttpHeaders  headers  = new HttpHeaders();
        if (new SPCookieStore(this).getAllCookie().size() != 0) {
            headers.put("Set-Cookie", String.valueOf(mSPCookieStore.getCookie(HttpUrl.parse(BaseUrl.HTTP_Get_code_auth))));
        }
        headers.put("version", "3.0");
        if (Utils.getSpUtils().getString("loginmode", "").equals("phone")) {
            headers.put("uid", MyApplication.getDaoInstant().getUserBeanDao().queryBuilder().where(UserBeanDao.Properties.Wallet_phone.eq(Utils.getSpUtils().getString("firstUser"))).build().unique().getWallet_uid());
        } else {
            headers.put("uid", "6f1a8e0eb24afb7ddc829f96f9f74e9d");
        }


        OkHttpClient.Builder builder = new OkHttpClient.Builder();
        //log相关
        HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor("OkHttp");
        loggingInterceptor.setPrintLevel(HttpLoggingInterceptor.Level.BODY);        //log打印级别，决定了log显示的详细程度
        loggingInterceptor.setColorLevel(Level.INFO);                               //log颜色级别，决定了log在控制台显示的颜色
        builder.addInterceptor(loggingInterceptor);                                 //添加OkGo默认debug日志
        //超时时间设置
        builder.readTimeout(10000, TimeUnit.MILLISECONDS);      //全局的读取超时时间
        builder.writeTimeout(10000, TimeUnit.MILLISECONDS);     //全局的写入超时时间
        builder.connectTimeout(10000, TimeUnit.MILLISECONDS);   //全局的连接超时时间
        builder.cookieJar(new CookieJarImpl(mSPCookieStore));            //使用sp保持cookie，如果cookie不过期，则一直有效


        HttpsUtils.SSLParams sslParams = HttpsUtils.getSslSocketFactory(getAssets().open("server.cer"));
        builder.sslSocketFactory(sslParams.sSLSocketFactory, sslParams.trustManager);
//        //配置https的域名匹配规则，使用不当会导致https握手失败
        builder.hostnameVerifier(HttpsUtils.UnSafeHostnameVerifier);

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

    }
 

/**
 * 根据请求结果生成对应的缓存实体类，以下为缓存相关的响应头
 * Cache-Control: public                             响应被缓存，并且在多用户间共享
 * Cache-Control: private                            响应只能作为私有缓存，不能在用户之间共享
 * Cache-Control: no-cache                           提醒浏览器要从服务器提取文档进行验证
 * Cache-Control: no-store                           绝对禁止缓存（用于机密，敏感文件）
 * Cache-Control: max-age=60                         60秒之后缓存过期（相对时间）,优先级比Expires高
 * Date: Mon, 19 Nov 2012 08:39:00 GMT               当前response发送的时间
 * Expires: Mon, 19 Nov 2012 08:40:01 GMT            缓存过期的时间（绝对时间）
 * Last-Modified: Mon, 19 Nov 2012 08:38:01 GMT      服务器端文件的最后修改时间
 * ETag: "20b1add7ec1cd1:0"                          服务器端文件的ETag值
 * 如果同时存在cache-control和Expires，浏览器总是优先使用cache-control
 *
 * @param responseHeaders 返回数据中的响应头
 * @param data            解析出来的数据
 * @param cacheMode       缓存的模式
 * @param cacheKey        缓存的key
 * @return 缓存的实体类
 */
public static <T> CacheEntity<T> createCacheEntity(Headers responseHeaders, T data, CacheMode cacheMode, String cacheKey) {

    long localExpire = 0;   // 缓存相对于本地的到期时间

    if (cacheMode == CacheMode.DEFAULT) {
        long date = HttpHeaders.getDate(responseHeaders.get(HttpHeaders.HEAD_KEY_DATE));
        long expires = HttpHeaders.getExpiration(responseHeaders.get(HttpHeaders.HEAD_KEY_EXPIRES));
        String cacheControl = HttpHeaders.getCacheControl(responseHeaders.get(HttpHeaders.HEAD_KEY_CACHE_CONTROL), responseHeaders.get(HttpHeaders.HEAD_KEY_PRAGMA));

        //没有缓存头控制，不需要缓存
        if (TextUtils.isEmpty(cacheControl) && expires <= 0) return null;

        long maxAge = 0;
        if (!TextUtils.isEmpty(cacheControl)) {
            StringTokenizer tokens = new StringTokenizer(cacheControl, ",");
            while (tokens.hasMoreTokens()) {
                String token = tokens.nextToken().trim().toLowerCase(Locale.getDefault());
                if (token.equals("no-cache") || token.equals("no-store")) {
                    //服务器指定不缓存
                    return null;
                } else if (token.startsWith("max-age=")) {
                    try {
                        //获取最大缓存时间
                        maxAge = Long.parseLong(token.substring(8));
                        //服务器缓存设置立马过期，不缓存
                        if (maxAge <= 0) return null;
                    } catch (Exception e) {
                        OkLogger.printStackTrace(e);
                    }
                }
            }
        }

        //获取基准缓存时间，优先使用response中的date头，如果没有就使用本地时间
        long now = System.currentTimeMillis();
        if (date > 0) now = date;

        if (maxAge > 0) {
            // Http1.1 优先验证 Cache-Control 头
            localExpire = now + maxAge * 1000;
        } else if (expires >= 0) {
            // Http1.0 验证 Expires 头
            localExpire = expires;
        }
    } else {
        localExpire = System.currentTimeMillis();
    }

    //将response中所有的头存入 HttpHeaders，原因是写入数据库的对象需要实现序列化，而ok默认的Header没有序列化
    HttpHeaders headers = new HttpHeaders();
    for (String headerName : responseHeaders.names()) {
        headers.put(headerName, responseHeaders.get(headerName));
    }

    //构建缓存实体对象
    CacheEntity<T> cacheEntity = new CacheEntity<>();
    cacheEntity.setKey(cacheKey);
    cacheEntity.setData(data);
    cacheEntity.setLocalExpire(localExpire);
    cacheEntity.setResponseHeaders(headers);
    return cacheEntity;
}
 

public HttpHeaders getResponseHeaders() {
    return responseHeaders;
}
 

public void setResponseHeaders(HttpHeaders responseHeaders) {
    this.responseHeaders = responseHeaders;
}
 

public HttpHeaders getHeaders() {
    return headers;
}
 

/** 获取全局公共请求头 */
public HttpHeaders getCommonHeaders() {
    return mCommonHeaders;
}
 

public void setResponseHeaders(HttpHeaders responseHeaders) {
    this.responseHeaders = responseHeaders;
}
 

public HttpHeaders getResponseHeaders() {
    return responseHeaders;
}
 

/**
 * 根据请求结果生成对应的缓存实体类，以下为缓存相关的响应头
 * Cache-Control: public                             响应被缓存，并且在多用户间共享
 * Cache-Control: private                            响应只能作为私有缓存，不能在用户之间共享
 * Cache-Control: no-cache                           提醒浏览器要从服务器提取文档进行验证
 * Cache-Control: no-store                           绝对禁止缓存（用于机密，敏感文件）
 * Cache-Control: max-age=60                         60秒之后缓存过期（相对时间）,优先级比Expires高
 * Date: Mon, 19 Nov 2012 08:39:00 GMT               当前response发送的时间
 * Expires: Mon, 19 Nov 2012 08:40:01 GMT            缓存过期的时间（绝对时间）
 * Last-Modified: Mon, 19 Nov 2012 08:38:01 GMT      服务器端文件的最后修改时间
 * ETag: "20b1add7ec1cd1:0"                          服务器端文件的ETag值
 * 如果同时存在cache-control和Expires，浏览器总是优先使用cache-control
 *
 * @param responseHeaders 返回数据中的响应头
 * @param data            解析出来的数据
 * @param cacheMode       缓存的模式
 * @param cacheKey        缓存的key
 * @return 缓存的实体类
 */
public static <T> CacheEntity<T> createCacheEntity(Headers responseHeaders, T data, CacheMode cacheMode, String cacheKey) {

    long localExpire = 0;   // 缓存相对于本地的到期时间

    if (cacheMode == CacheMode.DEFAULT) {
        long date = HttpHeaders.getDate(responseHeaders.get(HttpHeaders.HEAD_KEY_DATE));
        long expires = HttpHeaders.getExpiration(responseHeaders.get(HttpHeaders.HEAD_KEY_EXPIRES));
        String cacheControl = HttpHeaders.getCacheControl(responseHeaders.get(HttpHeaders.HEAD_KEY_CACHE_CONTROL), responseHeaders.get(HttpHeaders.HEAD_KEY_PRAGMA));

        //没有缓存头控制，不需要缓存
        if (TextUtils.isEmpty(cacheControl) && expires <= 0) return null;

        long maxAge = 0;
        if (!TextUtils.isEmpty(cacheControl)) {
            StringTokenizer tokens = new StringTokenizer(cacheControl, ",");
            while (tokens.hasMoreTokens()) {
                String token = tokens.nextToken().trim().toLowerCase(Locale.getDefault());
                if (token.equals("no-cache") || token.equals("no-store")) {
                    //服务器指定不缓存
                    return null;
                } else if (token.startsWith("max-age=")) {
                    try {
                        //获取最大缓存时间
                        maxAge = Long.parseLong(token.substring(8));
                        //服务器缓存设置立马过期，不缓存
                        if (maxAge <= 0) return null;
                    } catch (Exception e) {
                        OkLogger.printStackTrace(e);
                    }
                }
            }
        }

        //获取基准缓存时间，优先使用response中的date头，如果没有就使用本地时间
        long now = System.currentTimeMillis();
        if (date > 0) now = date;

        if (maxAge > 0) {
            // Http1.1 优先验证 Cache-Control 头
            localExpire = now + maxAge * 1000;
        } else if (expires >= 0) {
            // Http1.0 验证 Expires 头
            localExpire = expires;
        }
    } else {
        localExpire = System.currentTimeMillis();
    }

    //将response中所有的头存入 HttpHeaders，原因是写入数据库的对象需要实现序列化，而ok默认的Header没有序列化
    HttpHeaders headers = new HttpHeaders();
    for (String headerName : responseHeaders.names()) {
        headers.put(headerName, responseHeaders.get(headerName));
    }

    //构建缓存实体对象
    CacheEntity<T> cacheEntity = new CacheEntity<>();
    cacheEntity.setKey(cacheKey);
    cacheEntity.setData(data);
    cacheEntity.setLocalExpire(localExpire);
    cacheEntity.setResponseHeaders(headers);
    return cacheEntity;
}
 

public HttpHeaders getHeaders() {
    return headers;
}
 

/** 获取全局公共请求头 */
public HttpHeaders getCommonHeaders() {
    return mCommonHeaders;
}
 

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);                       //全局公共参数
}
 

public static <T> Observable<T> request(HttpMethod method, String url, Class<T> clazz, HttpParams params, HttpHeaders headers) {
    return request(method, url, null, clazz, params, headers);
}
 

public static <T> Observable<T> request(HttpMethod method, String url, Type type, HttpParams params, HttpHeaders headers) {
    return request(method, url, type, null, params, headers);
}
 

/**
     * 初始化 OkGo 配置
     * <pre>
     *     @see <a href="https://github.com/jeasonlzy/okhttp-OkGo/wiki/Init"/>
     *     tips: 最简单的配置直接调用 OkGo.getInstance().init(this); {@link OkGo}
     *     在 App {@link Application} 初始化
     * </pre>
     * @param application {@link Application}
     */
    public static void initOkGo(Application application) {
        OkHttpClient.Builder builder = new OkHttpClient.Builder();

        // 自定义日志拦截 JSON 打印
        builder.addInterceptor(new dev.other.okgo.HttpLoggingInterceptor());

        // ========================
        // = OkGo 内置 log 拦截器 =
        // ========================

        HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor("OkGo");
        // log 打印级别, 决定了 log 显示的详细程度
        loggingInterceptor.setPrintLevel(HttpLoggingInterceptor.Level.BODY);
        // log 颜色级别, 决定了 log 在控制台显示的颜色
        loggingInterceptor.setColorLevel(Level.INFO);
        builder.addInterceptor(loggingInterceptor);

        // ===============
        // = 配置超时时间 =
        // ===============

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

        // =============================
        // = Cookie 持久化 ( Session ) =
        // =============================

        // 使用 sp 保持 cookie, 如果 cookie 不过期, 则一直有效
        builder.cookieJar(new CookieJarImpl(new SPCookieStore(application)));
//        // 使用数据库保持 cookie, 如果 cookie 不过期, 则一直有效
//        builder.cookieJar(new CookieJarImpl(new DBCookieStore(application)));
//        // 使用内存保持 cookie, app 退出后, cookie 消失
//        builder.cookieJar(new CookieJarImpl(new MemoryCookieStore()));

        // ==============
        // = Https 配置 =
        // ==============

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

        HttpsUtils.SSLParams sslParams = HttpsUtils.getSslSocketFactory();
        builder.sslSocketFactory(sslParams.sSLSocketFactory, sslParams.trustManager);
        builder.hostnameVerifier(HttpsUtils.UnSafeHostnameVerifier);

        // ===============
        // = 全局公共数据 =
        // ===============

        // header 不支持中文, 不允许有特殊字符
        HttpHeaders headers = new HttpHeaders();
        headers.put("commonHeaderKey1", "commonHeaderValue1");
        headers.put("commonHeaderKey2", "commonHeaderValue2");

        // param 支持中文, 直接传, 不要自己编码
        HttpParams params = new HttpParams();
        params.put("commonParamsKey1", "commonParamsValue1");
        params.put("commonParamsKey2", "这里支持中文参数");

        // =======================
        // = 初始化 ( 应用 ) 配置 =
        // =======================

        OkGo.getInstance().init(application)
                // 建议设置 OkHttpClient, 不设置将使用默认的
                .setOkHttpClient(builder.build())
                // 全局统一缓存模式, 默认不使用缓存, 可以不传
                .setCacheMode(CacheMode.NO_CACHE)
                // 全局统一缓存时间, 默认永不过期, 可以不传
                .setCacheTime(CacheEntity.CACHE_NEVER_EXPIRE)
                // 全局统一超时重连次数, 默认为三次, 那么最差的情况会请求 4 次 ( 一次原始请求, 三次重连请求 ), 不需要可以设置为 0
                .setRetryCount(3)
                // 全局公共头
                .addCommonHeaders(headers)
                // 全局公共参数
                .addCommonParams(params);
    }
 

/**
 * 对每个请求添加默认的请求头，如果有缓存，并返回缓存实体对象
 * Cache-Control: max-age=0                            以秒为单位
 * If-Modified-Since: Mon, 19 Nov 2012 08:38:01 GMT    缓存文件的最后修改时间。
 * If-None-Match: "0693f67a67cc1:0"                    缓存文件的ETag值
 * Cache-Control: no-cache                             不使用缓存
 * Pragma: no-cache                                    不使用缓存
 * Accept-Language: zh-CN,zh;q=0.8                     支持的语言
 * User-Agent:                                         用户代理，它的信息包括硬件平台、系统软件、应用软件和用户个人偏好
 * Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.101 Safari/537.36
 *
 * @param request     请求类
 * @param cacheEntity 缓存实体类
 * @param cacheMode   缓存模式
 */
public static <T> void addCacheHeaders(Request request, CacheEntity<T> cacheEntity, CacheMode cacheMode) {
    //1. 按照标准的 http 协议，添加304相关请求头
    if (cacheEntity != null && cacheMode == CacheMode.DEFAULT) {
        HttpHeaders responseHeaders = cacheEntity.getResponseHeaders();
        if (responseHeaders != null) {
            String eTag = responseHeaders.get(HttpHeaders.HEAD_KEY_E_TAG);
            if (eTag != null) request.headers(HttpHeaders.HEAD_KEY_IF_NONE_MATCH, eTag);
            long lastModified = HttpHeaders.getLastModified(responseHeaders.get(HttpHeaders.HEAD_KEY_LAST_MODIFIED));
            if (lastModified > 0) request.headers(HttpHeaders.HEAD_KEY_IF_MODIFIED_SINCE, HttpHeaders.formatMillisToGMT(lastModified));
        }
    }
}
 

/**
 * 对每个请求添加默认的请求头，如果有缓存，并返回缓存实体对象
 * Cache-Control: max-age=0                            以秒为单位
 * If-Modified-Since: Mon, 19 Nov 2012 08:38:01 GMT    缓存文件的最后修改时间。
 * If-None-Match: "0693f67a67cc1:0"                    缓存文件的ETag值
 * Cache-Control: no-cache                             不使用缓存
 * Pragma: no-cache                                    不使用缓存
 * Accept-Language: zh-CN,zh;q=0.8                     支持的语言
 * User-Agent:                                         用户代理，它的信息包括硬件平台、系统软件、应用软件和用户个人偏好
 * Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/45.0.2454.101 Safari/537.36
 *
 * @param request     请求类
 * @param cacheEntity 缓存实体类
 * @param cacheMode   缓存模式
 */
public static <T> void addCacheHeaders(Request request, CacheEntity<T> cacheEntity, CacheMode cacheMode) {
    //1. 按照标准的 http 协议，添加304相关请求头
    if (cacheEntity != null && cacheMode == CacheMode.DEFAULT) {
        HttpHeaders responseHeaders = cacheEntity.getResponseHeaders();
        if (responseHeaders != null) {
            String eTag = responseHeaders.get(HttpHeaders.HEAD_KEY_E_TAG);
            if (eTag != null) request.headers(HttpHeaders.HEAD_KEY_IF_NONE_MATCH, eTag);
            long lastModified = HttpHeaders.getLastModified(responseHeaders.get(HttpHeaders.HEAD_KEY_LAST_MODIFIED));
            if (lastModified > 0) request.headers(HttpHeaders.HEAD_KEY_IF_MODIFIED_SINCE, HttpHeaders.formatMillisToGMT(lastModified));
        }
    }
}