- 所有已知实现类:
OkHttpBuilderImpl
- 封闭接口:
- HTTP
public static interface HTTP.Builder
HTTP 构建器
自 v3.3.0 开始接口化,在以后版本中将逐步与 okhttp3 解耦
-
方法概要
修饰符和类型方法说明addMsgConvertor(MsgConvertor msgConvertor) addPreprocessor(Preprocessor preprocessor) 添加可并行处理请求任务的预处理器addSerialPreprocessor(Preprocessor preprocessor) 添加串行预处理器baseUrl()设置 baseUrlbodyType()build()构建 HTTP 实例callbackExecutor(Executor executor) 设置回调执行器,例如实现切换线程功能,只对异步请求有效charset()清空 ContentType清空消息转换器清空预处理器(包括串行预处理器)completeListener(TaskListener<HttpResult.State> listener) 设置全局完成监听config(HTTP.OkConfig config) 自 v3.2.0 后可以多次调用 配置 OkHttpClientString[]contentTypes(String contentType) 配置支持的报文体类型contentTypes(List<String> contentTypes) 配置支持的报文体类型downloadHelper(DownloadHelper resolver) downloadListener(DownListener listener) 设置下载监听器exceptionListener(TaskListener<IOException> listener) 设置全局异常监听mediaTypes(String key, String value) 配置媒体类型mediaTypes(Map<String, String> mediaTypes) 配置媒体类型intpreprocTimeoutTimes(int times) 最大预处理时间(倍数,相当普通请求的超时时间)responseListener(TaskListener<HttpResult> listener) 设置全局响应监听taskScheduler(Scheduler scheduler) 配置 任务调度器,可用的调度由WHttpTask.heatbeat(int, int)指定的心跳任务 若不配置,则生成一个 线程容量为 1 的 ScheduledThreadPoolExecutor 调度器
-
方法详细资料
-
config
自 v3.2.0 后可以多次调用 配置 OkHttpClient- 参数:
config- 配置器- 返回:
- Builder
-
baseUrl
设置 baseUrl- 参数:
baseUrl- 全局URL前缀- 返回:
- Builder
-
baseUrl
String baseUrl() -
mediaTypes
配置媒体类型- 参数:
mediaTypes- 媒体类型- 返回:
- Builder
-
mediaTypes
配置媒体类型- 参数:
key- 媒体类型KEYvalue- 媒体类型VALUE- 返回:
- Builder
-
getMediaTypes
-
clearContentTypes
HTTP.Builder clearContentTypes()清空 ContentType- 返回:
- Builder
- 从以下版本开始:
- v3.5.0
-
contentTypes
配置支持的报文体类型- 参数:
contentTypes- 报文体类型列表- 返回:
- Builder
-
contentTypes
配置支持的报文体类型- 参数:
contentType- 报文体类型- 返回:
- Builder
-
contentTypes
String[] contentTypes() -
callbackExecutor
设置回调执行器,例如实现切换线程功能,只对异步请求有效- 参数:
executor- 回调执行器- 返回:
- Builder
-
mainExecutor
Executor mainExecutor() -
taskScheduler
配置 任务调度器,可用的调度由WHttpTask.heatbeat(int, int)指定的心跳任务 若不配置,则生成一个 线程容量为 1 的 ScheduledThreadPoolExecutor 调度器- 参数:
scheduler- 调度器- 返回:
- Builder
- 从以下版本开始:
- v2.3.0
-
taskScheduler
Scheduler taskScheduler() -
addPreprocessor
添加可并行处理请求任务的预处理器- 参数:
preprocessor- 预处理器- 返回:
- Builder
-
addSerialPreprocessor
添加串行预处理器- 参数:
preprocessor- 预处理器- 返回:
- Builder
-
clearPreprocessors
HTTP.Builder clearPreprocessors()清空预处理器(包括串行预处理器)- 返回:
- Builder
- 从以下版本开始:
- v2.5.0
-
preprocessors
Preprocessor[] preprocessors() -
preprocTimeoutTimes
最大预处理时间(倍数,相当普通请求的超时时间)- 参数:
times- 普通超时时间的倍数,默认为 10- 返回:
- Builder
-
preprocTimeoutTimes
int preprocTimeoutTimes() -
responseListener
设置全局响应监听- 参数:
listener- 监听器- 返回:
- Builder
-
responseListener
TaskListener<HttpResult> responseListener() -
exceptionListener
设置全局异常监听- 参数:
listener- 监听器- 返回:
- Builder
-
exceptionListener
TaskListener<IOException> exceptionListener() -
completeListener
设置全局完成监听- 参数:
listener- 监听器- 返回:
- Builder
-
completeListener
TaskListener<HttpResult.State> completeListener() -
downloadListener
设置下载监听器- 参数:
listener- 监听器- 返回:
- Builder
-
downloadListener
DownListener downloadListener() -
addMsgConvertor
- 参数:
msgConvertor- JSON 服务- 返回:
- Builder
- 从以下版本开始:
- v2.0.0 添加消息转换器
-
clearMsgConvertors
HTTP.Builder clearMsgConvertors()清空消息转换器- 返回:
- Builder
- 从以下版本开始:
- v2.5.0
-
msgConvertors
MsgConvertor[] msgConvertors() -
charset
- 参数:
charset- 编码- 返回:
- Builder
- 从以下版本开始:
- v2.0.0 设置默认编码格式
-
charset
Charset charset() -
bodyType
- 参数:
bodyType- 请求体类型- 返回:
- Builder
- 从以下版本开始:
- v2.0.0 设置默认请求体类型
-
bodyType
String bodyType() -
downloadHelper
- 参数:
resolver- 解析器- 返回:
- Builder
- 从以下版本开始:
- v3.4.2 设置下载文件名解析器
-
downloadHelper
DownloadHelper downloadHelper() -
build
HTTP build()构建 HTTP 实例- 返回:
- HTTP
-