w_tools_api 1.0.0

w_tools 的网络层：基于 Dio 提供多客户端注册、日志与 Token 拦截器、统一错误处理及 Repository 基类，可按域名管理多个客户端。

w_tools_api

w_tools_api 是 w_tools 的网络层，基于 Dio 提供多客户端注册、日志与 Token 拦截器、统一错误处理及 Repository 基类。

特性

• 多客户端管理：DioRegistry 按 baseUrl 缓存并复用 Dio 实例
• 拦截器：WLogInterceptor 日志、WTokenInterceptor Token 注入与 401 刷新
• 配置收敛：WApiConfig 提供默认 BaseOptions
• Repository 基类：BaseRepository 统一请求入口
• 路径契约：IApiPath 供业务实现基础 URL

安装

dependencies:
  w_tools_api: ^1.0.0

flutter pub get

本包最低要求 Flutter 3.27.0。

快速开始

import 'package:w_tools_api/w_tools_api.dart';

final registry = DioRegistry.forBaseUrl(
  'https://api.example.com',
  interceptors: [
    WLogInterceptor(),
  ],
);

final response = await registry.dio.get('/users');

释放实例：

DioRegistry.dispose('https://api.example.com');

主要 API

能力	入口
Dio 注册表	DioRegistry.forBaseUrl / dispose / clearCache
默认配置	WApiConfig.baseOptions
日志拦截	WLogInterceptor
Token 拦截	WTokenInterceptor
Repository	BaseRepository
路径契约	IApiPath / ApiClientId

License

MIT