test: 添加测试资源文件
📦 测试资源
- swagger_v3.json: v3 API 测试用的 Swagger 文档
- test_generator_config.yaml: 测试配置文件
这些文件用于支持参数类型生成相关的测试
This commit is contained in:
parent
dd9b74f19b
commit
3015bdb19b
|
|
@ -0,0 +1,660 @@
|
|||
{
|
||||
"openapi": "3.0.1",
|
||||
"info": {
|
||||
"title": "OA移动端Api",
|
||||
"version": "v3"
|
||||
},
|
||||
"paths": {
|
||||
"/api/v3/WorkStatistics/TestImToMQ": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "testIM",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "imToUserId",
|
||||
"in": "query",
|
||||
"description": "",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int64"
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/v3/WorkStatistics/WorkDataStatisticsCount": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "工作数量数据统计",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "BeginTime",
|
||||
"in": "query",
|
||||
"description": "开始时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "EndTime",
|
||||
"in": "query",
|
||||
"description": "结束时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/WorkDataStatisticsCountViewDto"
|
||||
}
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/WorkDataStatisticsCountViewDto"
|
||||
}
|
||||
}
|
||||
},
|
||||
"text/json": {
|
||||
"schema": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/WorkDataStatisticsCountViewDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/v3/WorkStatistics/CloudSchoolWorkDataStatistics": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "各云校统计（总部长才有）",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "TaskTypeEnum",
|
||||
"in": "query",
|
||||
"description": "任务类型枚举",
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "BeginTime",
|
||||
"in": "query",
|
||||
"description": "开始时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "EndTime",
|
||||
"in": "query",
|
||||
"description": "结束时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/CloudSchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/CloudSchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"text/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/CloudSchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/v3/WorkStatistics/SchoolWorkDataStatistics": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "学校统计",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "TaskTypeEnum",
|
||||
"in": "query",
|
||||
"description": "任务类型枚举",
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "SeacherKey",
|
||||
"in": "query",
|
||||
"description": "学校名称搜索",
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "CloudSchoolId",
|
||||
"in": "query",
|
||||
"description": "总部长统计页面-各云校统计页面跳转需要传",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int64",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "BeginTime",
|
||||
"in": "query",
|
||||
"description": "开始时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "EndTime",
|
||||
"in": "query",
|
||||
"description": "结束时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"text/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SchoolWorkDataStatisticsViewDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/v3/WorkStatistics/LearningOfficerWorkDataStatistics": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "学习官统计",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "TaskTypeEnum",
|
||||
"in": "query",
|
||||
"description": "任务类型枚举",
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "SeacherKey",
|
||||
"in": "query",
|
||||
"description": "学习官名称搜索",
|
||||
"schema": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "SchoolId",
|
||||
"in": "query",
|
||||
"description": "学校ID",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int64"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "BeginTime",
|
||||
"in": "query",
|
||||
"description": "开始时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "EndTime",
|
||||
"in": "query",
|
||||
"description": "结束时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/LearningOfficerWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/LearningOfficerWorkDataStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"text/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/LearningOfficerWorkDataStatisticsViewDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"/api/v3/WorkStatistics/WorkDataDetailsStatistics": {
|
||||
"get": {
|
||||
"tags": [
|
||||
"WorkStatistics"
|
||||
],
|
||||
"summary": "统计详细",
|
||||
"parameters": [
|
||||
{
|
||||
"name": "TaskTypeEnum",
|
||||
"in": "query",
|
||||
"description": "任务类型枚举",
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "UserId",
|
||||
"in": "query",
|
||||
"description": "学习官ID",
|
||||
"schema": {
|
||||
"type": "integer",
|
||||
"format": "int64"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "BeginTime",
|
||||
"in": "query",
|
||||
"description": "开始时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "EndTime",
|
||||
"in": "query",
|
||||
"description": "结束时间 格式 yyyy-MM-dd",
|
||||
"schema": {
|
||||
"type": "string",
|
||||
"format": "date-time",
|
||||
"nullable": true
|
||||
}
|
||||
}
|
||||
],
|
||||
"responses": {
|
||||
"200": {
|
||||
"description": "OK",
|
||||
"content": {
|
||||
"text/plain": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/WorkDataDetailsStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"application/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/WorkDataDetailsStatisticsViewDto"
|
||||
}
|
||||
},
|
||||
"text/json": {
|
||||
"schema": {
|
||||
"$ref": "#/components/schemas/WorkDataDetailsStatisticsViewDto"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"components": {
|
||||
"schemas": {
|
||||
"CloudSchoolWorkDataStatisticsDetailsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"cloudSchoolName": {
|
||||
"type": "string",
|
||||
"description": "云校名称"
|
||||
},
|
||||
"cloudSchoolId": {
|
||||
"type": "integer",
|
||||
"description": "云校ID",
|
||||
"format": "int64"
|
||||
},
|
||||
"workCount": {
|
||||
"type": "integer",
|
||||
"description": "工作数量",
|
||||
"format": "int32"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"CloudSchoolWorkDataStatisticsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"taskTypeEnum": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
},
|
||||
"taskTypeName": {
|
||||
"type": "string",
|
||||
"description": "任务类型中文"
|
||||
},
|
||||
"beginTime": {
|
||||
"type": "string",
|
||||
"description": "统计开始时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"endTime": {
|
||||
"type": "string",
|
||||
"description": "统计结束时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"details": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/CloudSchoolWorkDataStatisticsDetailsViewDto"
|
||||
},
|
||||
"description": "云校数据"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"LearningOfficerWorkDataStatisticsDetailsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"userId": {
|
||||
"type": "integer",
|
||||
"description": "学习官ID",
|
||||
"format": "int64"
|
||||
},
|
||||
"realName": {
|
||||
"type": "string",
|
||||
"description": "学习官名称"
|
||||
},
|
||||
"workCount": {
|
||||
"type": "integer",
|
||||
"description": "工作数量",
|
||||
"format": "int32"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"LearningOfficerWorkDataStatisticsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"taskTypeEnum": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
},
|
||||
"taskTypeName": {
|
||||
"type": "string",
|
||||
"description": "任务类型中文"
|
||||
},
|
||||
"beginTime": {
|
||||
"type": "string",
|
||||
"description": "统计开始时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"endTime": {
|
||||
"type": "string",
|
||||
"description": "统计结束时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"schoolName": {
|
||||
"type": "string",
|
||||
"description": "学校名称"
|
||||
},
|
||||
"details": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/LearningOfficerWorkDataStatisticsDetailsViewDto"
|
||||
},
|
||||
"description": "学习官统计数据"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"SchoolWorkDataStatisticsDetailsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"schoolName": {
|
||||
"type": "string",
|
||||
"description": "学校名称"
|
||||
},
|
||||
"schoolId": {
|
||||
"type": "integer",
|
||||
"description": "学校ID",
|
||||
"format": "int64"
|
||||
},
|
||||
"workCount": {
|
||||
"type": "integer",
|
||||
"description": "工作数量",
|
||||
"format": "int32"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"SchoolWorkDataStatisticsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"taskTypeEnum": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
},
|
||||
"taskTypeName": {
|
||||
"type": "string",
|
||||
"description": "任务类型中文"
|
||||
},
|
||||
"beginTime": {
|
||||
"type": "string",
|
||||
"description": "统计开始时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"endTime": {
|
||||
"type": "string",
|
||||
"description": "统计结束时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"cloudSchoolName": {
|
||||
"type": "string",
|
||||
"description": "云校名称"
|
||||
},
|
||||
"details": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/SchoolWorkDataStatisticsDetailsViewDto"
|
||||
},
|
||||
"description": "学校统计数据"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"SysTaskTypeEnums": {
|
||||
"enum": [
|
||||
1,
|
||||
2,
|
||||
3,
|
||||
4,
|
||||
5,
|
||||
6,
|
||||
7,
|
||||
8,
|
||||
9,
|
||||
10,
|
||||
11,
|
||||
12,
|
||||
13
|
||||
],
|
||||
"type": "integer",
|
||||
"description": "任务类型枚举",
|
||||
"format": "int32"
|
||||
},
|
||||
"WorkDataDetailsStatisticsDetailsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "integer",
|
||||
"description": "任务ID",
|
||||
"format": "int64"
|
||||
},
|
||||
"classesId": {
|
||||
"type": "integer",
|
||||
"description": "备 注:班级id（班级任务）\r\n默认值:",
|
||||
"format": "int64",
|
||||
"nullable": true
|
||||
},
|
||||
"classesName": {
|
||||
"type": "string",
|
||||
"description": "备 注:班级名称（班级任务）\r\n默认值:",
|
||||
"nullable": true
|
||||
},
|
||||
"startTime": {
|
||||
"type": "string",
|
||||
"description": "备 注:任务开始时间\r\n默认值:",
|
||||
"format": "date-time"
|
||||
},
|
||||
"endTime": {
|
||||
"type": "string",
|
||||
"description": "备 注:任务结束时间\r\n默认值:",
|
||||
"format": "date-time"
|
||||
},
|
||||
"taskTitleSuffix": {
|
||||
"type": "string",
|
||||
"description": "备 注:任务标题后缀，用于展示\r\n默认值:"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"WorkDataDetailsStatisticsViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"taskTypeEnum": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
},
|
||||
"taskTypeName": {
|
||||
"type": "string",
|
||||
"description": "任务类型中文"
|
||||
},
|
||||
"beginTime": {
|
||||
"type": "string",
|
||||
"description": "统计开始时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"endTime": {
|
||||
"type": "string",
|
||||
"description": "统计结束时间 格式yyyy-MM-dd"
|
||||
},
|
||||
"realName": {
|
||||
"type": "string",
|
||||
"description": "学习官名称-统计对象"
|
||||
},
|
||||
"details": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/components/schemas/WorkDataDetailsStatisticsDetailsViewDto"
|
||||
},
|
||||
"description": "任务详细"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false
|
||||
},
|
||||
"WorkDataStatisticsCountViewDto": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"taskTypeEnum": {
|
||||
"$ref": "#/components/schemas/SysTaskTypeEnums"
|
||||
},
|
||||
"taskTypeName": {
|
||||
"type": "string",
|
||||
"description": "任务类型中文"
|
||||
},
|
||||
"workCount": {
|
||||
"type": "integer",
|
||||
"description": "工作数量",
|
||||
"format": "int32"
|
||||
}
|
||||
},
|
||||
"additionalProperties": false,
|
||||
"description": "工作数量数据统计结果"
|
||||
}
|
||||
},
|
||||
"securitySchemes": {
|
||||
"Bearer": {
|
||||
"type": "apiKey",
|
||||
"description": "在下框中输入请求头中需要添加Jwt授权Token：Bearer {Token}，注意中间有空格",
|
||||
"name": "Authorization",
|
||||
"in": "header"
|
||||
}
|
||||
}
|
||||
},
|
||||
"security": [
|
||||
{
|
||||
"Bearer": [ ]
|
||||
}
|
||||
],
|
||||
"tags": [
|
||||
{
|
||||
"name": "WorkStatistics",
|
||||
"description": "学习官基础工作统计"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,363 @@
|
|||
# Swagger 代码生成器配置文件模板
|
||||
# 复制此文件到您的项目根目录，重命名为 generator_config.yaml，并根据需要修改
|
||||
|
||||
# 基本配置
|
||||
generator:
|
||||
name: "my_project_generator" # 修改为您的项目生成器名称
|
||||
version: "1.0"
|
||||
author: "Your Name" # 修改为您的名字
|
||||
copyright: "Copyright (C) 2025 Your Company. All rights reserved." # 修改为您的版权信息
|
||||
|
||||
# 输入配置
|
||||
input:
|
||||
# Swagger 文档源配置（支持多版本）
|
||||
swagger_urls:
|
||||
# 简写形式：直接列出 URL
|
||||
- "https://your-api.com/swagger/v1/swagger_v3.json"
|
||||
- "https://your-api.com/swagger/v2/swagger_v3.json"
|
||||
|
||||
# 完整形式：可以控制每个版本的启用状态
|
||||
# - url: "https://your-api.com/swagger/v1/swagger_v3.json"
|
||||
# enabled: true # 可选，是否启用此版本（默认: true）
|
||||
|
||||
# 验证配置
|
||||
validate_schema: true
|
||||
strict_mode: true
|
||||
|
||||
# 输出配置
|
||||
output:
|
||||
# 输出目录（根据您的项目结构修改）
|
||||
base_dir: "./lib/generated"
|
||||
api_dir: "./lib/generated/api"
|
||||
models_dir: "./lib/generated/api_models"
|
||||
|
||||
# 文件命名
|
||||
api_file_suffix: "_api.dart"
|
||||
model_file_suffix: ".dart"
|
||||
|
||||
# 是否按 tag 分组
|
||||
split_by_tags: true
|
||||
|
||||
# 只生成指定 tags 的 API 和模型（可选）
|
||||
# 如果不指定或为空，则生成所有 tags
|
||||
# 如果某个 endpoint 有多个 tags，只要其中一个在列表中就会生成
|
||||
included_tags:
|
||||
# - "User"
|
||||
# - "Pet"
|
||||
# - "Store"
|
||||
|
||||
# 从代码生成中排除指定的 tags
|
||||
# 适用于内部、废弃或不需要的 API
|
||||
# 如果一个 endpoint 的所有 tags 都被排除，则该 endpoint 不会生成
|
||||
excluded_tags:
|
||||
# - "Internal"
|
||||
# - "Deprecated"
|
||||
# - "Legacy"
|
||||
|
||||
# 跳过的目录列表（这些目录下的文件将不会被生成）
|
||||
# 支持相对路径和绝对路径，支持目录名或完整路径
|
||||
ignored_directories:
|
||||
# - "api/v1" # 跳过 v1 版本的 API
|
||||
# - "api_models/request" # 跳过请求模型目录
|
||||
# - "./lib/generated/api/v2" # 跳过特定路径
|
||||
|
||||
# 跳过的文件名列表（这些文件将不会被生成）
|
||||
# 支持精确匹配、通配符匹配和模式匹配
|
||||
ignored_files:
|
||||
# 精确匹配文件名
|
||||
# - "user_api.dart" # 跳过名为 user_api.dart 的文件
|
||||
# - "mobile_manager_api.dart" # 跳过指定文件
|
||||
|
||||
# 通配符匹配（支持前缀和后缀）
|
||||
# - "*_api.dart" # 跳过所有以 _api.dart 结尾的文件
|
||||
# - "user*.dart" # 跳过所有以 user 开头的 .dart 文件
|
||||
# - "*manager*" # 跳过所有包含 manager 的文件名
|
||||
|
||||
# 示例：跳过所有 v1 版本的 API 文件
|
||||
# - "*_api_v1.dart"
|
||||
# - "*V1*.dart"
|
||||
|
||||
# 代码生成配置
|
||||
generation:
|
||||
# API 接口配置
|
||||
api:
|
||||
enabled: true
|
||||
use_retrofit: true
|
||||
use_dio: true
|
||||
parser: "JsonSerializable"
|
||||
|
||||
# API Client 配置
|
||||
# 主 API 客户端类的名称和文件名配置
|
||||
client:
|
||||
class_name: "ApiClient" # API 客户端类名（默认: ApiClient）
|
||||
file_name: "api_client" # API 客户端文件名（默认: api_client，不含 .dart 后缀）
|
||||
|
||||
# 版本提取配置（多版本支持）
|
||||
version_extraction:
|
||||
# 版本提取正则表达式模式
|
||||
# 默认: "/api/v(\\d+)/" 匹配 /api/v1/, /api/v2/ 等
|
||||
pattern: "/api/v(\\d+)/"
|
||||
|
||||
# 默认版本（当无法从路径提取版本时使用）
|
||||
default_version: "v1"
|
||||
|
||||
# 基础类型配置（根据您的项目调整）
|
||||
# 如果您的项目有统一的响应模型，请在此处配置
|
||||
base_result_type: "BaseResult" # 基础响应模型名称
|
||||
base_page_result_type: "BasePageResult" # 分页响应模型名称
|
||||
|
||||
# 基础模型的导入路径（可选）
|
||||
# 如果提供了路径，将在 api_models/index.dart 中自动导出
|
||||
# 如果留空，则不会生成导出语句
|
||||
base_result_import: "" # 例如: "package:your_project/common/models/base_result.dart"
|
||||
base_page_result_import: "" # 例如: "package:your_project/common/models/base_page_result.dart"
|
||||
|
||||
# 方法命名
|
||||
method_naming: "camelCase" # camelCase, snake_case
|
||||
|
||||
# 数据模型配置
|
||||
models:
|
||||
enabled: true
|
||||
use_json_serializable: true
|
||||
|
||||
# JsonSerializable 配置
|
||||
json_serializable:
|
||||
checked: true
|
||||
include_if_null: false
|
||||
explicit_to_json: true
|
||||
|
||||
# 类命名
|
||||
class_naming: "PascalCase" # PascalCase, snake_case
|
||||
field_naming: "camelCase" # camelCase, snake_case
|
||||
|
||||
# 构造函数配置
|
||||
use_const_constructor: true
|
||||
required_for_non_nullable: true
|
||||
|
||||
# 枚举键名映射配置（可选）
|
||||
# 用于为枚举值定义有意义的键名和描述
|
||||
# 优先级：配置文件映射 > x-enum-varnames > 智能生成
|
||||
#
|
||||
# 使用场景：
|
||||
# 1. 后端不支持 x-enum-varnames 扩展字段
|
||||
# 2. 需要覆盖 Swagger 文档中的枚举键名
|
||||
# 3. 需要为枚举值添加自定义描述
|
||||
#
|
||||
# 格式:
|
||||
# enum_key_mappings:
|
||||
# 枚举名称:
|
||||
# - value: 枚举值（数字或字符串）
|
||||
# name: 枚举键名（大写下划线命名）
|
||||
# description: 枚举描述（可选）
|
||||
#
|
||||
# 示例:
|
||||
# enum_key_mappings:
|
||||
# SysTaskTypeEnums:
|
||||
# - value: 1
|
||||
# name: SPOT_CHECK
|
||||
# description: 抽查
|
||||
# - value: 2
|
||||
# name: CULTURAL
|
||||
# description: 文创建设
|
||||
# - value: 3
|
||||
# name: CLASS_CADRE_MEETING
|
||||
# description: 班干部会议
|
||||
#
|
||||
# UserStatus:
|
||||
# - value: "active"
|
||||
# name: ACTIVE
|
||||
# description: 活跃用户
|
||||
# - value: "inactive"
|
||||
# name: INACTIVE
|
||||
# description: 非活跃用户
|
||||
# - value: "banned"
|
||||
# name: BANNED
|
||||
# description: 已封禁
|
||||
#
|
||||
enum_key_mappings:
|
||||
# 在此处添加您的枚举映射配置
|
||||
# SysTaskTypeEnums:
|
||||
# - value: 1
|
||||
# name: SPOT_CHECK
|
||||
# description: 抽查
|
||||
# - value: 2
|
||||
# name: CULTURAL
|
||||
# description: 文创建设
|
||||
|
||||
# 类型映射配置
|
||||
type_mapping:
|
||||
# OpenAPI -> Dart 类型映射
|
||||
string: "String"
|
||||
integer: "int"
|
||||
number: "double"
|
||||
boolean: "bool"
|
||||
array: "List"
|
||||
object: "Map<String, dynamic>"
|
||||
|
||||
# 特殊类型处理
|
||||
date: "DateTime"
|
||||
date-time: "DateTime"
|
||||
binary: "Uint8List"
|
||||
|
||||
# 导入管理配置
|
||||
imports:
|
||||
# 按需导入
|
||||
on_demand: true
|
||||
|
||||
# 自动排序
|
||||
auto_sort: true
|
||||
|
||||
# 分组导入
|
||||
group_imports: true
|
||||
|
||||
# 标准库导入
|
||||
dart_imports:
|
||||
- "dart:convert"
|
||||
- "dart:typed_data"
|
||||
|
||||
# 第三方库导入
|
||||
package_imports:
|
||||
- "package:dio/dio.dart"
|
||||
- "package:retrofit/retrofit.dart"
|
||||
- "package:json_annotation/json_annotation.dart"
|
||||
|
||||
# 验证配置
|
||||
validation:
|
||||
# 严格模式
|
||||
strict_mode: true
|
||||
|
||||
# 检查项
|
||||
checks:
|
||||
- "schema_exists"
|
||||
- "ref_resolution"
|
||||
- "type_consistency"
|
||||
- "nullable_correctness"
|
||||
- "required_fields"
|
||||
|
||||
# 错误处理
|
||||
on_error: "warn" # fail, warn, ignore
|
||||
|
||||
# 警告处理
|
||||
on_warning: "log" # fail, log, ignore
|
||||
|
||||
# 优化配置
|
||||
optimization:
|
||||
# 代码优化
|
||||
remove_unused_imports: true
|
||||
optimize_imports: true
|
||||
|
||||
# 性能优化
|
||||
cache_schemas: true
|
||||
parallel_generation: false
|
||||
|
||||
# 内存优化
|
||||
lazy_loading: true
|
||||
|
||||
# 调试配置
|
||||
debug:
|
||||
# 详细日志
|
||||
verbose: false
|
||||
|
||||
# 调试输出
|
||||
debug_output: false
|
||||
|
||||
# 性能监控
|
||||
performance_monitoring: false
|
||||
|
||||
# 生成统计
|
||||
generation_stats: true
|
||||
|
||||
# 兼容性配置
|
||||
compatibility:
|
||||
# Dart 版本
|
||||
dart_version: ">=3.0.0"
|
||||
|
||||
# Flutter 版本
|
||||
flutter_version: ">=3.10.0"
|
||||
|
||||
# 依赖版本
|
||||
dependencies:
|
||||
dio: "^5.0.0"
|
||||
retrofit: "^4.0.0"
|
||||
json_annotation: "^4.8.0"
|
||||
|
||||
dev_dependencies:
|
||||
build_runner: "^2.3.0"
|
||||
retrofit_generator: "^8.0.0"
|
||||
json_serializable: "^6.6.0"
|
||||
|
||||
# 自定义配置
|
||||
custom:
|
||||
# 项目特定配置
|
||||
project_name: "your_project" # 修改为您的项目名称
|
||||
|
||||
# 特殊处理规则
|
||||
special_handling:
|
||||
# 健康检查接口返回 void
|
||||
health_check_paths:
|
||||
- "/health"
|
||||
- "/healthcheck"
|
||||
- "/api/health"
|
||||
|
||||
# 分页接口参数名
|
||||
pagination_params:
|
||||
- "page"
|
||||
- "size"
|
||||
- "limit"
|
||||
- "offset"
|
||||
- "pageIndex"
|
||||
- "pageSize"
|
||||
|
||||
# 忽略的路径
|
||||
ignored_paths:
|
||||
- "/swagger"
|
||||
- "/docs"
|
||||
|
||||
# 忽略的 tags
|
||||
ignored_tags:
|
||||
- "Internal"
|
||||
- "Debug"
|
||||
|
||||
# 模板配置
|
||||
templates:
|
||||
# 文件头模板
|
||||
# 支持模板变量:
|
||||
# {fileName} - 文件名（如 "user_api.dart"）
|
||||
# {fileType} - 文件类型描述（如 "API 接口定义"、"模型定义"）
|
||||
# {swaggerUrl} - Swagger 文档 URL
|
||||
# {generatorName} - 生成器名称（从 generator.name 读取）
|
||||
# {author} - 作者（从 generator.author 读取）
|
||||
# {copyright} - 版权信息（从 generator.copyright 读取）
|
||||
file_header: |
|
||||
// {fileType}
|
||||
// 基于 Swagger API 文档: {swaggerUrl}
|
||||
// 由 {generatorName} by {author} 生成
|
||||
// {copyright}
|
||||
|
||||
# API 类模板
|
||||
# 支持模板变量:
|
||||
# {tagName} - Tag 名称（如 "User"、"Task"）
|
||||
# {className} - 类名（如 "UserApi"、"TaskApi"）
|
||||
api_class: |
|
||||
/// {tagName} API 接口
|
||||
/// 负责处理 {tagName} 相关的接口
|
||||
@RestApi(parser: Parser.JsonSerializable)
|
||||
abstract class {className} {
|
||||
factory {className}(Dio dio, {String? baseUrl}) = _{className};
|
||||
}
|
||||
|
||||
# 模型类模板
|
||||
# 支持模板变量:
|
||||
# {className} - 类名（如 "User"、"Task"）
|
||||
# {constructorParams} - 构造函数参数列表
|
||||
model_class: |
|
||||
@JsonSerializable(checked: true, includeIfNull: false)
|
||||
class {className} {
|
||||
const {className}({constructorParams});
|
||||
|
||||
factory {className}.fromJson(Map<String, dynamic> json) =>
|
||||
_${className}FromJson(json);
|
||||
|
||||
Map<String, dynamic> toJson() => _${className}ToJson(this);
|
||||
}
|
||||
|
||||
Loading…
Reference in New Issue