主要改进: 1. 响应模型 List 默认值 - 为响应模型的 List 类型添加 @JsonKey(defaultValue: []) - 请求模型不添加默认值,避免影响后端接收 2. ModelUsageType 模型分类 - 新增 ModelUsageType 枚举(request/response/common/unknown) - 通过解析 Swagger 文档的 paths 自动判定模型用途 - 更准确地区分请求参数和返回结果 3. api_models 目录结构优化 - enums/ - 枚举类型 - request/ - 请求模型 - result/ - 响应模型 - parameters/ - 查询参数类 - 每个子目录生成 index.dart 便于导入 4. 导入策略优化 - API 文件统一使用 import '../../api_models/index.dart' - 利用 Dart tree-shaking,不影响应用大小 - 简化导入管理,提高可维护性 5. 多版本 API 支持 - 支持多个 Swagger 文档 URL(v1/v2/v3...) - API 文件按版本分目录(api/v1/、api/v2/) - V1 版本类名不加后缀(如 MobileManagerApi) - V2+ 版本类名添加版本号后缀(如 MobileManagerApiV2) - 每个版本目录生成 index.dart - ApiClient 提供显式版本访问器 配置变更: - SwaggerConfig.swaggerJsonUrls 支持多个 URL |
||
|---|---|---|
| .. | ||
| swagger_data_parser.dart | ||