智能客服
你问我答，随时在线为你解决问题
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
HttpClient.Builder
本文导读
Class Info |
|---|
public static final class HttpClient.Builder extends IHttpClientBuilder HttpClient构造器。 |
Public Constructor Summary
Constructor Name |
|---|
public HttpClient.Builder() 默认的构造方法。 |
Public Method Summary
Qualifier and Type | Method Name and Description |
|---|---|
public @CheckReturnValue HttpClient.Builder | addInterceptor(Interceptor interceptor) 添加应用拦截器。 |
public @CheckReturnValue HttpClient.Builder | addNetworkInterceptor(Interceptor interceptor) 添加网络拦截器。 |
public HttpClient | build() 构造HttpClient实例。 |
public @CheckReturnValue HttpClient.Builder | cache(String directory, long maxSize) 设置响应缓存的配置参数。 |
public @CheckReturnValue HttpClient.Builder | callTimeout(int callTimeout) 配置请求超时时间。 |
public @CheckReturnValue HttpClient.Builder | connectTimeout(int connectTimeout) 配置连接超时时间。 |
public @CheckReturnValue HttpClient.Builder | enableQuic(boolean quicEnabled) 配置是否开启QUIC协议，默认不开启。 |
public @CheckReturnValue HttpClient.Builder | hostnameVerifier(HostnameVerifier hostnameVerifier) 配置hostname校验算法。 |
public @CheckReturnValue HttpClient.Builder | options(String options) 配置HttpClient实例的额外配置参数。 |
public @CheckReturnValue HttpClient.Builder | pingInterval(int pingInterval) 配置ping帧探测时间间隔。 |
public @CheckReturnValue HttpClient.Builder | proxy(Proxy proxy) 配置代理，支持DIRECT（直连，不使用代理）、HTTP（HTTP、FTP等代理）和SOCKS（V4、V5）代理模式。 |
public @CheckReturnValue HttpClient.Builder | readTimeout(int readTimeout) 配置读超时时间。 |
public @CheckReturnValue HttpClient.Builder | retryTimeOnConnectionFailure(int retryTimeOnConnectionFailure) 配置请求重试次数。 |
public @CheckReturnValue HttpClient.Builder | sslSocketFactory(SSLSocketFactory sslSocketFactory, X509TrustManager trustManager) 配置HTTPS证书校验相关参数。 |
public @CheckReturnValue HttpClient.Builder | writeTimeout(int writeTimeout) 配置写超时时间。 |
Methods Inherited from IHttpClientBuilder |
|---|
addInterceptor, addNetworkInterceptor, connectTimeout, readTimeout, retryTimeOnConnectionFailure, callTimeout, pingInterval, writeTimeout, sslSocketFactory, hostnameVerifier, enableQuic, options, proxy, cache |
Public Constructors
HttpClient.Builder
Constructor |
|---|
public HttpClient.Builder() 默认的构造方法。 |
Public Methods
addInterceptor
Method |
|---|
public @CheckReturnValue HttpClient.Builder addInterceptor(Interceptor interceptor) 添加应用拦截器，在请求发起之前调用，一次调用只执行一次拦截处理。 |
Parameters
Name | Description |
|---|---|
interceptor | 应用拦截器。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
addNetworkInterceptor
Method |
|---|
public @CheckReturnValue HttpClient.Builder addNetworkInterceptor(Interceptor interceptor) 添加网络拦截器，每次请求重试均会执行拦截处理。 |
Parameters
Name | Description |
|---|---|
interceptor | 网络拦截器。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
cache
Method |
|---|
public @CheckReturnValue HttpClient.Builder cache(String directory, long maxSize) 设置响应缓存的配置参数。 |
Parameters
Name | Description |
|---|---|
directory | 缓存文件名，存放至“/data/data/包名/cache/”目录下。 |
maxSize | 所有缓存文件的最大字节数，超过此限制则触发LRU（Least Recently Used）算法机制，删除缓存文件。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
callTimeout
Method |
|---|
public @CheckReturnValue HttpClient.Builder callTimeout(int callTimeout) 配置请求超时时间。当您使用全双工模式时，不应设置此参数。 |
Parameters
Name | Description |
|---|---|
callTimeout | 请求超时时间，单位：ms，默认值为0（请求超时能力不生效）。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
connectTimeout
Method |
|---|
public @CheckReturnValue HttpClient.Builder connectTimeout(int connectTimeout) 配置连接超时时间。在请求的三次握手阶段，若超过这个时间间隔仍未收到任何建立连接的响应报文，则抛出连接超时中断请求。 |
Parameters
Name | Description |
|---|---|
connectTimeout | 连接超时时间，单位：ms，默认值为10000。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
enableQuic
Method |
|---|
public @CheckReturnValue HttpClient.Builder enableQuic(boolean quicEnabled) 配置是否开启QUIC协议，默认不开启。 |
Parameters
Name | Description |
|---|---|
quicEnabled | 是否开启QUIC协议，一旦开启，通过此HttpClient实例发起的请求会遵循全局添加的addQuicHint接口描述进行网络通信。默认值为false。
|
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
hostnameVerifier
Method |
|---|
public @CheckReturnValue HttpClient.Builder hostnameVerifier(HostnameVerifier hostnameVerifier) 设置hostname校验算法。 |
Parameters
Name | Description |
|---|---|
hostnameVerifier | hostname校验类。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
options
Method |
|---|
public @CheckReturnValue HttpClient.Builder options(String options) 配置HttpClient实例的额外配置参数。采用JSON格式。 |
Parameters
Name | Description |
|---|---|
options | 额外的配置信息，使用JSON格式。例如：{"disable_weaknetwork_retry":true}。支持参数请参见options。 |
options | Description |
|---|---|
disable_weaknetwork_retry | 设置是否开启弱网重试，boolean类型。默认值为true。
|
concurrent_connect_delay | 设置复合建链的超时时长，单位：ms，int类型。默认值为500。
|
enable_concurrent_connect | 设置是否开启复合建链，boolean类型。默认值为true。
|
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
pingInterval
Method |
|---|
public @CheckReturnValue HttpClient.Builder pingInterval(int pingInterval) 配置ping帧探测时间间隔，默认值为0（不开启帧探测特性）。仅Http/2.0协议生效，每隔这个间隔向服务器发送ping帧，若出现假连接问题则及时拆链，避免无效时间等待。 |
Parameters
Name | Description |
|---|---|
pingInterval | ping帧探测时间间隔，单位：ms。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
proxy
Method |
|---|
public @CheckReturnValue HttpClient.Builder proxy(Proxy proxy) 配置代理，支持DIRECT（直连，不使用代理）、HTTP（HTTP、FTP等代理）和SOCKS（V4、V5）代理模式。一旦调用了该方法指定了代理服务器，那么通过该对象发起的请求都会访问指定的代理服务器。 |
Parameters
Name | Description |
|---|---|
proxy | 代理属性设置，包含代理方式、代理Host和端口。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
readTimeout
Method |
|---|
public @CheckReturnValue HttpClient.Builder readTimeout(int readTimeout) 配置读超时时间。读服务器响应数据时，若超过这个时间间隔还未收到任何服务器数据，则抛出超时异常中断请求。 |
Parameters
Name | Description |
|---|---|
readTimeout | 读超时时间，单位：ms，默认值为10000。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
retryTimeOnConnectionFailure
Method |
|---|
public @CheckReturnValue HttpClient.Builder retryTimeOnConnectionFailure(int retryTimeOnConnectionFailure) 配置请求重试次数。 |
Parameters
Name | Description |
|---|---|
retryTimeOnConnectionFailure | 请求重试次数，默认值为1。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
sslSocketFactory
Method |
|---|
public @CheckReturnValue HttpClient.Builder sslSocketFactory(SSLSocketFactory sslSocketFactory, X509TrustManager trustManager) 配置HTTPS证书校验相关参数。 |
Parameters
Name | Description |
|---|---|
sslSocketFactory | SSL证书校验类工厂。 |
trustManager | 证书信任管理器类。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
writeTimeout
Method |
|---|
public @CheckReturnValue HttpClient.Builder writeTimeout(int writeTimeout) 配置写超时时间。写服务器请求数据时，若超过这个时间间隔没有任何数据写入服务器，则抛出超时异常中断请求。 |
Parameters
Name | Description |
|---|---|
writeTimeout | 写超时时间，单位：ms，默认值为10000。 |
Returns
Type | Description |
|---|---|
HttpClient.Builder | HttpClient构造器。 |
在 API参考 中进行搜索
请输入您想要搜索的关键词