http_util library

Classes

AgreementWebViewPage
协议 WebView 页面
ApiResponse<T>
ApiResponse 实现示例 这是一个可选的实现示例,展示如何继承 Response 抽象类 用户可以根据自己的需求创建自己的响应类
ChainResult<M, R>
链式调用结果包装类 用于在链路中同时传递提取的对象和响应
DeduplicationConfig
请求去重/防抖配置
DownloadResponse<T>
文件下载响应 用于表示文件下载的结果
hm
HTTP 请求方法常量
HttpConfig
HTTP 工具类配置 用于配置请求头、错误处理等
HttpUtil
HTTP 请求工具类 基于 Dio 封装,支持配置化的请求头注入
HttpUtilWithLoading
带加载提示的 HttpUtil 包装类 用于链式调用,自动管理整个链路的加载提示
LogInterceptor
日志拦截器 用于打印 HTTP 请求和响应的详细信息
PathBasedResponseParser
路径匹配解析器 根据请求路径选择不同的解析器
PathMatcher
路径匹配规则 用于根据请求路径选择不同的解析器
PrivacyAgreementConfig
隐私协议弹窗配置
PrivacyAgreementDialog
隐私协议弹窗
PrivacyAgreementHelper
隐私协议辅助类
PrivacyGate
隐私协议门控:未同意前不构建 child
QueueConfig
请求队列配置
QueueStatus
队列状态
RawHttpResponse
原始 HTTP 响应(包内封装,不暴露底层实现) 解析器仅依赖此类型,调用方无需依赖 Dio
RequestDeduplicator
请求去重/防抖管理器 用于防止相同请求并发发送多次
RequestQueue
请求队列管理器 用于管理请求队列、优先级和并发数限制
Response<T>
响应接口 用户必须实现此接口来定义自己的响应结构
ResponseParser
响应解析器接口 用户必须实现此接口来定义如何将原始 HTTP 响应转换为用户定义的 Response
SSEClient
SSE 客户端 用于建立和维护 Server-Sent Events 连接
SSEConnection
SSE 连接封装类 自动管理订阅和资源清理,简化使用
SSEEvent
Server-Sent Events (SSE) 事件模型
SSEManager
SSE 连接管理器 用于管理多个 SSE 连接,支持同时维护多个连接
StandardResponseParser
标准响应解析器 处理标准结构:{code: int, message: String, data: dynamic}
UnauthorizedRetryConfig
登录态失效后的「刷新 token + 自动重试原请求」策略(包内不写死任何业务码或路径)。
UploadFile
上传文件信息 用于封装文件上传所需的参数

Enums

DeduplicationMode
请求去重模式
LogMode
日志打印模式

Extensions

ExtractedValueExtension on Future<M?>
提取后的对象链式调用扩展 支持在提取对象后继续链式调用,对象在链路中传递
FutureChainResultExtension on Future<ChainResult<M, R>>
Future<ChainResult<M, R>> 扩展方法 支持在 ChainResult 的 Future 上继续链式调用
FutureResponseExtension on Future<Response<T>>
Future<Response
HttpUtilFileDownload on HttpUtil
HttpUtil 文件下载扩展方法
HttpUtilFileUpload on HttpUtil
HttpUtil 文件上传扩展方法
HttpUtilLoadingExtension on HttpUtil
HttpUtil 扩展方法:提供 isLoading getter
HttpUtilSafeCall on HttpUtil
HttpUtil 扩展方法 提供安全调用方法,自动处理异常和错误提示
HttpUtilSSE on HttpUtil
HttpUtil SSE 扩展方法

Properties

http HttpUtil
全局 HTTP 请求实例(简化调用) 使用方式:http.send(method: hm.post, path: '/api/user', ...) 注意:使用前必须先调用 HttpUtil.configure() 进行配置
final