BaseOkHttpV3: 🔥OkHttp的二次封装库，提供各种快速使用方法以及更为方便的扩展功能。提供更高效的Json请求和解析工具以及文件上传下载封装，HTTPS和Cookie操作也更得心应手。

# BaseOkHttpV3

#### 项目介绍
- 项目名称：BaseOkHttpV3
- 所属系列：openharmony的第三方组件适配移植
- 功能：OkHttp的二次封装库，提供各种快速使用方法以及更为方便的扩展功能。提供更高效的Json请求和解析工具以及文件上传下载封装，HTTPS和Cookie操作也更得心应手
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio 2.2 Beta1
- 基线版本：release v3.2.1

#### 效果演示
![效果演示](https://gitee.com/chinasoft_ohos/BaseOkHttpV3/raw/master/img/1.gif "效果演示.gif")
![效果演示](https://gitee.com/chinasoft_ohos/BaseOkHttpV3/raw/master/img/2.gif "效果演示.gif")
![效果演示](https://gitee.com/chinasoft_ohos/BaseOkHttpV3/raw/master/img/3.gif "效果演示.gif")

#### 安装教程
                                
1.在项目根目录下的build.gradle文件中，
 ```gradle
allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
}
 ```
2.在entry模块的build.gradle文件中，
 ```gradle
 dependencies {
    implementation('com.gitee.chinasoft_ohos:BaseOkHttpV3:1.0.1')
    ......  
 }
 ```

在sdk6，DevEco Studio 2.2 Beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明

1.一般请求
BaseOkHttpV3 提供两种请求写法，范例如下：

1.1 以参数形式创建请求：

```
HttpRequest.POST(context, "http://你的接口地址", new Parameter().add("page", "1"), new ResponseListener() {
    @Override
    public void onResponse(String response, Exception error) {
        progressDialog.dismiss();
        if (error == null) {
            resultHttp.setText(response);
        } else {
            resultHttp.setText("请求失败");
        }
    }
});
```

Parameter 对象是一个 Map 的封装对象，可以通过 `.toParameterString()` 方法获得按 key 首字母排序、以“&”符号连接的文本串，或者使用 `.toParameterJson()` 方法将其转为 JSONObject。

一般请求中，使用 HttpRequest.POST(...) 方法可直接创建 POST 请求，相应的，`HttpRequest.GET(...)` 可创建 GET 请求，另外可选额外的方法增加 header 请求头：
```
HttpRequest.POST(Context context, String url, Parameter headers, Parameter parameter, ResponseListener listener);
HttpRequest.GET(Context context, String url, Parameter headers, Parameter parameter, ResponseListener listener);
```

1.2 以流式代码创建请求：

```
HttpRequest.build(context,"http://你的接口地址")
        .addHeaders("Charset", "UTF-8")
        .addParameter("page", "1")
        .addParameter("token", "A128")
        .setResponseListener(new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(response);
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        })
        .doPost();
```
返回回调监听器只有一个，请在其中对 error 参数判空，若 error 不为空，则为请求失败，反之则为请求成功，请求成功后的数据存放在 response 参数中。

之所以将请求成功与失败放在一个回调中主要目的是方便无论请求成功或失败都需要执行的代码，例如上述代码中的 progressDialog 等待对话框都需要关闭（dismiss掉），这样的写法更为方便。

直接解析返回值为 jsonMap 对象，可使用 `JsonResponseListener` 监听器返回：
```
HttpRequest.POST(context, "/femaleNameApi", new Parameter().add("page", "1"), new JsonResponseListener() {
    @Override
    public void onResponse(JsonMap main, Exception error) {
        if (error == null) {
            resultHttp.setText(main.getString("msg"));
        } else {
            resultHttp.setText("请求失败");
        }
    }
});
```

1.3 关于返回线程的说明

BaseOkHttpV3 会智能的判断需要返回线程的场景，一般而言，您无需为此而操心，您可以直接在请求回调中进行 UI 的操作。

BaseOkHttpV3 的请求过程是异步进行的（多线程），而在返回数据后，是根据 context 进行判断的是要在异步线程执行还是在 UI 线程执行，当 context 传入的是 Ability 时，默认会在 UI 线程返回，无需额外处理线程问题，而当 context 为非 PageAbility，例如 ApplicationContext 或者 Service 时，则会在异步线程返回数据，若需要修改界面上的元素显示，您需要手动切换到主线程刷新 UI 组件。

这是在我们经过大量的使用场景调研后得出的最优设计方案，但如若您的请求返回数据流非常大，可能造成 UI 线程卡顿，建议在传入 context 时，使用 `AbilityPackage` 方法来强制异步线程返回，待数据得到妥善处理后，需要返回 UI 线程刷新界面显示时，使用 `PageAbility`切换到主线程进行刷新。

2.JSON请求

有时候我们需要使用已经处理好的json文本作为请求参数，此时可以使用 `HttpRequest.JSONPOST(...)` 方法创建 json 请求。

json 请求中，参数为文本类型，创建请求方式如下：
```
HttpRequest.JSONPOST(context, "http://你的接口地址", "{\"key\":\"DFG1H56EH5JN3DFA\",\"token\":\"124ASFD53SDF65aSF47fgT211\"}", new ResponseListener() {
    @Override
    public void onResponse(String response, Exception error) {
        progressDialog.dismiss();
        if (error == null) {
            resultHttp.setText(response);
        } else {
            resultHttp.setText("请求失败");
        }
    }
});
```

也可以使用 JsonMap 构建请求参数：
```
JsonMap jsonMap = new JsonMap();
jsonMap.set("key", "DFG1H56EH5JN3DFA");
jsonMap.set("token", "124ASFD53SDF65aSF47fgT211");

HttpRequest.JSONPOST(context, "http://你的接口地址", jsonMap, new ResponseListener() {
    @Override
    public void onResponse(String response, Exception error) {
        progressDialog.dismiss();
        if (error == null) {
            resultHttp.setText(response);
        } else {
            resultHttp.setText("请求失败");
        }
    }
});
```

另外参数也可以是 JSONObject 类型（来自 org.json 框架）。

Json请求中，可使用 `HttpRequest.JSONPOST(...)` 快速创建 Json 请求，另外可选额外的方法增加 header 请求头：
```
HttpRequest.JSONPOST(Context context, String url, Parameter headers, String jsonParameter, ResponseListener listener)
```

也可以使用流式代码创建请求：
```
HttpRequest.build(context,"http://你的接口地址")
        .setJsonParameter("{\"key\":\"DFG1H56EH5JN3DFA\",\"token\":\"124ASFD53SDF65aSF47fgT211\"}")
        .setResponseListener(new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(response);
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        })
        .doPost();
```
因需要封装请求体，Json请求只能以非 GET 请求的方式进行。

3.文件上传
要使用文件上传就需要将 File 类型的文件作为参数传入 Parameter，此时参数中亦可以传入其他文本类型的参数。

因需要封装请求体，文件上传只能以非 GET 请求的形式发送。

范例代码如下：
```
HttpRequest.POST(context, "http://你的接口地址", new Parameter()
                         .add("key", "DFG1H56EH5JN3DFA")
                         .add("imageFile1", file1)
                         .add("imageFile2", file2)
        , new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(response);
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        });
```
也可以使用流式代码创建请求：
```
HttpRequest.build(context,"http://你的接口地址")
        .addHeaders("Charset", "UTF-8")
        .addParameter("page", "1")
        .addParameter("imageFile1", file1)
        .addParameter("imageFile2", file2)
        .setResponseListener(new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(response);
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        })
        .doPost();
```

上传文件的 MIME 类型将自动根据上传文件的后缀名自动生成。

另外，对于单参数（key）多文件（value）的情况，可使用以下方法进行上传：
```
List<File> fileList = new ArrayList<File>();
fileList.add(file1);
fileList.add(file2);
HttpRequest.build(context,"http://你的接口地址")
        .addHeaders("Charset", "UTF-8")
        .addParameter("page", "1")
        .addParameter("file", fileList)
        .setResponseListener(new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(response);
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        })
        .doPost();
```

要监控上传进度，可以使用方法 setUploadProgressListener(...) 进行：
```
HttpRequest.build(context,"http://你的接口地址")
        .addHeaders("Charset", "UTF-8")
        .addParameter("page", "1")
        .addParameter("file", fileList)
        .setUploadProgressListener(new UploadProgressListener() {
            @Override
            public void onUpload(float percentage, long current, long total, boolean done) {
                HiLog.e(Logger.LABEL, "上传进度: 百分比（float）="+percentage +" "+
                        "已上传字节数="+current +" "+
                        "总字节数="+total +" "+
                        "是否已完成="+done +" "
                );
            }
        })
        .setResponseListener(...)
        .doPost();
```

4.文件下载
首先请确保您的 APP 已经在 reqPermissions 声明读写权限：
```
 "name": "ohos.permission.WRITE_USER_STORAGE"
 "name": "ohos.permission.READ_USER_STORAGE"
```
并确保您以获得该权限许可。

您可以使用以下代码启动下载进程：
```
HttpRequest.DOWNLOAD(
        this,
        "http://cdn.to-future.net/apk/tofuture.apk",
        new File(new File(Environment.getExternalStorageDirectory().getAbsolutePath(), "BaseOkHttpV3"), "to-future.apk"),
        new OnDownloadListener() {
            @Override
            public void onDownloadSuccess(File file) {
               //文件下载完成
            }
            @Override
            public void onDownloading(int progress) {
                psgDownload.setProgress(progress);
            }
            @Override
            public void onDownloadFailed(Exception e) {
               //下载失败
            }
        }
);
```

也可以使用build创建：
```
httpRequest = HttpRequest.build(this, "http://cdn.to-future.net/apk/tofuture.apk");
httpRequest.doDownload(
        new File(new File(Environment.getExternalStorageDirectory().getAbsolutePath(), "BaseOkHttpV3"), "to-future.apk"),
        new OnDownloadListener() {
            @Override
            public void onDownloadSuccess(File file) {
               //文件下载完成
            }
            
            @Override
            public void onDownloading(int progress) {
                psgDownload.setProgress(progress);
            }
            
            @Override
            public void onDownloadFailed(Exception e) {
                //下载失败
            }
        }
);

//停止下载：
httpRequest.stop();
```

额外的，若存储文件的父文件夹不存在，会自动创建。

5.PUT&DELETE
PUT 和 DELETE 请求方式，使用方法和一般请求一致，可以通过以下两种方法创建：
```
//PUT 请求：
HttpRequest.PUT(context, "http://你的接口地址", new Parameter().add("page", "1"), new ResponseListener() {...});
//DELETE 请求：
HttpRequest.DELETE(context, "http://你的接口地址", new Parameter().add("page", "1"), new ResponseListener() {...});
```
也可适用流式代码创建：
```
HttpRequest.build(context,"http://你的接口地址")
        .addHeaders("Charset", "UTF-8")
        .addParameter("page", "1")
        .addParameter("token", "A128")
        .setResponseListener(new ResponseListener() {
            @Override
            public void onResponse(String response, Exception error) {
                ...
            }
        })
        .doPut();
        //.doDelete();
```

6.WebSocket
WebSocket 封装工具类 BaseWebSocket，用于快速实现 WebSocket 请求连接。

使用方法：
```
//通过 BUILD 方法获取 baseWebSocket 实例化对象，参数 context 为上下文索引，url 为 websocket服务器地址：
baseWebSocket = BaseWebSocket.BUILD(context, url)
        //实现监听方法
        .setWebSocketStatusListener(new WebSocketStatusListener() {
            @Override
            public void connected(Response response) {
                //连接上时触发
            }
            @Override
            public void onMessage(String message) {
                //处理收到的消息 message
            }
            @Override
            public void onMessage(ByteString message) {
            }
            @Override
            public void onReconnect() {
                //重新连接时触发
            }
            @Override
            public void onDisconnected(int breakStatus) {
                //断开连接时触发，breakStatus 值为 BREAK_NORMAL 时为正常断开，值为 BREAK_ABNORMAL  时为异常断开
            }
            @Override
            public void onConnectionFailed(Throwable t) {
                //连接错误处理
                t.printStackTrace();
            }
        })
        .startConnect();        //开始连接

//发送消息
baseWebSocket.send("Test!");

//断开连接
baseWebSocket.disConnect();

//重新连接
baseWebSocket.reConnect();
```

7.JSON解析

Json 解析功能，此功能基于 `org.json` 库二次实现，基本实现了无惧空指针异常的特性。

因原始 `org.json` 库提供的 JsonObject 和 JsonArray 框架使用起来相对麻烦，我们对其进行了二次封装和完善，且因 BaseOkHttpV3提供的 Json 解析框架底层使用的是 Map 和 List，与适配器具有更好的兼容性。

使用 BaseOkHttpV3提供的 Json 解析框架无需判断 Json 转换异常，可以直接将 Json 文本字符串传入解析。

另外，JsonMap 和 JsonList 的 `toString()` 方法可输出该对象原始 json 文本；

提供直接解析返回值为 jsonMap 对象

JsonMap 和 JsonList 用有构建方法 `parse(String json)` 用以直接根据 json 文本创建 JsonMap 和 JsonList 对象，可以通过该方法创建 JsonMap 或 JsonList 对象：
```
//通过 json 文本创建 JsonMap
JsonMap data = JsonMap.parse("{\"key\":\"DFG1H56EH5JN3DFA\",\"token\":\"124ASFD53SDF65aSF47fgT211\"}");

//通过 json 文本创建 JsonList
JsonList list = JsonList.parse("[{\"answerId\":\"98\",\"questionDesc\":\"否\"},{\"answerId\":\"99\",\"questionDesc\":\"是\"}]");
```

7.1 请求后自动返回 JsonMap

使用 `JsonResponseListener` 作为返回监听器，即可在返回时直接处理 JsonMap 对象：
```
HttpRequest.POST(context, "/femaleNameApi", new Parameter().add("page", "1"), new JsonResponseListener() {
    @Override
    public void onResponse(JsonMap main, Exception error) {
        progressDialog.dismiss();
        if (error == null) {
            resultHttp.setText(main.toString());
        } else {
            resultHttp.setText("请求失败");
        }
    }
});
```

也可以这样写：
```
HttpRequest.build(context, "/femaleNameApi")
        .addParameter("page", "1")
        .setJsonResponseListener(new JsonResponseListener() {
            @Override
            public void onResponse(JsonMap main, Exception error) {
                progressDialog.dismiss();
                if (error == null) {
                    resultHttp.setText(main.toString());
                } else {
                    resultHttp.setText("请求失败");
                }
            }
        });
```
请注意，为杜绝空指针异常，即使请求失败，error!=null 时，返回的 main 依然不会是空指针，而是一个空的 JsonMap 对象，可通过 .isEmpty() 方法判空。

7.2 对于未知 Json 文本

```
Object obj = JsonUtil.deCodeJson(JsonStr);
```
deCodeJson 方法提供的是未知目标字符串是 JsonArray 还是 JsonObject 的情况下使用，返回对象为 Object，此时判断：
```
if(obj != null){
    if (obj instanceof JsonMap){
        //此对象为JsonObject，使用get(...)相关方法获取其中的值
    }
    if (obj instanceof JsonList){
        //此对象为JsonArray，使用get(index)相关方法获取其中的子项
    }
}
```
请注意对 obj 进行判空处理，若解析失败，则会返回 null。

7.3 对于已知 JsonObject 文本
```
JsonMap map = JsonUtil.deCodeJsonObject(JsonStr);        //直接解析为Map对象，JsonMap继承自LinkedHashMap，按照入栈顺序存储键值对集合
```
请注意对 map 进行判空处理，若解析失败，则会返回 null。

7.4 对于已知 JsonArray 文本
```
JsonList list = JsonUtil.deCodeJsonArray(JsonStr);        //直接解析为List对象，JsonList继承自ArrayList
```
请注意对 list 进行判空处理，若解析失败，则会返回 null。

7.5 额外说明
为方便解析使用，JsonMap 和 JsonList 都提供对应的如下方法来获取内部元素的值：
```
getString(...)
getInt(...)
getBoolean(...)
getLong(...)
getShort(...)
getDouble(...)
getFloat(...)
getList(...)
getJsonMap(...)
```

请注意，您亦可使用 Map、List 自带的 `get(...)` 方法获取元素的值，但 JsonMap 和 JsonList 提供的额外方法对于空指针元素，会返回一个默认值，例如对于实际是 null 的 String，会返回空字符串“”，对于实际是 null 的元素，获取其int值则为0。

若您需要空值判断，可以通过例如 `getInt(String key, int emptyValue)` 来进行，若为空值会返回您提供的 emptyValue。

这确实不够严谨，但更多的是为了提升开发效率，适应快速开发的生产要求。

8.JavaBean解析
回调直接解析 json 为 JavaBean 的功能：

在设置回调时，请使用 BeanResponseListener，并在其泛型中传入要解析的 JavaBean，在回调中即可获取已经实例化并设置好数据的 JavaBean 对象：
```
HttpRequest.POST(this, "/getWangYiNews", new Parameter()
                .add("page", "1")
                .add("count", 5)
           , new BeanResponseListener<DataBean>() {
               @Override
               public void onResponse(DataBean main, Exception error) {
                   if (error == null) {
                       Log.e(">>>", "onResponse: " + main);
                   } else {
                       error.printStackTrace();
                   }
               }
           }
);
```

JavaBean 对象中必须包含每个属性的对应 get、set 方法，且必须使用驼峰命名规则。

支持 boolean 类型的数据获取方法以“is”开头的命名方式，例如“boolean isVIP()”或者“boolean getVIP()”都可以。

9.额外功能

9.1 全局日志
全局日志开关（默认是关闭态，需要手动开启）：
```
BaseOkHttp.DEBUGMODE = true;
```
BaseOkHttpV3支持增强型日志，使用输出日志内容是 json 字符串时，会自动格式化输出，方便查看。

在您使用 BaseOkHttp 时可以在 Logcat 的筛选中使用字符 “>>>” 对日志进行筛选（Logcat日志界面上方右侧的搜索输入框）。

9.2 全局请求地址
设置全局请求地址后，所有接口都可以直接使用相对地址进行，例如设置全局请求地址：
```
BaseOkHttp.serviceUrl = "https://www.example.com";
```
发出一个请求：
```
HttpRequest.POST(context, "/femaleNameApi", new Parameter().add("page", "1"), new ResponseListener() {...});
```

注意，设置全局请求地址后，若 HttpRequest 的请求参数地址为“http”开头，则不会拼接全局请求地址。

9.3 全局 Header 请求头
使用如下代码预设置全局 Header 请求头：
```
BaseOkHttp.overallHeader = new Parameter()
        .add("Charset", "UTF-8")
        .add("Content-Type", "application/json")
        .add("Accept-Encoding", "gzip,deflate")
;
```

需要对请求 Header 进行实时处理，则可实现处理接口，例如下边的代码，对 Header 请求头进行了签名操作：
```
BaseOkHttp.headerInterceptListener = new HeaderInterceptListener() {
    @Override
    public Parameter onIntercept(Context context, String url, Parameter header) {
        String signStr = sign(header.toParameterString());
        header.add("sign", signStr);
        return header;
    }
};
```

9.4 全局请求返回拦截器
使用如下代码可以设置全局返回数据监听拦截器，return true 可返回请求继续处理，return false 即拦截掉不会继续返回原请求进行处理；
```
BaseOkHttp.responseInterceptListener = new ResponseInterceptListener() {
    @Override
    public boolean onResponse(Context context, String url, String response, Exception error) {
        if (error != null) {
            return true;
        } else {
            Log.i("!!!", "onResponse: " + response);
            return true;
        }
    }
};
```

请求返回拦截器另外还有 JsonResponseInterceptListener 实现和 BeanResponseInterceptListener 实现，以便于直接对特定返回数据形式进行处理，使用方法与 ResponseInterceptListener 一致。

9.5 HTTPS 支持
1) 请将SSL证书文件放在rawfile目录中，例如“test.cer”；
2) 以附带SSL证书名的方式创建请求：
```
BaseOkHttp.SSLInAssetsFileName = "test.cer";
...
```
即可使用Https请求方式。

另外，可使用 `BaseOkHttp.httpsVerifyServiceUrl=(boolean)` 设置是否校验请求主机地址与设置的 HttpRequest.serviceUrl 一致；

9.6 全局参数拦截器
使用如下代码可以设置全局参数监听拦截器，此参数拦截器可以拦截并修改、新增所有请求携带的参数。

对于一个项目，拦截器 parameterInterceptListener 是 static 的，即唯一的，目前不支持单项目内多种类型（例如表单参数、Json参数、String参数）请求参数同时存在的拦截需求。

9.6.1 对于一般表单形式参数的请求
此方法亦适用于需要对参数进行加密的场景：
```
BaseOkHttp.parameterInterceptListener = new ParameterInterceptListener<Parameter>() {
    @Override
    public Parameter onIntercept(Context context, String url, Parameter parameter) {
        parameter.add("key", "DFG1H56EH5JN3DFA");
        parameter.add("sign", makeSign(parameter.toParameterString()));
        return parameter;           //请注意将处理后的参数回传
    }
};

private String makeSign(String parameterString){
    //加密逻辑
    ...
}
```
onIntercept 返回值中，context 为当前请求的上下文索引，url 为当前请求地址，parameter 为请求参数，在处理完后，请注意需要 return 处理后的 parameter。

9.6.2 对于Json形式的参数请求
使用泛型约束为 JsonMap 参数：
```
BaseOkHttp.parameterInterceptListener = new ParameterInterceptListener<JsonMap>() {
    @Override
    public Parameter onIntercept(Context context, String url, JsonMap parameter) {
        parameter.set("key", "DFG1H56EH5JN3DFA");
        return parameter;           //请注意将处理后的参数回传
    }
};
```

若为 JsonArray，则可约束为 JsonList 类型：
```
BaseOkHttp.parameterInterceptListener = new ParameterInterceptListener<JsonList>() {
    @Override
    public Parameter onIntercept(Context context, String url, JsonList parameter) {
        parameter.set("img1");
        parameter.set("img2");
        return parameter;           //请注意将处理后的参数回传
    }
};
```

9.6.3 对于其他类型参数，包含String、XML等
统一约束泛型为 String 处理：
```
BaseOkHttp.parameterInterceptListener = new ParameterInterceptListener<String>() {
    @Override
    public Parameter onIntercept(Context context, String url, String parameter) {
        //对 parameter 进行处理
        return parameter;           //请注意将处理后的参数回传
    }
};
```

9.7 请求超时
使用以下代码设置请求超时时间（单位：秒）
```
BaseOkHttp.TIME_OUT_DURATION = 10;
```

一旦发生请求超时，将会停止本次请求，并在请求返回的 error 参数中回传 TimeOutException()。

9.8 停止请求
可使用以下方法停止请求过程：
```
httpRequest.stop();     //停止请求
```

9.9 容灾地址

使用 BaseOkHttp.reserveServiceUrls 设置容灾地址。

该属性类型为 StringArray，设置案例如下：
```
BaseOkHttp.reserveServiceUrls = new String[]{
        "https://www.testB.com",
        "https://www.testC.com",
        "https://api.testD.com"
};
```

当主服务器地址 BaseOkHttp.serviceUrl 请求不通后，会依次尝试 BaseOkHttp.reserveServiceUrls 配置的地址，若全部失败，则会执行回调函数，若其中一个能够请求成功，则主服务器地址 BaseOkHttp.serviceUrl 会被替换为该地址，完成接下来的请求。

9.10 Cookie
设置 Cookie 请求头：
```
httpRequest.setCookie(String);
```

开启自动存储和携带服务端返回的 Cookie：
```
BaseOkHttp.autoSaveCookies = true;
```

获取已保存 Cookie 队列：
```
httpRequest.getCookies();
```

9.11 重复请求拦截

开启拦截重复请求：

```
BaseOkHttp.disallowSameRequest = true;
```

开启后，同一请求（url、参数都相同）一次只能发出一个，在该请求未完成（成功、失败、超时）前无法发出相同的请求。

若有需要同时发出相同地址和参数的请求，可以选择增加一个时间戳来区分请求。

若有清除重复请求判断队列的需要，可以使用以下代码清除：

```
BaseOkHttp.cleanSameRequestList();
```

9.12 自定义 OkHttpClient 或 OkHttpClient.Builder

BaseOkHttpV3 的底层是 OkHttp，我们提供了自动化的默认 OkHttpClient 实现，但您也许会有需要客制化这些组件以实现更多功能。

要定制 OkHttpClient 或 OkHttpClient.Builder，请先使用 `HttpRequest.build(context)`构建请求，然后使用 `setCustomOkHttpClient(CustomOkHttpClient)`和`setCustomOkHttpClientBuilder(CustomOkHttpClientBuilder)`来设置定制接口，在请求发出前对 OkHttpClient.Builder 和 OkHttpClient 进行修改，需要将修改后的组件 return 到接口返回参数中才可生效。

要全局拦截 OkHttpClient 或 OkHttpClient.Builder，您可以设置`BaseOkHttp.globalCustomOkHttpClient`和`BaseOkHttp.globalCustomOkHttpClientBuilder`进行拦截修改，需要将修改后的组件 return 到接口返回参数中才可生效。

#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

#### 版本迭代

- 1.0.1

#### 版权和许可信息

Copyright Kongzue BaseOkHttp
    
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    
       http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
    
    本项目中使用的网络请求底层框架为square.okHttp3(https://github.com/square/okhttp )，感谢其为开源做出的贡献。
    
    相关协议如下：
    
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    
       http://www.apache.org/licenses/LICENSE-2.0
    
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.

CHINASOFT_OHOS/BaseOkHttpV3

简介

发行版

贡献者

近期动态

CHINASOFT_OHOS/BaseOkHttpV3 .gitee-modal { width: 500px !important; }

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

CHINASOFT_OHOS/BaseOkHttpV3