fix: update import path

Reviewed-on: gateway/api-doc#22

common.go

@@ -9,9 +9,11 @@ package api_doc
 
 import (
 	"fmt"
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/zhangdeman/consts"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/api-doc/enums"
+	"git.zhangdeman.cn/zhangdeman/consts"
 )
 
 // GetUriPathParamList 获取uri参数列表
@@ -47,25 +49,35 @@ func GetUriPathParamList(uriPath string) []*define.ParamConfig {
 // Date : 11:52 2024/12/24
 func GetDataType(docParamType string, formatType string) string {
 	docParamType = strings.ToLower(docParamType)
-	formatType = strings.ToLower(formatType)
+	formatType = strings.ReplaceAll(strings.ToLower(formatType), "interface{}", "any") // 内置支持的类型统一使用any, 不使用 interface{}
 	if len(formatType) == 0 {
 		formatType = docParamType
 	}
+	// format type 和内置的支持数据类型一致, 直接返回对应类型
+	for _, itemType := range consts.DataTypeList {
+		if itemType.Value.String() == formatType {
+			return itemType.Value.String()
+		}
+	}
+
+	// format type 和内置的支持数据类型不一致, 根据文档类型进行转换
 	switch docParamType {
-	case consts.SwaggerDataTypeInteger:
-		if formatType == "int64" {
+	case enums.SwaggerDataTypeInteger.String():
+		if formatType == consts.DataTypeInt.String() {
 			return consts.DataTypeInt.String()
 		}
-		return consts.DataTypeUint.String()
-	case "string", "apikey":
+		return consts.DataTypeInt.String()
+	case enums.SwaggerDataTypeString.String(), enums.SwaggerDataTypeString.String():
 		return consts.DataTypeString.String()
-	case "object":
+	case enums.SwaggerDataTypeObject.String():
 		return consts.DataTypeMapStrAny.String()
-	case "boolean":
+	case enums.SwaggerDataTypeObject.String():
 		return consts.DataTypeBool.String()
-	case "number", "float", "double", "float32", "float64":
-		return consts.DataTypeFloat.String()
-	case "array":
+	case enums.SwaggerDataTypeNumber.String(), "float", "double", "float64":
+		return consts.DataTypeFloat64.String()
+	case "float32":
+		return consts.DataTypeFloat32.String()
+	case enums.SwaggerDataTypeArray.String():
 		if formatType == "integer" {
 			return consts.DataTypeSliceInt.String()
 		} else if formatType == "string" {
@@ -79,22 +91,18 @@ func GetDataType(docParamType string, formatType string) string {
 }
 
 // GetParamLocation 获取参数位置
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:02 2024/12/24
 func GetParamLocation(docParamLocation string) consts.RequestDataLocation {
 	docParamLocation = strings.ToLower(docParamLocation)
 	switch docParamLocation {
-	case "query":
+	case enums.DocParamLocationQuery.String():
 		return consts.RequestDataLocationQuery
-	case "header":
+	case enums.DocParamLocationHeader.String():
 		return consts.RequestDataLocationHeader
-	case "cookie":
+	case enums.DocParamLocationCookie.String():
 		return consts.RequestDataLocationCookie
-	case "body":
+	case enums.DocParamLocationBody.String():
 		return consts.RequestDataLocationBody
-	case "path":
+	case enums.DocParamLocationPath.String():
 		return consts.RequestDataLocationUriPath
 	default:
 		return consts.RequestDataLocationQuery
@@ -103,12 +111,12 @@ func GetParamLocation(docParamLocation string) consts.RequestDataLocation {
 
 // GetRealDefinitionsKey 通过schema下的 $ref 获取真实的 definitions key
 func GetRealDefinitionsKey(ref string) string {
-	return strings.TrimPrefix(ref, "#/definitions/")
+	return strings.TrimPrefix(ref, enums.RefPrefixSchemaDefinition.String())
 }
 
 // GetRealResponseKey 通过schema下的 $ref 获取真实的 response key
 func GetRealResponseKey(ref string) string {
-	return strings.TrimPrefix(ref, "#/responses/")
+	return strings.TrimPrefix(ref, enums.RefPrefixSchemaResponse.String())
 }
 
 // GetSuccessResponseConfig 获取成功的响应配置
@@ -123,7 +131,7 @@ func GetSuccessResponseConfig(resultConfig map[string]*define.SwaggerPathConfigR
 
 // DataTypeIsArray 判断数据类型是否为数组
 func DataTypeIsArray(docDataType string) bool {
-	return strings.ToLower(docDataType) == "array"
+	return strings.ToLower(docDataType) == enums.SwaggerDataTypeArray.String()
 }
 
 // ExpandArrayParam 展开详细的数组配置

define/openapi.go

@@ -7,11 +7,9 @@
 // Date : 2024-04-23 22:16
 package define
 
+import "git.zhangdeman.cn/zhangdeman/api-doc/enums"
+
 // OpenapiDoc openapi文档结构, 文档规范参见 : https://openapi.apifox.cn/
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:16 2024/7/19
 type OpenapiDoc struct {
 	Openapi    string                 `json:"openapi" required:"true"`        // 必选. 这个字符串必须是开放 API 规范版本号提到的符合语义化版本号规范的版本号。openapi字段应该被工具或者客户端用来解释 OpenAPI 文档.
 	Info       *Info                  `json:"info,omitempty" required:"true"` // 必选。此字段提供 API 相关的元数据。相关工具可能需要这个字段。
@@ -22,19 +20,11 @@ type OpenapiDoc struct {
 }
 
 // Components 数据结构定义
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:22 2024/7/19
 type Components struct {
 	Schemas map[string]*Schema `json:"schemas"` // 数据结构定义
 }
 
 // PathConfig ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 18:06 2024/7/19
 type PathConfig struct {
 	Get     *PathItemOperationConfig `json:"get,omitempty"`     // 定义适用于此路径的 GET 操作。
 	Put     *PathItemOperationConfig `json:"put,omitempty"`     // 定义适用于此路径的 PUT 操作。
@@ -51,10 +41,6 @@ type PathConfig struct {
 // 描述对一个路径可执行的有效操作。
 // 依赖与 ACL constraints 的设置，一个Path Item可以是一个空对象，
 // 文档的读者仍然可以看到这个路径，但是他们将无法了解到对这个路径可用的任何操作和参数。
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:22 2024/7/19
 type PathItemConfig struct {
 	Ref         string                 `json:"$ref"`                 // 指定对此路径的外部定义的引用，引用的格式必须符合 Path Item 对象 的格式，如果引用的外部定义和此对象内的其他定义有冲突，该如何处理冲突尚未被定义。
 	Summary     string                 `json:"summary"`              // 一个可选的简要总结字符串，用来描述此路径内包含的所有操作。
@@ -65,10 +51,6 @@ type PathItemConfig struct {
 }
 
 // PathItemOperationConfig 描述对路径的某个操作。
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:20 2024/7/19
 type PathItemOperationConfig struct {
 	Tags         []string               `json:"tags"`                   // 用于控制API文档的标签列表，标签可以用于在逻辑上分组对资源的操作或作为其它用途的先决条件。
 	Summary      string                 `json:"summary"`                // 对此操作行为的简短描述。
@@ -85,20 +67,12 @@ type PathItemOperationConfig struct {
 }
 
 // ExternalDocs 外部文档配置
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:30 2024/7/19
 type ExternalDocs struct {
 	Url         string `json:"url"`         // 必选. 外部文档的URL地址，这个值必须是URL地址格式。
 	Description string `json:"description"` // 对引用的外部文档的简短描述。CommonMark syntax可以被用来呈现富文本格式.
 }
 
 // PathConfigParameter 参数配置
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:29 2024/7/19
 type PathConfigParameter struct {
 	Name            string  `json:"name"`                    // 参数名称
 	In              string  `json:"in"`                      // 必选. 参数的位置，可能的值有 "query", "header", "path" 或 "cookie"。
@@ -114,10 +88,6 @@ type PathConfigParameter struct {
 }
 
 // Schema ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:32 2024/7/19
 type Schema struct {
 	Nullable         bool                 `json:"nullable,omitempty"`           // 对于定义的schema，允许发送 null 值。默认值是 false.
 	Discriminator    *SchemaDiscriminator `json:"discriminator,omitempty"`      // 说白了, 就是一个字段可能是不同的数据结构。。。
@@ -125,13 +95,14 @@ type Schema struct {
 	WriteOnly        bool                 `json:"writeOnly,omitempty"`          // 仅与 Schema "properties" 定义有关。声明此 property 为 "write only"。所以它可以作为 request 的一部分而不应该作为 response 的一部分被发送。如果一个 property 的 writeOnly 被标记为 true 且在 required 列表中，required 将只作用于 request。一个 property 的 readOnly 和 writeOnly 不能同时被标记为 true。默认值是 false。
 	Xml              *XML                 `json:"xml,omitempty"`                // 这只能用于 properties schemas，在root schemas 中没有效果。
 	ExternalDocs     *ExternalDocs        `json:"externalDocs,omitempty"`       // 此 schema 附加的外部文档。
-	Example          string               `json:"example,omitempty"`            // 一个用于示范此 schema实例的示例，可以是任意格式。为了表达无法用 JSON 或 YAML 格式呈现的示例，可以使用 string 类型的值，且在必要的地方需要使用字符转义。
+	Example          any                  `json:"example,omitempty"`            // 一个用于示范此 schema实例的示例，可以是任意格式。为了表达无法用 JSON 或 YAML 格式呈现的示例，可以使用 string 类型的值，且在必要的地方需要使用字符转义。
+	Description      string               `json:"description,omitempty"`        // 一个用于示范此 schema实例的示例，可以是任意格式。为了表达无法用 JSON 或 YAML 格式呈现的示例，可以使用 string 类型的值，且在必要的地方需要使用字符转义。
 	Deprecated       bool                 `json:"deprecated,omitempty"`         // 表示一个 schema 是废弃的，应该逐渐被放弃使用。默认值是 false.
 	Properties       map[string]*Property `json:"properties,omitempty"`         // 数据字段 => 数据规则
 	Required         []string             `json:"required,omitempty"`           // 必传属性列表
 	Enum             []any                `json:"enum,omitempty"`               // 枚举值列表
 	XEnumDescription map[string]string    `json:"x-enumDescriptions,omitempty"` // 枚举值描述的扩展, redoc-free支持
-	Type             string               `json:"type,omitempty"`               // 类型
+	Type             any                  `json:"type,omitempty"`               // 类型 (string | []string)
 	Items            *PropertyXOf         `json:"items,omitempty"`              // items 必须存在如果 type 的值是 array。
 	OneOf            []*PropertyXOf       `json:"oneOf,omitempty"`              // type 是一个对象, allOf 指向对象描述
 	Ref              string               `json:"$ref,omitempty"`               // 类型引用
@@ -144,17 +115,14 @@ type Schema struct {
 }
 
 // Property 是从 JSON Schema 提取出来的，但是做了一些调整以适应 OpenAPI Specification。
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:05 2024/7/19
 type Property struct {
-	Type                 string               `json:"type,omitempty"`                 // 数据类型, swagger本身的定义
+	Type                 any                  `json:"type,omitempty"`                 // 数据类型(string | []string), swagger本身的定义
 	Format               string               `json:"format,omitempty"`               // 对应编程语言中的数据类型描述
 	Enum                 []any                `json:"enum,omitempty"`                 // 枚举值列表
 	XEnumDescription     map[string]string    `json:"x-enumDescriptions,omitempty"`   // 枚举值描述的扩展, redoc-free支持
 	Default              any                  `json:"default,omitempty"`              // 默认值 : 不同于 JSON Schema，这个值必须符合定义与相同级别的 Schema 对象 中定义的类型，比如 type 是 string，那么 default 可以是 "foo" 但不能是 1。
 	Description          string               `json:"description,omitempty"`          // 数据描述, CommonMark syntax可以被用来呈现富文本格式.
+	Example              any                  `json:"example,omitempty"`              // 媒体类型的示例。示例对象应该符合此媒体类型的格式， 这里指定的example对象 object is mutually exclusive of the examples object. 而且如果引用的schema也包含示例，在这里指定的example值将会覆盖schema提供的示例。
 	Maximum              *int64               `json:"maximum,omitempty"`              // 最大值
 	Minimum              *int64               `json:"minimum,omitempty"`              // 最小值
 	MinLength            *int64               `json:"minLength,omitempty"`            // 字符串最小长度
@@ -163,16 +131,12 @@ type Property struct {
 	OneOf                []*PropertyXOf       `json:"oneOf,omitempty"`                // type 是一个对象, allOf 指向对象描述
 	AnyOf                []*PropertyXOf       `json:"anyOf,omitempty"`                // type 是一个对象, allOf 指向对象描述
 	Items                *PropertyXOf         `json:"items,omitempty"`                // items 必须存在如果 type 的值是 array。
-	AdditionalProperties *PropertyXOf         `json:"additionalProperties,omitempty"` // additionalProperties 是一个用于描述模型中包含未在属性列表中定义的额外属性的选项。它允许接受任意的一个或多个键值对。它的作用是为了在模型定义中包含未知或动态属性。通常，在设计 API 时，我们无法预先知道 API 用户会传递什么样的额外属性，这时就可以使用 additionalProperties 功能来灵活地处理这些未知属性。
+	AdditionalProperties any                  `json:"additionalProperties,omitempty"` // additionalProperties(PropertyXOf | bool) 是一个用于描述模型中包含未在属性列表中定义的额外属性的选项。它允许接受任意的一个或多个键值对。它的作用是为了在模型定义中包含未知或动态属性。通常，在设计 API 时，我们无法预先知道 API 用户会传递什么样的额外属性，这时就可以使用 additionalProperties 功能来灵活地处理这些未知属性。
 	Properties           map[string]*Property `json:"properties,omitempty"`           // type = object 时, 定义对象属性
 	Ref                  string               `json:"$ref,omitempty"`                 // 对描述的引用
 }
 
 // PropertyXOf ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:13 2024/7/19
 type PropertyXOf struct {
 	Type    string `json:"type,omitempty"`    // 基础类型
 	Format  string `json:"format,omitempty"`  // 真实类型
@@ -184,20 +148,12 @@ type PropertyXOf struct {
 
 // SchemaDiscriminator 当一个 request bodies 或 response payloads 可以是多种 schemas 时，可以使用一个 discriminator 对象来帮助序列化、反序列化和校验
 // discriminator 属性仅在与 oneOf, anyOf, allOf 这几个复合关键字之一一起使用时才合法.
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:48 2024/7/19
 type SchemaDiscriminator struct {
 	PropertyName string            `json:"propertyName"` // 必选. 在 payload 中表示 discriminator 值的属性的名称。
 	Mapping      map[string]string `json:"mapping"`      // 一个映射 payload 中的值和 schema 名称或引用的对象。
 }
 
 // XML 一个为 XML 模型定义微调过的元数据对象。
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:56 2024/7/19
 type XML struct {
 	Name      string `json:"name"`      // 替换用于描述元素/属性的结构特性的名称。当在 items 内定义时将会影响处于此列表中的每个元素的名称。当定义于 items 之上时将会影响它说包裹的元素且仅当 wrapped 是 true 时，如果 wrapped 是 false 时它将会被忽略
 	Namespace string `json:"namespace"` // 命名空间定义的 URI。其值必须是绝对 URI。
@@ -207,10 +163,6 @@ type XML struct {
 }
 
 // RequestBody 定义请求体
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:17 2024/7/19
 type RequestBody struct {
 	Required    bool              `json:"required"`              // 指定请求体是不是应该被包含在请求中，默认值是false。
 	Description string            `json:"description,omitempty"` // 对请求体的简要描述，可以包含使用示例，CommonMark syntax可以被用来呈现富文本格式
@@ -219,22 +171,14 @@ type RequestBody struct {
 }
 
 // Media 本质即为不一样 content_type 对应的数据结构定义
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:21 2024/7/19
 type Media struct {
 	Schema   *Schema              `json:"schema,omitempty"`   // 定义此媒体类型的结构。
-	Example  string               `json:"example,omitempty"`  // 媒体类型的示例。示例对象应该符合此媒体类型的格式， 这里指定的example对象 object is mutually exclusive of the examples object. 而且如果引用的schema也包含示例，在这里指定的example值将会覆盖schema提供的示例。
+	Example  map[string]any       `json:"example,omitempty"`  // 媒体类型的示例。示例对象应该符合此媒体类型的格式， 这里指定的example对象 object is mutually exclusive of the examples object. 而且如果引用的schema也包含示例，在这里指定的example值将会覆盖schema提供的示例。
 	Examples map[string]*Example  `json:"examples,omitempty"` // 媒体类型的示例，每个媒体对象的值都应该匹配它对应的媒体类型的格式。 The examples object is mutually exclusive of the example object. 而且如果引用的schema也包含示例，在这里指定的example值将会覆盖schema提供的示例。
 	Encoding map[string]*Encoding `json:"encoding,omitempty"` // 属性名与编码信息的映射。每个属性名必须存在于schema属性的key中，当媒体类型等于multipart或application/x-www-form-urlencoded时，编码对象信息仅适用于requestBody。
 }
 
 // Encoding 一个编码定义仅适用于一个结构属性
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:28 2024/7/19
 type Encoding struct {
 	ContentType   string             `json:"content_type,omitempty"`  // 对具体属性的 Content-Type的编码。默认值取决于属性的类型：application/octet-stream编码适用于binary格式的string；text/plain适用于其他原始值；application/json适用于object；对于array值类型的默认值取决于数组内元素的类型，默认值可以是明确的媒体类型(比如application/json), 或者通配符类型的媒体类型(比如image/*), 又或者是用分号分隔的两种媒体类型。
 	Headers       map[string]*Header `json:"headers,omitempty"`       // 提供附加信息的请求头键值对映射。比如Content-Disposition、Content-Type各自描述了不同的信息而且在这里将会被忽略，如果请求体的媒体类型不是multipart，这个属性将会被忽略。
@@ -255,10 +199,6 @@ type Encoding struct {
 type Header PathConfigParameter
 
 // Example ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:24 2024/7/19
 type Example struct {
 	Summary       string `json:"summary,omitempty"`       // example 的简要描述。
 	Description   string `json:"description,omitempty"`   // example 的详细描述。CommonMark syntax可以被用来呈现富文本格式.
@@ -267,10 +207,6 @@ type Example struct {
 }
 
 // Response 响应的数据结构
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:38 2024/7/19
 type Response struct {
 	Description string             `json:"description" required:"true"` // 必选. 对响应的简短描述。CommonMark syntax可以被用来呈现富文本格式.
 	Headers     map[string]*Header `json:"headers,omitempty"`           // 映射HTTP头名称到其定义。RFC7230 规定了HTTP头名称不区分大小写。如果一个响应头使用"Content-Type"作为HTTP头名称，它会被忽略。
@@ -279,10 +215,6 @@ type Response struct {
 }
 
 // Info 信息
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:10 2024/4/19
 type Info struct {
 	Description    string   `json:"description,omitempty"`           // 对应用的简短描述。 CommonMark syntax 可以被用来表示富文本呈现。
 	Title          string   `json:"title,omitempty" required:"true"` // 必选. 应用的名称。
@@ -293,10 +225,6 @@ type Info struct {
 }
 
 // Contact 联系人信息
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:08 2024/4/19
 type Contact struct {
 	Name  string `json:"name,omitempty"`  // 人或组织的名称。
 	Url   string `json:"url,omitempty"`   // 指向联系人信息的 URL 地址，必须是 URL 地址格式。
@@ -304,20 +232,12 @@ type Contact struct {
 }
 
 // License 开源协议
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:09 2024/4/19
 type License struct {
-	Name string `json:"name,omitempty"` // 开源协议名
-	Url  string `json:"url,omitempty"`  // 开源协议地址
+	Name enums.License `json:"name,omitempty"` // 开源协议名
+	Url  string        `json:"url,omitempty"`  // 开源协议地址
 }
 
 // ServerItem server 对象结构
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:18 2024/7/19
 type ServerItem struct {
 	Url         string                         `json:"url,omitempty" required:"true"` // 必选. 指向目标主机的 URL 地址。这个 URL 地址支持服务器变量而且可能是相对路径，表示主机路径是相对于本文档所在的路径。当一个变量被命名为类似{brackets}时需要替换此变量。
 	Description string                         `json:"description,omitempty"`         // 一个可选的字符串，用来描述此 URL 地址。CommonMark syntax可以被用来呈现富文本格式.
@@ -325,10 +245,6 @@ type ServerItem struct {
 }
 
 // ServerItemVariable ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:22 2024/7/19
 type ServerItemVariable struct {
 	Default     string   `json:"default,omitempty"`     // 变量默认值
 	Description string   `json:"description,omitempty"` // 变量描述
@@ -336,10 +252,6 @@ type ServerItemVariable struct {
 }
 
 // TagItem 每一个标签数据结构
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 12:18 2024/7/19
 type TagItem struct {
 	Name        string `json:"name,omitempty"`        // 标签名称
 	Description string `json:"description,omitempty"` // 标签描述

define/parser_api.go

@@ -0,0 +1,56 @@
+// Package parser ...
+//
+// Description : parser ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-04-11 20:21
+package define
+
+// ApiConfig 解析出的接口配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 20:21 2025/4/11
+type ApiConfig struct {
+	Tag         string           `json:"tag" dc:"接口所属标签"`                                                                                // 接口所属标签
+	Name        string           `json:"name" binding:"required,min=1" dc:"接口名称" err:"项目接口名称必须存在,且不能为空"`                    // 接口名称
+	Uri         string           `json:"uri" binding:"required,min=1,max=512" dc:"项目接口uri" err:"项目接口路径必须存在,且长度在[1,512]之间"` // 项目接口路由
+	MethodID    int64            `json:"method_id" dc:"请求方法ID"`                                                                            // 请求方法
+	Method      string           `json:"method" binding:"required_without=MethodID" dc:"请求方法" err:"请求方法与请求方法ID至少存在一个"`
+	ContentType string           `json:"content_type" dc:"请求类型" binding:"required_without=ContentTypeID" err:"请求类型ID与请求类型至少存在一个"`
+	Description string           `json:"description" dc:"项目接口描述"`       // 接口描述
+	ParamList   []*ApiParamItem  `json:"param_list" dc:"项目接口参数列表"`    // 参数列表
+	ResultList  []*ApiResultItem `json:"result_list" dc:"项目接口返回值列表"` // 返回值列表
+}
+
+// ApiParamItem 接口参数配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 20:23 2025/4/11
+type ApiParamItem struct {
+	Title        string `json:"title" binding:"required,min=1" dc:"参数标题" err:"参数标题必须存在,且不能为空"`                                              // 参数标题
+	Name         string `json:"name" binding:"required,min=1" dc:"参数名称" err:"参数名称必须存在,且不能为空"`                                               // 参数名称
+	Location     string `json:"location" binding:"required,oneof=HEADER COOKIE BODY QUERY PATH" dc:"参数位置" err:"参数位置必须存在,且需要是一个有效合法值"` // 参数位置
+	ParamType    string `json:"param_type" binding:"required,validate_data_type" dc:"参数类型" err:"参数类型必须存在,且需要是一个有效的合法值"`              // 参数类型
+	IsRequired   bool   `json:"is_required" binding:"required" dc:"参数是否必传" err:"参数是否必传必须存在,且需要是一个有效合法值"`                          // 是否必传
+	DefaultValue string `json:"default_value" dc:"默认值"`                                                                                                   // 默认值
+	ExampleValue string `json:"example_value" dc:"示例值"`                                                                                                   // 示例值
+	Description  string `json:"description" dc:"参数描述"`                                                                                                   // 参数描述
+}
+
+// ApiResultItem 接口返回值配置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 20:23 2025/4/11
+type ApiResultItem struct {
+	Title        string `json:"title" binding:"required,min=1,max=64" dc:"返回值标题" err:"返回值标题必须存在,且长度在[1,64]之间"`                           // 返回值标题
+	DataPath     string `json:"data_path" binding:"required,min=1,max=512" dc:"返回值路径" err:"返回值路径必须存在,且长度在[1,512]之间"`                     // 返回值路径
+	DataLocation string `json:"data_location" binding:"required,oneof=BODY HEADER COOKIE" dc:"返回值位置" err:"返回值位置必须存在,其需要时一个有效的合法值"` // 返回值位置
+	DataType     string `json:"data_type" binding:"required,validate_data_type" dc:"返回值类型" err:"返回值类型必须存在,且需要是一个有效的合法值"`           // 返回值类型
+	DefaultValue string `json:"default_value" dc:"默认值"`                                                                                                   // 默认值
+	ExampleValue string `json:"example_value" dc:"示例值"`                                                                                                   // 示例值
+	Description  string `json:"description" dc:"返回值描述"`                                                                                                 // 返回值描述
+}

define/seagger_ui.go

@@ -1,15 +0,0 @@
-// Package define ...
-//
-// Description : define ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 2025-02-16 13:18
-package define
-
-const (
-	SwaggerUIThemeDefault   = "swaggerUI"     // 文档默认主题
-	SwaggerUIThemeKnife4go  = "knife4go"      // knife4go 主题
-	SwaggerUIThemeYDocLucky = "ydoc-lucky-ui" // YDoc Lucky UI 主题: https://github.com/NoBugBoy/LuckyUI
-	SwaggerUIThemeRedocFree = "redoc-free"    // redoc UI 主题, 开源免费版: https://github.com/Redocly/redoc
-)

define/tag.go

@@ -29,6 +29,8 @@ const (
 	TagUriTag              = "tag"           // 接口的tag
 	TagOutputStrict        = "output_strict" // 接口数据是否为严格模式 : 严格模式, 响应数据必须是结构体/map，非严格模式返回任意值
 	TagErrMsg              = "err"           // 验证失败错误信息tag
+	TagExample             = "example"       // 示例值
+	TagEg                  = "eg"            // 示例值
 	TagContentType         = "content_type"
 	TagOutputContentType   = "output_content_type"
 	TagNameOmitempty       = "omitempty"

enums/data_location.go

@@ -0,0 +1,22 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 00:34
+package enums
+
+type DocParamLocation string
+
+func (dpl DocParamLocation) String() string {
+	return string(dpl)
+}
+
+const (
+	DocParamLocationQuery  DocParamLocation = "query"
+	DocParamLocationHeader DocParamLocation = "header"
+	DocParamLocationCookie DocParamLocation = "cookie"
+	DocParamLocationBody   DocParamLocation = "body"
+	DocParamLocationPath   DocParamLocation = "path"
+)

enums/data_type.go

@@ -0,0 +1,46 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-22 23:58
+package enums
+
+import (
+	"strings"
+)
+
+type SwaggerDataType string
+
+func (sdt SwaggerDataType) String() string {
+	return string(sdt)
+}
+
+// MarshalJSON 支持序列化
+func (sdt SwaggerDataType) MarshalJSON() ([]byte, error) {
+	return []byte(`"` + sdt.String() + `"`), nil
+}
+
+// UnmarshalJSON 支持反序列化
+func (sdt *SwaggerDataType) UnmarshalJSON(d []byte) error {
+	*sdt = SwaggerDataType(strings.Trim(string(d), `"`))
+	return nil
+}
+
+const (
+	SwaggerDataTypeInteger  SwaggerDataType = "integer" // 32 位有符号
+	SwaggerDataTypeLong     SwaggerDataType = "long"    // 64 位有符号
+	SwaggerDataTypeFloat    SwaggerDataType = "number"
+	SwaggerDataTypeDouble   SwaggerDataType = "number"
+	SwaggerDataTypeNumber   SwaggerDataType = "number"
+	SwaggerDataTypeByte     SwaggerDataType = "string"
+	SwaggerDataTypeBinary   SwaggerDataType = "binary" // 任意 8 进制序列
+	SwaggerDataTypeString   SwaggerDataType = "string"
+	SwaggerDataTypeDate     SwaggerDataType = "string"
+	SwaggerDataTypePassword SwaggerDataType = "password"
+	SwaggerDataTypeBoolean  SwaggerDataType = "boolean"
+	SwaggerDataTypeArray    SwaggerDataType = "array"
+	SwaggerDataTypeObject   SwaggerDataType = "object"
+	SwaggerDataTypeApiKey   SwaggerDataType = "apikey"
+)

enums/license.go

@@ -0,0 +1,116 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 09:40
+package enums
+
+import (
+	"strings"
+)
+
+type License string
+
+func (l License) String() string {
+	return string(l)
+}
+
+// MarshalJSON 支持序列化
+func (l License) MarshalJSON() ([]byte, error) {
+	return []byte(`"` + l.String() + `"`), nil
+}
+
+// UnmarshalJSON 支持反序列化
+func (l *License) UnmarshalJSON(d []byte) error {
+	*l = License(strings.Trim(string(d), `"`))
+	return nil
+}
+
+const (
+	LicenseAfl30       License = "AFL-3.0"
+	LicenseAgpl30      License = "AGPL-3.0"
+	LicenseApache10    License = "Apache-1.0"
+	LicenseApache11    License = "Apache-1.1"
+	LicenseApache20    License = "Apache-2.0"
+	LicenseArtistic20  License = "Artistic-2.0"
+	LicenseBsd2Clause  License = "BSD-2-Clause"
+	LicenseBsd3Clause  License = "BSD-3-Clause"
+	LicenseBsd4Clause  License = "BSD-4-Clause"
+	LicenseBsl10       License = "BSL-1.0"
+	LicenseCcBy40      License = "CC-BY-4.0"
+	LicenseCcBySa40    License = "CC-BY-SA-4.0"
+	LicenseCc010       License = "CC0-1.0"
+	LicenseEcl20       License = "ECL-2.0"
+	LicenseEpl10       License = "EPL-1.0"
+	LicenseEpl20       License = "EPL-2.0"
+	LicenseEupl11      License = "EUPL-1.1"
+	LicenseEupl12      License = "EUPL-1.2"
+	LicenseGpl20       License = "GPL-2.0"
+	LicenseGpl30       License = "GPL-3.0"
+	LicenseIsc         License = "ISC"
+	LicenseLgpl21      License = "LGPL-2.1"
+	LicenseLgpl30      License = "LGPL-3.0"
+	LicenseLppl13c     License = "LPPL-1.3c"
+	LicenseMit         License = "MIT"
+	LicenseMpl20       License = "MPL-2.0"
+	LicenseMsPl        License = "MS-PL"
+	LicenseMsRl        License = "MS-RL"
+	LicenseMulanpsl10  License = "MulanPSL-1.0"
+	LicenseMulanpubl10 License = "MulanPubL-1.0"
+	LicenseMulanpubl20 License = "MulanPubL-2.0"
+	LicenseNcsa        License = "NCSA"
+	LicenseOfl11       License = "OFL-1.1"
+	LicenseOsl30       License = "OSL-3.0"
+	LicensePostgresql  License = "PostgreSQL"
+	LicenseUpl10       License = "UPL-1.0"
+	LicenseUnlicense   License = "Unlicense"
+	LicenseWtfpl       License = "WTFPL"
+	LicenseZlib        License = "Zlib"
+)
+
+var (
+	// LicenseUrlTable 洗衣链接表
+	LicenseUrlTable = map[License]string{
+		LicenseAfl30:       "https://spdx.org/licenses/AFL-3.0",
+		LicenseAgpl30:      "https://www.gnu.org/licenses/agpl-3.0.txt",
+		LicenseApache10:    "https://www.apache.org/licenses/LICENSE-1.0",
+		LicenseApache11:    "https://www.apache.org/licenses/LICENSE-1.1",
+		LicenseApache20:    "https://www.apache.org/licenses/LICENSE-2.0.txt",
+		LicenseArtistic20:  "https://spdx.org/licenses/Artistic-2.0",
+		LicenseBsd2Clause:  "https://opensource.org/license/BSD-2-Clause",
+		LicenseBsd3Clause:  "https://opensource.org/license/BSD-3-Clause",
+		LicenseBsd4Clause:  "https://directory.fsf.org/wiki/License:BSD-4-Clause",
+		LicenseBsl10:       "https://www.boost.org/LICENSE_1_0.txt",
+		LicenseCcBy40:      "https://creativecommons.org/licenses/by/4.0/legalcode.txt",
+		LicenseCcBySa40:    "https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt",
+		LicenseCc010:       "https://creativecommons.org/publicdomain/zero/1.0/legalcode.txt",
+		LicenseEcl20:       "https://opensource.org/license/ecl-2-0",
+		LicenseEpl10:       "https://www.eclipse.org/org/documents/epl-1.0/EPL-1.0.txt",
+		LicenseEpl20:       "https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt",
+		LicenseEupl11:      "https://joinup.ec.europa.eu/sites/default/files/custom-page/attachment/eupl1.1.-licence-en_0.pdf",
+		LicenseEupl12:      "https://joinup.ec.europa.eu/sites/default/files/custom-page/attachment/eupl_v1.2_en.pdf",
+		LicenseGpl20:       "https://www.gnu.org/licenses/old-licenses/gpl-2.0.html#SEC1",
+		LicenseGpl30:       "https://www.gnu.org/licenses/gpl-3.0.html#license-text",
+		LicenseIsc:         "https://spdx.org/licenses/ISC",
+		LicenseLgpl21:      "https://www.gnu.org/licenses/old-licenses/lgpl-2.1-standalone.html",
+		LicenseLgpl30:      "https://www.gnu.org/licenses/lgpl-3.0-standalone.html",
+		LicenseLppl13c:     "https://www.latex-project.org/lppl/lppl-1-3c.txt",
+		LicenseMit:         "https://spdx.org/licenses/MIT",
+		LicenseMpl20:       "https://www.mozilla.org/en-US/MPL/2.0/",
+		LicenseMsPl:        "https://opensource.org/license/ms-pl-html",
+		LicenseMsRl:        "https://opensource.org/license/ms-rl-html",
+		LicenseMulanpsl10:  "http://license.coscl.org.cn/MulanPSL",
+		LicenseMulanpubl10: "http://license.coscl.org.cn/MulanPubL-1.0",
+		LicenseMulanpubl20: "http://license.coscl.org.cn/MulanPubL-2.0",
+		LicenseNcsa:        "https://spdx.org/licenses/NCSA",
+		LicenseOfl11:       "https://openfontlicense.org/documents/OFL.txt",
+		LicenseOsl30:       "https://opensource.org/license/osl-3-0-php",
+		LicensePostgresql:  "https://www.postgresql.org/about/licence/",
+		LicenseUpl10:       "https://spdx.org/licenses/UPL-1.0",
+		LicenseUnlicense:   "https://unlicense.org/",
+		LicenseWtfpl:       "https://spdx.org/licenses/WTFPL",
+		LicenseZlib:        "https://www.zlib.net/zlib_license.html",
+	}
+)

enums/ref.go

@@ -0,0 +1,20 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 00:40
+package enums
+
+// RefPrefix 各种ref引用的前缀定义
+type RefPrefix string
+
+func (rp RefPrefix) String() string {
+	return string(rp)
+}
+
+const (
+	RefPrefixSchemaDefinition RefPrefix = "#/definitions/" // schema下的 $ref 下 definitions 的前缀
+	RefPrefixSchemaResponse   RefPrefix = "#/responses/"   // schema下的 $ref 下 response 的前缀
+)

enums/ui_theme.go

@@ -0,0 +1,21 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 01:03
+package enums
+
+type SwaggerUITheme string
+
+func (sut SwaggerUITheme) String() string {
+	return string(sut)
+}
+
+const (
+	SwaggerUIThemeDefault   SwaggerUITheme = "swaggerUI"     // 文档默认主题
+	SwaggerUIThemeKnife4go  SwaggerUITheme = "knife4go"      // knife4go 主题
+	SwaggerUIThemeYDocLucky SwaggerUITheme = "ydoc-lucky-ui" // YDoc Lucky UI 主题: https://github.com/NoBugBoy/LuckyUI
+	SwaggerUIThemeRedocFree SwaggerUITheme = "redoc-free"    // redoc UI 主题, 开源免费版: https://github.com/Redocly/redoc
+)

enums/version.go

@@ -0,0 +1,19 @@
+// Package enums ...
+//
+// Description : enums ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 00:50
+package enums
+
+type SwaggerVersion string
+
+func (sv SwaggerVersion) String() string {
+	return string(sv)
+}
+
+const (
+	SwaggerDocVersion2 SwaggerVersion = "2.0"
+	SwaggerDocVersion3 SwaggerVersion = "3.0.0"
+)

geerate_option.go

@@ -0,0 +1,95 @@
+// Package api_doc ...
+//
+// Description : api_doc ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 09:30
+package api_doc
+
+import (
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/api-doc/enums"
+)
+
+// SetGenerateOption 设置文档生成选项
+type SetGenerateOption func(opt *define.OpenapiDoc)
+
+// generateOption 生成文档的一些配置选项
+type generateOption struct {
+	license     enums.License // 文档的license
+	description string        // 文档的描述
+	title       string        // 文档的标题
+}
+
+// WithDocLicense 设置文档协议名称 + 协议链接
+func WithDocLicense(l enums.License) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		if l == "" {
+			return
+		}
+		opt.Info.License.Name = l
+		opt.Info.License.Url = enums.LicenseUrlTable[l]
+	}
+}
+
+// WithDocDescription 设置文档描述
+func WithDocDescription(desc string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		if desc == "" {
+			return
+		}
+		opt.Info.Description = desc
+	}
+}
+
+// WithDocTitle 设置文档标题
+func WithDocTitle(title string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		if len(title) == 0 {
+			return
+		}
+		opt.Info.Title = title
+	}
+}
+
+// WithDocVersion 设置文档版本
+func WithDocVersion(version string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		opt.Info.Version = version
+	}
+}
+
+// WithDocContactName 设置文档联系人名称
+func WithDocContactName(name string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		if name == "" {
+			return
+		}
+		opt.Info.Contact.Name = name
+	}
+}
+
+// WithDocContactEmail 设置文档联系人邮箱
+func WithDocContactEmail(email string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		opt.Info.Contact.Email = email
+	}
+}
+
+// WithDocContactHomePage 设置文档联系人主页
+func WithDocContactHomePage(url string) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		opt.Info.Contact.Url = url
+	}
+}
+
+// WithDocServers 设置文档服务器列表
+func WithDocServers(serverList []*define.ServerItem) SetGenerateOption {
+	return func(opt *define.OpenapiDoc) {
+		if len(serverList) == 0 {
+			return
+		}
+		opt.Servers = serverList
+	}
+}

generate.go

@@ -10,12 +10,14 @@ package api_doc
 import (
 	"errors"
 	"fmt"
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/zhangdeman/consts"
-	"git.zhangdeman.cn/zhangdeman/wrapper"
 	"net/http"
 	"reflect"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/api-doc/enums"
+	"git.zhangdeman.cn/zhangdeman/consts"
+	"git.zhangdeman.cn/zhangdeman/wrapper"
 )
 
 // NewOpenapiDoc ...
@@ -23,48 +25,39 @@ import (
 // Author : go_developer@163.com<白茶清欢>
 //
 // Date : 15:56 2024/7/22
-func NewOpenapiDoc(info *define.Info, servers []*define.ServerItem) *Generate {
-	if nil == info {
-		info = &define.Info{
+func NewOpenapiDoc(ofs ...SetGenerateOption) *Generate {
+	// 初始默认值
+	docCfg := &define.OpenapiDoc{
+		Openapi: consts.SwaggerDocVersion3,
+		Info: &define.Info{
 			Description:    "openapi接口文档",
 			Title:          "openapi接口文档",
 			TermsOfService: "",
-			Contact:        nil,
-			License:        nil,
-			Version:        "0.0.1",
-		}
+			Contact: &define.Contact{
+				Name:  "研发人员(developer)",
+				Url:   "",
+				Email: "",
+			},
+			License: &define.License{
+				Name: enums.LicenseApache20,
+				Url:  enums.LicenseUrlTable[consts.LicenseApache20],
+			},
+			Version: "0.0.1",
+		},
+		Servers:    []*define.ServerItem{},
+		Components: &define.Components{Schemas: map[string]*define.Schema{}},
+		Tags:       make([]*define.TagItem, 0),
+		Paths:      make(map[string]*define.PathConfig),
 	}
-	if len(info.Version) == 0 {
-		info.Version = "0.0.1"
-	}
-	if nil == info.License {
-		info.License = &define.License{
-			Name: consts.LicenseApache20,
-			Url:  consts.LicenseUrlTable[consts.LicenseApache20],
-		}
-	}
-	if nil == info.Contact {
-		info.Contact = &define.Contact{
-			Name:  "研发人员(developer)",
-			Url:   "",
-			Email: "",
-		}
-	}
-	if nil == servers {
-		servers = []*define.ServerItem{}
+
+	for _, option := range ofs {
+		option(docCfg)
 	}
 	return &Generate{
 		readMethodList: []string{
 			http.MethodGet, http.MethodHead, http.MethodConnect, http.MethodOptions, http.MethodTrace,
 		},
-		docData: &define.OpenapiDoc{
-			Openapi:    consts.SwaggerDocVersion3,
-			Info:       info,
-			Servers:    servers,
-			Components: &define.Components{Schemas: map[string]*define.Schema{}},
-			Tags:       make([]*define.TagItem, 0),
-			Paths:      make(map[string]*define.PathConfig),
-		},
+		docData: docCfg,
 	}
 }
 
@@ -82,45 +75,7 @@ func (g *Generate) Doc() *define.OpenapiDoc {
 	return g.docData
 }
 
-// SetLicense 设置文档协议
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:56 2024/8/14
-func (g *Generate) SetLicense(name string, url string) {
-	g.docData.Info.License.Name = name
-	g.docData.Info.License.Url = url
-}
-
-// AddTag 新增tag
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:23 2024/8/14
-func (g *Generate) AddTag(tagName string, tagDesc string) {
-	isHasTag := false
-	for _, item := range g.docData.Tags {
-		if item.Name == tagName {
-			if len(tagDesc) > 0 {
-				item.Description = tagDesc
-			}
-			isHasTag = true
-			break
-		}
-	}
-	if !isHasTag {
-		g.docData.Tags = append(g.docData.Tags, &define.TagItem{
-			Name:        tagName,
-			Description: tagDesc,
-		})
-	}
-}
-
 // AddServer 添加server
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:45 2024/8/14
 func (g *Generate) AddServer(serverDomain string, serverDesc string, serverVariable map[string]*define.ServerItemVariable) {
 	if nil == serverVariable {
 		serverVariable = make(map[string]*define.ServerItemVariable)
@@ -149,35 +104,7 @@ func (g *Generate) AddServer(serverDomain string, serverDesc string, serverVaria
 	}
 }
 
-// AddApi 新增Api
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 15:04 2024/8/14
-//
-// baseCfg : 接口基础配置, 示例数据
-//
-//	&define.UriBaseConfig{
-//			Uri:         "/foo/bar",
-//			Method:      http.MethodPost,
-//			ContentType: ["application/json"],
-//			TagList:     []string{"测试标签"},
-//			Summary:     "这是一份示例基础配置",
-//			Description: "这是一份示例基础配置",
-//		}
-//
-// paramList : 参数列表
-//
-// resultList : 返回值列表
-func (g *Generate) AddApi(baseCfg *define.UriBaseConfig, paramList []*define.ParamConfig, resultList []*define.ResultConfig) error {
-	return nil
-}
-
 // AddApiFromInAndOut 通过请求参数的
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 14:22 2025/2/9
 func (g *Generate) AddApiFromInAndOut(uriPrefix string, paramType reflect.Type, resultType reflect.Type) error {
 	if paramType.Kind() == reflect.Ptr {
 		paramType = paramType.Elem()
@@ -207,7 +134,7 @@ func (g *Generate) AddApiFromInAndOut(uriPrefix string, paramType reflect.Type,
 				Schema: &define.Schema{
 					Ref: g.getSchemaRef(paramSchemaName),
 				},
-				Example:  "",
+				Example:  nil,
 				Examples: nil,
 				Encoding: nil,
 			}
@@ -220,7 +147,7 @@ func (g *Generate) AddApiFromInAndOut(uriPrefix string, paramType reflect.Type,
 			Schema: &define.Schema{
 				Ref: g.getSchemaRef(resultSchemaName),
 			},
-			Example:  "",
+			Example:  nil,
 			Examples: nil,
 			Encoding: nil,
 		}
@@ -260,10 +187,6 @@ func (g *Generate) setApiDoc(baseCfg *define.UriBaseConfig, apiDocCfg *define.Pa
 }
 
 // getApiDocBaseCfg 获取接口文档的基础配置
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:10 2025/2/14
 func (g *Generate) getApiDocBaseCfg(baseCfg *define.UriBaseConfig, paramType reflect.Type) *define.PathItemOperationConfig {
 	cfg := &define.PathItemOperationConfig{
 		Tags:         baseCfg.TagList,
@@ -279,7 +202,7 @@ func (g *Generate) getApiDocBaseCfg(baseCfg *define.UriBaseConfig, paramType ref
 			Ref:         "",
 		},
 		Responses: map[string]*define.Response{
-			fmt.Sprintf("%v", http.StatusOK): &define.Response{
+			fmt.Sprintf("%v", http.StatusOK): {
 				Content: map[string]*define.Media{},
 			},
 		},
@@ -295,12 +218,12 @@ func (g *Generate) getApiDocBaseCfg(baseCfg *define.UriBaseConfig, paramType ref
 			param = strings.TrimSuffix(param, "}")
 			cfg.Parameters = append(cfg.Parameters, &define.PathConfigParameter{
 				Name:        param,
-				In:          consts.SwaggerParameterInPath,
+				In:          enums.DocParamLocationPath.String(),
 				Description: param,
 				Required:    true,
 				Deprecated:  false,
 				Schema: &define.Schema{
-					Type:   consts.SwaggerDataTypeString,
+					Type:   enums.SwaggerDataTypeString.String(),
 					Format: consts.DataTypeString.String(),
 				},
 				AllowEmptyValue: false,
@@ -311,10 +234,6 @@ func (g *Generate) getApiDocBaseCfg(baseCfg *define.UriBaseConfig, paramType ref
 }
 
 // ParseReadConfigParam 解析get类请求参数
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 11:55 2025/2/14
 func (g *Generate) ParseReadConfigParam(requestCfg *define.UriBaseConfig, baseReqCfg *define.PathItemOperationConfig, inputType reflect.Type) {
 	if inputType.Kind() == reflect.Ptr {
 		inputType = inputType.Elem()
@@ -342,13 +261,8 @@ func (g *Generate) ParseReadConfigParam(requestCfg *define.UriBaseConfig, baseRe
 		convertBaseType, isBaseType := g.realBaseType2SwaggerType(inputType.Field(i).Type.String())
 		realInputTypeFormat := inputType.Field(i).Type.String()
 		fieldType := inputType.Field(i).Type
-		/*if inputType.Field(i).Type.Kind() == reflect.Ptr {
-			fieldType = inputType.Field(i).Type.Elem()
-		}*/
 		if isBaseType {
 			// 当做默认基础类型, 默认不会出现 *map *[]
-			minVal := ValidateRule.Minimum(inputType.Field(i))
-			maxVal := ValidateRule.Maximum(inputType.Field(i))
 			itemParam := &define.PathConfigParameter{
 				Name:        propertyName,
 				In:          consts.SwaggerParameterInQuery,
@@ -356,41 +270,32 @@ func (g *Generate) ParseReadConfigParam(requestCfg *define.UriBaseConfig, baseRe
 				Required:    ValidateRule.IsRequired(inputType.Field(i)),
 				Deprecated:  ParseStructFieldTag.Deprecated(inputType.Field(i)),
 				Schema: &define.Schema{
-					Type:             convertBaseType,
-					Format:           realInputTypeFormat,
-					Default:          ParseStructFieldTag.GetDefaultValue(inputType.Field(i)),
-					Enum:             ValidateRule.Enum(inputType.Field(i)),
-					XEnumDescription: ParseStructFieldTag.EnumDescription(inputType.Field(i)),
+					Type:   convertBaseType,
+					Format: realInputTypeFormat,
 				},
 				AllowEmptyValue: false,
 				Style:           "",
 				Explode:         false,
 				AllowReserved:   false,
 			}
-			if itemParam.Schema.Type == consts.SwaggerDataTypeString {
-				itemParam.Schema.MinLength = minVal
-				itemParam.Schema.MaxLength = maxVal
-			} else {
-				itemParam.Schema.Minimum = minVal
-				itemParam.Schema.Maximum = maxVal
-			}
+			g.setStructFieldProperty(itemParam.Schema, inputType.Field(i))
 			baseReqCfg.Parameters = append(baseReqCfg.Parameters, itemParam)
 			continue
 		}
 		if inputType.Field(i).Type.Kind() == reflect.Interface {
-			baseReqCfg.Parameters = append(baseReqCfg.Parameters, &define.PathConfigParameter{
+			itemParam := &define.PathConfigParameter{
 				Name:        ParseStructFieldTag.GetParamName(inputType.Field(i)),
 				In:          consts.SwaggerParameterInQuery,
 				Description: ParseStructFieldTag.GetParamDesc(inputType.Field(i)),
 				Required:    ValidateRule.IsRequired(inputType.Field(i)),
 				Deprecated:  ParseStructFieldTag.Deprecated(inputType.Field(i)),
 				Schema: &define.Schema{
-					OneOf:            g.anyTypeConfig(inputType.Field(i)).OneOf,
-					Format:           realInputTypeFormat,
-					Enum:             ValidateRule.Enum(inputType.Field(i)),
-					XEnumDescription: ParseStructFieldTag.EnumDescription(inputType.Field(i)),
+					OneOf:  g.anyTypeConfig(inputType.Field(i)).OneOf,
+					Format: realInputTypeFormat,
 				},
-			})
+			}
+			g.setStructFieldProperty(itemParam.Schema, inputType.Field(i))
+			baseReqCfg.Parameters = append(baseReqCfg.Parameters, itemParam)
 			continue
 		}
 		if inputType.Field(i).Type.Kind() == reflect.Ptr {
@@ -434,6 +339,7 @@ func (g *Generate) ParseReadConfigParam(requestCfg *define.UriBaseConfig, baseRe
 					Format:           realInputTypeFormat,
 					Enum:             ValidateRule.Enum(inputType.Field(i)),
 					XEnumDescription: ParseStructFieldTag.EnumDescription(inputType.Field(i)),
+					Example:          ParseStructFieldTag.GetExampleValue(inputType.Field(i)),
 				},
 				AllowEmptyValue: false,
 				Style:           "",
@@ -521,7 +427,6 @@ func (g *Generate) AddComponentsSchema(rootSchemaName string, pkgPath string, in
 				Items:  propertyXOf,
 			}
 		}
-
 		return schemaName
 	}
 	// 结构体
@@ -554,24 +459,13 @@ func (g *Generate) AddComponentsSchema(rootSchemaName string, pkgPath string, in
 				} else {
 					// 当做默认基础类型, 默认不会出现 *map *[]
 					convertBaseType, _ := g.realBaseType2SwaggerType(inputType.Field(i).Type.String())
-					minVal := ValidateRule.Maximum(inputType.Field(i))
-					maxVal := ValidateRule.Minimum(inputType.Field(i))
 					g.docData.Components.Schemas[schemaName].Properties[propertyName] = &define.Property{
-						Type:             convertBaseType,
-						Format:           inputType.Field(i).Type.String(),
-						Enum:             ValidateRule.Enum(inputType.Field(i)),
-						XEnumDescription: ParseStructFieldTag.EnumDescription(inputType.Field(i)),
-						Default:          ParseStructFieldTag.GetDefaultValue(inputType.Field(i)),
-						Description:      ParseStructFieldTag.GetParamDesc(inputType.Field(i)),
-					}
-					if g.docData.Components.Schemas[schemaName].Properties[propertyName].Type == consts.SwaggerDataTypeString {
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].MinLength = minVal
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].MaxLength = maxVal
-					} else {
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].Minimum = minVal
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].Maximum = maxVal
+						Type:   convertBaseType,
+						Format: inputType.Field(i).Type.String(),
 					}
 				}
+				// 设置参数各种属性
+				g.setStructFieldProperty(g.docData.Components.Schemas[schemaName], inputType.Field(i))
 				continue
 			}
 			if inputType.Field(i).Type.Kind() == reflect.Struct ||
@@ -581,10 +475,9 @@ func (g *Generate) AddComponentsSchema(rootSchemaName string, pkgPath string, in
 				if inputType.Field(i).Type.Kind() == reflect.Struct ||
 					inputType.Field(i).Type.Kind() == reflect.Map {
 					g.docData.Components.Schemas[schemaName].Properties[propertyName] = &define.Property{
-						Type:        consts.SwaggerDataTypeObject,
-						Format:      inputType.Field(i).Type.String(),
-						Description: ParseStructFieldTag.GetParamDesc(inputType.Field(i)),
-						Properties:  map[string]*define.Property{},
+						Type:       consts.SwaggerDataTypeObject,
+						Format:     inputType.Field(i).Type.String(),
+						Properties: map[string]*define.Property{},
 					}
 				} else if inputType.Field(i).Type.Kind() == reflect.Array ||
 					inputType.Field(i).Type.Kind() == reflect.Slice {
@@ -600,10 +493,9 @@ func (g *Generate) AddComponentsSchema(rootSchemaName string, pkgPath string, in
 						propertyXOf.Ref = g.getSchemaRef(sliceItemType)
 					}
 					g.docData.Components.Schemas[schemaName].Properties[propertyName] = &define.Property{
-						Type:        consts.SwaggerDataTypeArray,
-						Format:      inputType.Field(i).Type.String(),
-						Description: ParseStructFieldTag.GetParamDesc(inputType.Field(i)),
-						Items:       propertyXOf,
+						Type:   consts.SwaggerDataTypeArray,
+						Format: inputType.Field(i).Type.String(),
+						Items:  propertyXOf,
 					}
 				} else {
 					g.AddComponentsSchema(schemaName, propertyName, inputType.Field(i).Type)
@@ -611,27 +503,17 @@ func (g *Generate) AddComponentsSchema(rootSchemaName string, pkgPath string, in
 			} else {
 				if inputType.Field(i).Type.Kind() == reflect.Interface {
 					g.docData.Components.Schemas[schemaName].Properties[propertyName] = g.anyTypeConfig(inputType.Field(i))
+					g.docData.Components.Schemas[schemaName].Properties[propertyName].Example = ParseStructFieldTag.GetExampleValue(inputType.Field(i))
 				} else {
 					convertBaseType, _ := g.realBaseType2SwaggerType(inputType.Field(i).Type.String())
-					minVal := ValidateRule.Maximum(inputType.Field(i))
-					maxVal := ValidateRule.Minimum(inputType.Field(i))
 					g.docData.Components.Schemas[schemaName].Properties[propertyName] = &define.Property{
-						Type:        convertBaseType,
-						Format:      inputType.Field(i).Type.String(),
-						Default:     ParseStructFieldTag.GetDefaultValue(inputType.Field(i)),
-						Description: ParseStructFieldTag.GetParamDesc(inputType.Field(i)),
-					}
-					if g.docData.Components.Schemas[schemaName].Properties[propertyName].Type == consts.SwaggerDataTypeString {
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].MinLength = minVal
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].MaxLength = maxVal
-					} else {
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].Minimum = minVal
-						g.docData.Components.Schemas[schemaName].Properties[propertyName].Maximum = maxVal
+						Type:   convertBaseType,
+						Format: inputType.Field(i).Type.String(),
 					}
 				}
 			}
 			// 设置参数各种属性
-			g.setStructFieldProperty(schemaName, inputType.Field(i))
+			g.setStructFieldProperty(g.docData.Components.Schemas[schemaName], inputType.Field(i))
 		}
 		return schemaName
 	}
@@ -686,6 +568,7 @@ func (g *Generate) handleAnonymousField(schemaName string, field reflect.StructF
 				g.docData.Components.Schemas[schemaName].Properties[paramName] = &define.Property{
 					Type:             baseConvertType,
 					Format:           itemField.Type.String(),
+					Example:          ParseStructFieldTag.GetExampleValue(itemField),
 					Enum:             ValidateRule.Enum(itemField),
 					XEnumDescription: ParseStructFieldTag.EnumDescription(itemField),
 					Default:          ParseStructFieldTag.GetDefaultValue(handleType.Field(i)),
@@ -775,12 +658,48 @@ func (g *Generate) realBaseType2SwaggerType(realType string) (string, bool) {
 // Author : go_developer@163.com<白茶清欢>
 //
 // Date : 16:13 2025/2/13
-func (g *Generate) setStructFieldProperty(schemaName string, structField reflect.StructField) {
+func (g *Generate) setStructFieldProperty(schema *define.Schema, structField reflect.StructField) {
 	paramName := ParseStructFieldTag.GetParamName(structField)
-	if ValidateRule.IsRequired(structField) {
-		g.docData.Components.Schemas[schemaName].Required = append(g.docData.Components.Schemas[schemaName].Required, paramName)
+	if paramName == "" || paramName == "-" {
+		return
+	}
+	isRequired := ValidateRule.IsRequired(structField)
+	enum := ValidateRule.Enum(structField)
+	xEnumDescription := ParseStructFieldTag.EnumDescription(structField)
+	example := ParseStructFieldTag.GetExampleValue(structField)
+	description := ParseStructFieldTag.GetParamDesc(structField)
+	maxVal := ValidateRule.Maximum(structField)
+	minVal := ValidateRule.Minimum(structField)
+	if nil != schema {
+		if isRequired {
+			schema.Required = append(schema.Required, paramName)
+		}
+		if nil == schema.Properties[paramName] {
+			if schema.Type == consts.SwaggerDataTypeString {
+				schema.MinLength = minVal
+				schema.MaxLength = maxVal
+			} else {
+				schema.Minimum = minVal
+				schema.Maximum = maxVal
+			}
+			schema.Enum = enum
+			schema.XEnumDescription = xEnumDescription
+			schema.Example = example
+			schema.Description = description
+			return
+		}
+		if schema.Properties[paramName].Type == consts.SwaggerDataTypeString {
+			schema.Properties[paramName].MinLength = minVal
+			schema.Properties[paramName].MaxLength = maxVal
+		} else {
+			schema.Properties[paramName].Minimum = minVal
+			schema.Properties[paramName].Maximum = maxVal
+		}
+		schema.Properties[paramName].Enum = enum
+		schema.Properties[paramName].XEnumDescription = xEnumDescription
+		schema.Properties[paramName].Example = example
+		schema.Properties[paramName].Description = description
 	}
-	g.docData.Components.Schemas[schemaName].Properties[ParseStructFieldTag.GetParamName(structField)].Enum = ValidateRule.Enum(structField)
 }
 
 // parseBaseUriConfig 通过Meta字段解析Uri基础配置信息

go.mod

@@ -1,63 +1,61 @@
-module git.zhangdeman.cn/gateway/api-doc
+module git.zhangdeman.cn/zhangdeman/api-doc
 
-go 1.22.2
+go 1.23.0
+
+toolchain go1.24.1
 
 require (
-	git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250208020330-a50062af46a1
-	git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd
-	git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9
-	github.com/gin-gonic/gin v1.10.0
+	git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20250504055908-8d68e6106ea9
+	git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250321102712-1cbfbe959740
+	github.com/gin-gonic/gin v1.10.1
 	github.com/go-webtools/knife4go v1.0.4
 	github.com/swaggo/files v1.0.1
 	github.com/swaggo/gin-swagger v1.6.0
-	github.com/tidwall/gjson v1.18.0
 )
 
 require (
 	git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0 // indirect
 	git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e // indirect
-	github.com/BurntSushi/toml v1.4.0 // indirect
+	github.com/BurntSushi/toml v1.5.0 // indirect
 	github.com/KyleBanks/depth v1.2.1 // indirect
-	github.com/PuerkitoBio/purell v1.1.1 // indirect
-	github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578 // indirect
 	github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394 // indirect
-	github.com/bytedance/sonic v1.11.6 // indirect
-	github.com/bytedance/sonic/loader v0.1.1 // indirect
-	github.com/cloudwego/base64x v0.1.4 // indirect
-	github.com/cloudwego/iasm v0.2.0 // indirect
-	github.com/gabriel-vasile/mimetype v1.4.3 // indirect
-	github.com/gin-contrib/sse v0.1.0 // indirect
+	github.com/bytedance/sonic v1.13.2 // indirect
+	github.com/bytedance/sonic/loader v0.2.4 // indirect
+	github.com/cloudwego/base64x v0.1.5 // indirect
+	github.com/gabriel-vasile/mimetype v1.4.9 // indirect
+	github.com/gin-contrib/sse v1.1.0 // indirect
 	github.com/go-ini/ini v1.67.0 // indirect
-	github.com/go-openapi/jsonpointer v0.19.5 // indirect
-	github.com/go-openapi/jsonreference v0.19.6 // indirect
-	github.com/go-openapi/spec v0.20.4 // indirect
-	github.com/go-openapi/swag v0.19.15 // indirect
+	github.com/go-openapi/jsonpointer v0.21.1 // indirect
+	github.com/go-openapi/jsonreference v0.21.0 // indirect
+	github.com/go-openapi/spec v0.21.0 // indirect
+	github.com/go-openapi/swag v0.23.1 // indirect
 	github.com/go-playground/locales v0.14.1 // indirect
 	github.com/go-playground/universal-translator v0.18.1 // indirect
-	github.com/go-playground/validator/v10 v10.20.0 // indirect
-	github.com/goccy/go-json v0.10.2 // indirect
+	github.com/go-playground/validator/v10 v10.26.0 // indirect
+	github.com/goccy/go-json v0.10.5 // indirect
 	github.com/josharian/intern v1.0.0 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.7 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
-	github.com/mailru/easyjson v0.7.6 // indirect
+	github.com/mailru/easyjson v0.9.0 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
 	github.com/modern-go/reflect2 v1.0.2 // indirect
-	github.com/pelletier/go-toml/v2 v2.2.2 // indirect
+	github.com/pelletier/go-toml/v2 v2.2.4 // indirect
+	github.com/sbabiv/xml2map v1.2.1 // indirect
 	github.com/spaolacci/murmur3 v1.1.0 // indirect
-	github.com/swaggo/swag v1.8.12 // indirect
+	github.com/swaggo/swag v1.16.4 // indirect
+	github.com/tidwall/gjson v1.18.0 // indirect
 	github.com/tidwall/match v1.1.1 // indirect
 	github.com/tidwall/pretty v1.2.1 // indirect
 	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
-	github.com/ugorji/go/codec v1.2.12 // indirect
-	golang.org/x/arch v0.8.0 // indirect
-	golang.org/x/crypto v0.23.0 // indirect
-	golang.org/x/net v0.25.0 // indirect
-	golang.org/x/sys v0.20.0 // indirect
-	golang.org/x/text v0.15.0 // indirect
-	golang.org/x/tools v0.7.0 // indirect
-	google.golang.org/protobuf v1.34.1 // indirect
-	gopkg.in/yaml.v2 v2.4.0 // indirect
+	github.com/ugorji/go/codec v1.2.14 // indirect
+	golang.org/x/arch v0.17.0 // indirect
+	golang.org/x/crypto v0.38.0 // indirect
+	golang.org/x/net v0.40.0 // indirect
+	golang.org/x/sys v0.33.0 // indirect
+	golang.org/x/text v0.25.0 // indirect
+	golang.org/x/tools v0.33.0 // indirect
+	google.golang.org/protobuf v1.36.6 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

go.sum

@@ -1,125 +1,122 @@
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250208020330-a50062af46a1 h1:vv4X72I6s6XcTi0ykj2v/cgMZyseFyE2LkS4WloICCs=
-git.zhangdeman.cn/zhangdeman/consts v0.0.0-20250208020330-a50062af46a1/go.mod h1:IXXaZkb7vGzGnGM5RRWrASAuwrVSNxuoe0DmeXx5g6k=
+git.zhangdeman.cn/zhangdeman/api-doc/enums v0.0.0-20250425024726-cc17224cb995 h1:LmPRAf0AsxRVFPibdpZR89ajlsz8hof2IvMMyTqiEq4=
+git.zhangdeman.cn/zhangdeman/api-doc/enums v0.0.0-20250425024726-cc17224cb995/go.mod h1:5p8CEKGBxi7qPtTXDI3HDmqKAfIm5i/aBWdrbkbdNjc=
 git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0 h1:gUDlQMuJ4xNfP2Abl1Msmpa3fASLWYkNlqDFF/6GN0Y=
 git.zhangdeman.cn/zhangdeman/op_type v0.0.0-20240122104027-4928421213c0/go.mod h1:VHb9qmhaPDAQDcS6vUiDCamYjZ4R5lD1XtVsh55KsMI=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd h1:q7GG14qgXKB4MEXQFOe7/UYebsqMfPaSX80TcPdOosI=
-git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20241223084948-de2e49144fcd/go.mod h1:+D6uPSljwHywjVY5WSBY4TRVMj26TN5f5cFGEYMldjs=
+git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20250504055908-8d68e6106ea9 h1:/GLQaFoLb+ciHOtAS2BIyPNnf4O5ME3AC5PUaJY9kfs=
+git.zhangdeman.cn/zhangdeman/serialize v0.0.0-20250504055908-8d68e6106ea9/go.mod h1:ABJ655C5QenQNOzf7LjCe4sSB52CXvaWLX2Zg4uwDJY=
 git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e h1:Q973S6CcWr1ICZhFI1STFOJ+KUImCl2BaIXm6YppBqI=
 git.zhangdeman.cn/zhangdeman/util v0.0.0-20240618042405-6ee2c904644e/go.mod h1:VpPjBlwz8U+OxZuxzHQBv1aEEZ3pStH6bZvT21ADEbI=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9 h1:yF770WIDNwyiKL0nwmBGmjZvNCLXtHQL4xJyffPjTMU=
-git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250124091620-c757e551a8c9/go.mod h1:I76wxEsWq7KnMQ84elpwTjEqq4I49QFw60tp5h7iGBs=
-github.com/BurntSushi/toml v1.4.0 h1:kuoIxZQy2WRRk1pttg9asf+WVv6tWQuBNVmK8+nqPr0=
-github.com/BurntSushi/toml v1.4.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
+git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250321102712-1cbfbe959740 h1:zPUoylfJTbc0EcxW+NEzOTBmoeFZ2I/rLFBnEzxb4Wk=
+git.zhangdeman.cn/zhangdeman/wrapper v0.0.0-20250321102712-1cbfbe959740/go.mod h1:1ct92dbVc49pmXusA/iGfcQUJzcYmJ+cjAhgc3sDv1I=
+github.com/BurntSushi/toml v1.5.0 h1:W5quZX/G/csjUnuI8SUYlsHs9M38FC7znL0lIO+DvMg=
+github.com/BurntSushi/toml v1.5.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
 github.com/KyleBanks/depth v1.2.1 h1:5h8fQADFrWtarTdtDudMmGsC7GPbOAu6RVB3ffsVFHc=
 github.com/KyleBanks/depth v1.2.1/go.mod h1:jzSb9d0L43HxTQfT+oSA1EEp2q+ne2uh6XgeJcm8brE=
-github.com/PuerkitoBio/purell v1.1.1 h1:WEQqlqaGbrPkxLJWfBwQmfEAE1Z7ONdDLqrN38tNFfI=
-github.com/PuerkitoBio/purell v1.1.1/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0=
-github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578 h1:d+Bc7a5rLufV/sSk/8dngufqelfh6jnri85riMAaF/M=
-github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578/go.mod h1:uGdkoq3SwY9Y+13GIhn11/XLaGBb4BfwItxLd5jeuXE=
 github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394 h1:OYA+5W64v3OgClL+IrOD63t4i/RW7RqrAVl9LTZ9UqQ=
 github.com/axgle/mahonia v0.0.0-20180208002826-3358181d7394/go.mod h1:Q8n74mJTIgjX4RBBcHnJ05h//6/k6foqmgE45jTQtxg=
-github.com/bytedance/sonic v1.11.6 h1:oUp34TzMlL+OY1OUWxHqsdkgC/Zfc85zGqw9siXjrc0=
-github.com/bytedance/sonic v1.11.6/go.mod h1:LysEHSvpvDySVdC2f87zGWf6CIKJcAvqab1ZaiQtds4=
-github.com/bytedance/sonic/loader v0.1.1 h1:c+e5Pt1k/cy5wMveRDyk2X4B9hF4g7an8N3zCYjJFNM=
+github.com/bytedance/sonic v1.13.2 h1:8/H1FempDZqC4VqjptGo14QQlJx8VdZJegxs6wwfqpQ=
+github.com/bytedance/sonic v1.13.2/go.mod h1:o68xyaF9u2gvVBuGHPlUVCy+ZfmNNO5ETf1+KgkJhz4=
 github.com/bytedance/sonic/loader v0.1.1/go.mod h1:ncP89zfokxS5LZrJxl5z0UJcsk4M4yY2JpfqGeCtNLU=
-github.com/cloudwego/base64x v0.1.4 h1:jwCgWpFanWmN8xoIUHa2rtzmkd5J2plF/dnLS6Xd/0Y=
-github.com/cloudwego/base64x v0.1.4/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
-github.com/cloudwego/iasm v0.2.0 h1:1KNIy1I1H9hNNFEEH3DVnI4UujN+1zjpuk6gwHLTssg=
+github.com/bytedance/sonic/loader v0.2.4 h1:ZWCw4stuXUsn1/+zQDqeE7JKP+QO47tz7QCNan80NzY=
+github.com/bytedance/sonic/loader v0.2.4/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
+github.com/cloudwego/base64x v0.1.5 h1:XPciSp1xaq2VCSt6lF0phncD4koWyULpl5bUxbfCyP4=
+github.com/cloudwego/base64x v0.1.5/go.mod h1:0zlkT4Wn5C6NdauXdJRhSKRlJvmclQ1hhJgA0rcu/8w=
 github.com/cloudwego/iasm v0.2.0/go.mod h1:8rXZaNYT2n95jn+zTI1sDr+IgcD2GVs0nlbbQPiEFhY=
-github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/gabriel-vasile/mimetype v1.4.3 h1:in2uUcidCuFcDKtdcBxlR0rJ1+fsokWf+uqxgUFjbI0=
-github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcPfT7nKyLpA0lbSSk=
+github.com/gabriel-vasile/mimetype v1.4.9 h1:5k+WDwEsD9eTLL8Tz3L0VnmVh9QxGjRmjBvAG7U/oYY=
+github.com/gabriel-vasile/mimetype v1.4.9/go.mod h1:WnSQhFKJuBlRyLiKohA/2DtIlPFAbguNaG7QCHcyGok=
 github.com/gin-contrib/gzip v0.0.6 h1:NjcunTcGAj5CO1gn4N8jHOSIeRFHIbn51z6K+xaN4d4=
 github.com/gin-contrib/gzip v0.0.6/go.mod h1:QOJlmV2xmayAjkNS2Y8NQsMneuRShOU/kjovCXNuzzk=
-github.com/gin-contrib/sse v0.1.0 h1:Y/yl/+YNO8GZSjAhjMsSuLt29uWRFHdHYUb5lYOV9qE=
-github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
-github.com/gin-gonic/gin v1.10.0 h1:nTuyha1TYqgedzytsKYqna+DfLos46nTv2ygFy86HFU=
-github.com/gin-gonic/gin v1.10.0/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
+github.com/gin-contrib/sse v1.1.0 h1:n0w2GMuUpWDVp7qSpvze6fAu9iRxJY4Hmj6AmBOU05w=
+github.com/gin-contrib/sse v1.1.0/go.mod h1:hxRZ5gVpWMT7Z0B0gSNYqqsSCNIJMjzvm6fqCz9vjwM=
+github.com/gin-gonic/gin v1.10.1 h1:T0ujvqyCSqRopADpgPgiTT63DUQVSfojyME59Ei63pQ=
+github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
 github.com/go-ini/ini v1.67.0 h1:z6ZrTEZqSWOTyH2FlglNbNgARyHG8oLW9gMELqKr06A=
 github.com/go-ini/ini v1.67.0/go.mod h1:ByCAeIL28uOIIG0E3PJtZPDL8WnHpFKFOtgjp+3Ies8=
-github.com/go-openapi/jsonpointer v0.19.3/go.mod h1:Pl9vOtqEWErmShwVjC8pYs9cog34VGT37dQOVbmoatg=
-github.com/go-openapi/jsonpointer v0.19.5 h1:gZr+CIYByUqjcgeLXnQu2gHYQC9o73G2XUeOFYEICuY=
-github.com/go-openapi/jsonpointer v0.19.5/go.mod h1:Pl9vOtqEWErmShwVjC8pYs9cog34VGT37dQOVbmoatg=
-github.com/go-openapi/jsonreference v0.19.6 h1:UBIxjkht+AWIgYzCDSv2GN+E/togfwXUJFRTWhl2Jjs=
-github.com/go-openapi/jsonreference v0.19.6/go.mod h1:diGHMEHg2IqXZGKxqyvWdfWU/aim5Dprw5bqpKkTvns=
-github.com/go-openapi/spec v0.20.4 h1:O8hJrt0UMnhHcluhIdUgCLRWyM2x7QkBXRvOs7m+O1M=
-github.com/go-openapi/spec v0.20.4/go.mod h1:faYFR1CvsJZ0mNsmsphTMSoRrNV3TEDoAM7FOEWeq8I=
-github.com/go-openapi/swag v0.19.5/go.mod h1:POnQmlKehdgb5mhVOsnJFsivZCEZ/vjK9gh66Z9tfKk=
-github.com/go-openapi/swag v0.19.15 h1:D2NRCBzS9/pEY3gP9Nl8aDqGUcPFrwG2p+CNFrLyrCM=
-github.com/go-openapi/swag v0.19.15/go.mod h1:QYRuS/SOXUCsnplDa677K7+DxSOj6IPNl/eQntq43wQ=
+github.com/go-openapi/jsonpointer v0.21.1 h1:whnzv/pNXtK2FbX/W9yJfRmE2gsmkfahjMKB0fZvcic=
+github.com/go-openapi/jsonpointer v0.21.1/go.mod h1:50I1STOfbY1ycR8jGz8DaMeLCdXiI6aDteEdRNNzpdk=
+github.com/go-openapi/jsonreference v0.21.0 h1:Rs+Y7hSXT83Jacb7kFyjn4ijOuVGSvOdF2+tg1TRrwQ=
+github.com/go-openapi/jsonreference v0.21.0/go.mod h1:LmZmgsrTkVg9LG4EaHeY8cBDslNPMo06cago5JNLkm4=
+github.com/go-openapi/spec v0.21.0 h1:LTVzPc3p/RzRnkQqLRndbAzjY0d0BCL72A6j3CdL9ZY=
+github.com/go-openapi/spec v0.21.0/go.mod h1:78u6VdPw81XU44qEWGhtr982gJ5BWg2c0I5XwVMotYk=
+github.com/go-openapi/swag v0.23.1 h1:lpsStH0n2ittzTnbaSloVZLuB5+fvSY/+hnagBjSNZU=
+github.com/go-openapi/swag v0.23.1/go.mod h1:STZs8TbRvEQQKUA+JZNAm3EWlgaOBGpyFDqQnDHMef0=
 github.com/go-playground/assert/v2 v2.2.0 h1:JvknZsQTYeFEAhQwI4qEt9cyV5ONwRHC+lYKSsYSR8s=
 github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
 github.com/go-playground/locales v0.14.1 h1:EWaQ/wswjilfKLTECiXz7Rh+3BjFhfDFKv/oXslEjJA=
 github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
 github.com/go-playground/universal-translator v0.18.1 h1:Bcnm0ZwsGyWbCzImXv+pAJnYK9S473LQFuzCbDbfSFY=
 github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
-github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBExVwjEviJTixqxL8=
-github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
+github.com/go-playground/validator/v10 v10.26.0 h1:SP05Nqhjcvz81uJaRfEV0YBSSSGMc/iMaVtFbr3Sw2k=
+github.com/go-playground/validator/v10 v10.26.0/go.mod h1:I5QpIEbmr8On7W0TktmJAumgzX4CA1XNl4ZmDuVHKKo=
 github.com/go-webtools/knife4go v1.0.4 h1:p32SApmM0sx2/Y5p0QfeaGv5KD96R1mj2CaHdyH8jy8=
 github.com/go-webtools/knife4go v1.0.4/go.mod h1:trOlXN1tqBJ7R44sHON3exGvzCwjbsVriIHEenry3d8=
-github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
-github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
-github.com/google/go-cmp v0.5.5 h1:Khx7svrCpmxxtHBq5j2mp/xVjsi8hQMfNLvJFAlrGgU=
-github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/goccy/go-json v0.10.5 h1:Fq85nIqj+gXn/S5ahsiTlK3TmC85qgirsdTP/+DeaC4=
+github.com/goccy/go-json v0.10.5/go.mod h1:oq7eo15ShAhp70Anwd5lgX2pLfOS3QCiwU/PULtXL6M=
+github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
+github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/google/gofuzz v1.2.0 h1:xRy4A+RhZaiKjJ1bPfwQ8sedCA+YS2YcCHW6ec7JMi0=
+github.com/google/gofuzz v1.2.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
+github.com/gopherjs/gopherjs v1.17.2 h1:fQnZVsXk8uxXIStYb0N4bGk7jeyTalG/wsZjQ25dO0g=
+github.com/gopherjs/gopherjs v1.17.2/go.mod h1:pRRIvn/QzFLrKfvEz3qUuEhtE/zLCWfreZ6J5gM2i+k=
 github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY=
 github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
 github.com/json-iterator/go v1.1.12 h1:PV8peI4a0ysnczrg+LtxykD8LfKY9ML6u2jnxaEnrnM=
 github.com/json-iterator/go v1.1.12/go.mod h1:e30LSqwooZae/UwlEbR2852Gd8hjQvJoHmT4TnhNGBo=
+github.com/jtolds/gls v4.20.0+incompatible h1:xdiiI2gbIgH/gLH7ADydsJ1uDOEzR8yvV7C0MuV77Wo=
+github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU=
 github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
-github.com/klauspost/cpuid/v2 v2.2.7 h1:ZWSB3igEs+d0qvnxR/ZBzXVmxkgt8DdzP6m9pfuVLDM=
-github.com/klauspost/cpuid/v2 v2.2.7/go.mod h1:Lcz8mBdAVJIBVzewtcLocK12l3Y+JytZYpaMropDUws=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
 github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
-github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
-github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
-github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
 github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
-github.com/mailru/easyjson v0.0.0-20190614124828-94de47d64c63/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc=
-github.com/mailru/easyjson v0.0.0-20190626092158-b2ccc519800e/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc=
-github.com/mailru/easyjson v0.7.6 h1:8yTIVnZgCoiM1TgqoeTl+LfU5Jg6/xL3QhGQnimLYnA=
-github.com/mailru/easyjson v0.7.6/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
+github.com/mailru/easyjson v0.9.0 h1:PrnmzHw7262yW8sTBwxi1PdJA3Iw/EKBa8psRf7d9a4=
+github.com/mailru/easyjson v0.9.0/go.mod h1:1+xMtQp2MRNVL/V1bOzuP3aP8VNwRW55fQUto+XFtTU=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
 github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY=
-github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo=
 github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
-github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e h1:fD57ERR4JtEqsWbfPhv4DMiApHyliiK5xCTNVSPiaAs=
-github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
-github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
-github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
+github.com/pelletier/go-toml/v2 v2.2.4 h1:mye9XuhQ6gvn5h28+VilKrrPoQVanw5PMw/TB0t5Ec4=
+github.com/pelletier/go-toml/v2 v2.2.4/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.11.0 h1:cWPaGQEPrBb5/AsnsZesgZZ9yb1OQ+GOISoDNXVBh4M=
+github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUzkipdSkR5nkCZA=
+github.com/sbabiv/xml2map v1.2.1 h1:1lT7t0hhUvXZCkdxqtq4n8/ZCnwLWGq4rDuDv5XOoFE=
+github.com/sbabiv/xml2map v1.2.1/go.mod h1:2TPoAfcaM7+Sd4iriPvzyntb2mx7GY+kkQpB/GQa/eo=
+github.com/smarty/assertions v1.15.0 h1:cR//PqUBUiQRakZWqBiFFQ9wb8emQGDb0HeGdqGByCY=
+github.com/smarty/assertions v1.15.0/go.mod h1:yABtdzeQs6l1brC900WlRNwj6ZR55d7B+E8C6HtKdec=
+github.com/smartystreets/goconvey v1.8.1 h1:qGjIddxOk4grTu9JPOU31tVfq3cNdBlNa5sSznIX1xY=
+github.com/smartystreets/goconvey v1.8.1/go.mod h1:+/u4qLyY6x1jReYOp7GOM2FSt8aP9CzCZL03bI28W60=
 github.com/spaolacci/murmur3 v1.1.0 h1:7c1g84S4BPRrfL5Xrdp6fOJ206sU9y293DDHaoy0bLI=
 github.com/spaolacci/murmur3 v1.1.0/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
-github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
-github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
 github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
-github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
-github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
-github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
 github.com/swaggo/files v1.0.1 h1:J1bVJ4XHZNq0I46UU90611i9/YzdrF7x92oX1ig5IdE=
 github.com/swaggo/files v1.0.1/go.mod h1:0qXmMNH6sXNf+73t65aKeB+ApmgxdnkQzVTAj2uaMUg=
 github.com/swaggo/gin-swagger v1.6.0 h1:y8sxvQ3E20/RCyrXeFfg60r6H0Z+SwpTjMYsMm+zy8M=
 github.com/swaggo/gin-swagger v1.6.0/go.mod h1:BG00cCEy294xtVpyIAHG6+e2Qzj/xKlRdOqDkvq0uzo=
-github.com/swaggo/swag v1.8.12 h1:pctzkNPu0AlQP2royqX3apjKCQonAnf7KGoxeO4y64w=
-github.com/swaggo/swag v1.8.12/go.mod h1:lNfm6Gg+oAq3zRJQNEMBE66LIJKM44mxFqhEEgy2its=
+github.com/swaggo/swag v1.16.4 h1:clWJtd9LStiG3VeijiCfOVODP6VpHtKdQy9ELFG3s1A=
+github.com/swaggo/swag v1.16.4/go.mod h1:VBsHJRsDvfYvqoiMKnsdwhNV9LEMHgEDZcyVYX0sxPg=
 github.com/tidwall/gjson v1.18.0 h1:FIDeeyB800efLX89e5a8Y0BNH+LOngJyGrIWxG2FKQY=
 github.com/tidwall/gjson v1.18.0/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
 github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
@@ -129,68 +126,58 @@ github.com/tidwall/pretty v1.2.1 h1:qjsOFOWWQl+N3RsoF5/ssm1pHmJJwhjlSbZ51I6wMl4=
 github.com/tidwall/pretty v1.2.1/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
 github.com/twitchyliquid64/golang-asm v0.15.1 h1:SU5vSMR7hnwNxj24w34ZyCi/FmDZTkS4MhqMhdFk5YI=
 github.com/twitchyliquid64/golang-asm v0.15.1/go.mod h1:a1lVb/DtPvCB8fslRZhAngC2+aY1QWCk3Cedj/Gdt08=
-github.com/ugorji/go/codec v1.2.12 h1:9LC83zGrHhuUA9l16C9AHXAqEV/2wBQ4nkvumAE65EE=
-github.com/ugorji/go/codec v1.2.12/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
+github.com/ugorji/go/codec v1.2.14 h1:yOQvXCBc3Ij46LRkRoh4Yd5qK6LVOgi0bYOXfb7ifjw=
+github.com/ugorji/go/codec v1.2.14/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZgYf6w6lg=
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
-golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
-golang.org/x/arch v0.8.0 h1:3wRIsP3pM4yUptoR96otTUOXI367OS0+c9eeRi9doIc=
-golang.org/x/arch v0.8.0/go.mod h1:FEVrYAQjsQXMVJ1nsMoVVXPZg6p2JE2mx8psSWTDQys=
+golang.org/x/arch v0.17.0 h1:4O3dfLzd+lQewptAHqjewQZQDyEdejz3VwgeYwkZneU=
+golang.org/x/arch v0.17.0/go.mod h1:bdwinDaKcfZUGpH09BB7ZmOfhalA8lQdzl62l8gGWsk=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
-golang.org/x/crypto v0.23.0 h1:dIJU/v2J8Mdglj/8rJ6UUOM3Zc9zLZxVZwwxMooUSAI=
-golang.org/x/crypto v0.23.0/go.mod h1:CKFgDieR+mRhux2Lsu27y0fO304Db0wZe70UKqHu0v8=
+golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8=
+golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw=
 golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
-golang.org/x/mod v0.9.0 h1:KENHtAZL2y3NLMYZeHY9DW8HW8V+kQyJsY/V9JlKvCs=
-golang.org/x/mod v0.9.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs=
+golang.org/x/mod v0.24.0 h1:ZfthKaKaT4NrhGVZHO1/WDTwGES4De8KtWO0SIbNJMU=
+golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww=
 golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
-golang.org/x/net v0.0.0-20210421230115-4e50805a0758/go.mod h1:72T/g9IO56b78aLF+1Kcs5dz7/ng1VjMUvfKvpfy+jM=
 golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
 golang.org/x/net v0.7.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
-golang.org/x/net v0.25.0 h1:d/OCCoBEUq33pjydKrGQhw7IlUPI2Oylr+8qLx49kac=
-golang.org/x/net v0.25.0/go.mod h1:JkAGAh7GEvH74S6FOH42FLoXpXbE/aqXSrIQjXgsiwM=
+golang.org/x/net v0.40.0 h1:79Xs7wF06Gbdcg4kdCCIQArK11Z1hr5POQ6+fIYHNuY=
+golang.org/x/net v0.40.0/go.mod h1:y0hY0exeL2Pku80/zKK7tpntoX23cqL3Oa6njdgRtds=
 golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.14.0 h1:woo0S4Yywslg6hp4eUFjTVOyKt0RookbpAHG4c1HmhQ=
+golang.org/x/sync v0.14.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210420072515-93ed5bcd2bfe/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.20.0 h1:Od9JTbYCk261bKm4M/mw7AklTlFYIa0bIp9BgSm1S8Y=
-golang.org/x/sys v0.20.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
+golang.org/x/sys v0.33.0 h1:q3i8TbbEz+JRD9ywIRlyRAQbM0qF7hu24q3teo2hbuw=
+golang.org/x/sys v0.33.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
 golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
 golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
 golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
-golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
 golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
 golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
-golang.org/x/text v0.15.0 h1:h1V/4gjBv8v9cjcR6+AR5+/cIYK5N/WAgiv4xlsEtAk=
-golang.org/x/text v0.15.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
+golang.org/x/text v0.25.0 h1:qVyWApTSYLk/drJRO5mDlNYskwQznZmkpV2c8q9zls4=
+golang.org/x/text v0.25.0/go.mod h1:WEdwpYrmk1qmdHvhkSTNPm3app7v4rsT8F2UD6+VHIA=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
 golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
-golang.org/x/tools v0.7.0 h1:W4OVu8VVOaIO0yzWMNdepAulS7YfoS3Zabrm8DOXXU4=
-golang.org/x/tools v0.7.0/go.mod h1:4pg6aUX35JBAogB10C9AtvVL+qowtN4pT3CGSQex14s=
+golang.org/x/tools v0.33.0 h1:4qz2S3zmRxbGIhDIAgjxvFutSvH5EfnsYrRBj0UI0bc=
+golang.org/x/tools v0.33.0/go.mod h1:CIJMaWEY88juyUfo7UbgPqbC8rU2OqfAV1h2Qp0oMYI=
 golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543 h1:E7g+9GITq07hpfrRu66IVDexMakfv52eLZ2CXBWiKr4=
-golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-google.golang.org/protobuf v1.34.1 h1:9ddQBjfCyZPOHPUiPxpYESBLc+T8P3E+Vo4IbKZgFWg=
-google.golang.org/protobuf v1.34.1/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
+google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY=
+google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f h1:BLraFXnmrev5lT+xlilqcH8XK9/i0At2xKjWk4p6zsU=
-gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
-gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
-gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
-gopkg.in/yaml.v3 v3.0.0-20200615113413-eeeca48fe776/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
-rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=

parser.go

@@ -8,34 +8,36 @@
 package api_doc
 
 import (
-	"git.zhangdeman.cn/gateway/api-doc/define"
+	"errors"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
 	"git.zhangdeman.cn/zhangdeman/serialize"
-	"github.com/tidwall/gjson"
-	"strings"
 )
 
-// Parse 解析swagger文档
+// ParseOpenapi3 解析openapi文档
 //
 // Author : go_developer@163.com<白茶清欢>
 //
-// Date : 16:54 2024/12/23
-func Parse(docUrl string) (*define.DocParseResult, error) {
+// Date : 21:02 2025/2/25
+func ParseOpenapi3(docUrl string, docContent string) (*define.OpenapiDoc, error) {
 	var (
-		err        error
-		docContent []byte
+		docRes  define.OpenapiDoc
+		err     error
+		docByte []byte
 	)
 
-	if docContent, err = serialize.File.ReadFromRemote(docUrl); nil != err {
+	if len(docContent) < 2 {
+		if len(docUrl) == 0 {
+			return nil, errors.New("doc url and doc content all empty")
+		}
+		if docByte, err = serialize.File.ReadFromRemote(docUrl); nil != err {
+			return nil, err
+		}
+	} else {
+		docByte = []byte(docContent)
+	}
+	if err = serialize.JSON.UnmarshalWithNumber(docByte, &docRes); nil != err {
 		return nil, err
 	}
-	swaggerVersion := gjson.GetBytes(docContent, "swagger").String()
-	if "" == swaggerVersion || !strings.HasPrefix(swaggerVersion, "2.") {
-		// 未指定swagger版本或swagger版本3.x
-		return ParseOpenapi3(docContent)
-	}
-	return ParseSwagger2(docContent)
-}
-
-func ParseOpenapi3(docContent []byte) (*define.DocParseResult, error) {
-	return nil, nil
+	return &docRes, nil
 }

parser_test.go

@@ -10,10 +10,10 @@ package api_doc
 import (
 	"encoding/json"
 	"fmt"
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/zhangdeman/serialize"
 	"reflect"
 	"testing"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
 )
 
 type Meta struct {
@@ -70,22 +70,22 @@ func Test_parser_Openapi3(t *testing.T) {
 	var ug *UserGet
 	var uh *UserHead
 	g := NewOpenapiDoc(nil, []*define.ServerItem{
-		&define.ServerItem{
+		{
 			Url:         "http://127.0.0.1/v1",
 			Description: "v1接口",
 			Variables: map[string]*define.ServerItemVariable{
-				"test": &define.ServerItemVariable{
+				"test": {
 					Default:     "123456",
 					Description: "1111",
 					Enum:        nil,
 				},
-			},
-		},
-		&define.ServerItem{
+					},
+				},
+		{
 			Url:         "http://127.0.0.1/v2",
 			Description: "v2接口",
 			Variables:   nil,
-		},
+				},
 	})
 	g.AddApiFromInAndOut("", reflect.TypeOf(f), reflect.TypeOf(o))
 	g.AddApiFromInAndOut("", reflect.TypeOf(fd), reflect.TypeOf(o))
@@ -96,8 +96,7 @@ func Test_parser_Openapi3(t *testing.T) {
 	fmt.Println(string(byteData))
 }
 
-func TestParseForSwagger(t *testing.T) {
-	docUrl := "https://git.zhangdeman.cn/swagger.v1.json"
-	res, _ := Parse(docUrl)
-	serialize.JSON.ConsoleOutput(res)
+func Test_parse_Openapi3_doc(t *testing.T) {
+	res, err := ParseOpenapi3("http://localhost:10990/static-server/github-openapi.json", "")
+	fmt.Println(res, err)
 }

struct_field.go

@@ -8,10 +8,11 @@
 package api_doc
 
 import (
-	"git.zhangdeman.cn/gateway/api-doc/define"
 	"reflect"
 	"strconv"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
 )
 
 var (
@@ -178,3 +179,43 @@ func (psf parseStructFieldTag) EnumDescription(structField reflect.StructField)
 	}
 	return res
 }
+
+// GetExampleValue 示例值
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 14:42 2025/2/20
+func (psf parseStructFieldTag) GetExampleValue(structField reflect.StructField) any {
+	descTagList := []string{define.TagEg, define.TagExample}
+	fieldType := structField.Type.Kind().String()
+	for _, tag := range descTagList {
+		val := strings.TrimSpace(structField.Tag.Get(tag))
+		if val == "" {
+			continue
+		}
+		if strings.HasPrefix(fieldType, "int") {
+			i, _ := strconv.Atoi(val)
+			return i
+		}
+		if strings.HasPrefix(fieldType, "uint") {
+			uintVal, _ := strconv.ParseUint(val, 10, 64)
+			return uintVal
+		}
+		if strings.HasPrefix(fieldType, "float") {
+			floatVal, _ := strconv.ParseFloat(val, 64)
+			return floatVal
+		}
+		if strings.HasPrefix(fieldType, "string") {
+			return val
+		}
+		if strings.HasPrefix(fieldType, "bool") {
+			if val == "true" {
+				return true
+			} else {
+				return false
+			}
+		}
+		return val
+	}
+	return nil
+}

swagger.go

@@ -9,11 +9,12 @@ package api_doc
 
 import (
 	"errors"
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/zhangdeman/consts"
-	"git.zhangdeman.cn/zhangdeman/serialize"
 	"net/http"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/consts"
+	"git.zhangdeman.cn/zhangdeman/serialize"
 )
 
 // ParseSwagger2 解析swagger2.0版本文档

swagger/parser.go

@@ -0,0 +1,649 @@
+// Package swagger ...
+//
+// Description : swagger ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-04-11 20:07
+package swagger
+
+import (
+	"errors"
+	"fmt"
+	"net/http"
+	"sort"
+	"strings"
+
+	apiDocDefine "git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/consts"
+	"git.zhangdeman.cn/zhangdeman/wrapper"
+)
+
+// HandleOpenapiDocRes ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:00 2025/2/26
+func HandleOpenapiDocRes(docRes *apiDocDefine.OpenapiDoc, ignoreApiTable map[string]bool, dataField string) ([]*apiDocDefine.ApiConfig, error) {
+	if nil == ignoreApiTable {
+		ignoreApiTable = make(map[string]bool)
+	}
+	hod := &handleOpenapiDoc{
+		docRes:         docRes,
+		parseRes:       make([]*apiDocDefine.ApiConfig, 0),
+		ignoreApiTable: ignoreApiTable,
+		dataField:      dataField,
+	}
+	if err := hod.Parse(); nil != err {
+		return nil, err
+	}
+	return hod.parseRes, nil
+}
+
+type handleOpenapiDoc struct {
+	docRes         *apiDocDefine.OpenapiDoc
+	parseRes       []*apiDocDefine.ApiConfig
+	ignoreApiTable map[string]bool
+	dataField      string
+}
+
+func (hod *handleOpenapiDoc) Parse() error {
+	// 排序, 保证输出顺序一致性
+	uriList := make([]string, 0)
+	for uri := range hod.docRes.Paths {
+		uriList = append(uriList, uri)
+	}
+	sort.Strings(uriList)
+	for _, uri := range uriList {
+		itemPath := hod.docRes.Paths[uri]
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodGet, itemPath.Get); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodPut, itemPath.Put); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodPost, itemPath.Post); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodHead, itemPath.Head); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodPatch, itemPath.Patch); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodDelete, itemPath.Delete); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodConnect, itemPath.Connect); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodOptions, itemPath.Options); nil != err {
+			return err
+		}
+		if err := hod.apiPathConfigToProjectConfig(uri, http.MethodTrace, itemPath.Trace); nil != err {
+			return err
+		}
+	}
+	return nil
+}
+
+// apiPathConfigToProjectConfig 解析请求方法
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 18:48 2025/2/26
+func (hod *handleOpenapiDoc) apiPathConfigToProjectConfig(uri string, method string, apiPathConfig *apiDocDefine.PathItemOperationConfig) error {
+	if hod.ignoreApiTable[fmt.Sprintf("%v_%v", strings.ToUpper(method), uri)] {
+		// 接口已存在
+		return nil
+	}
+	if apiPathConfig == nil {
+		return nil
+	}
+	requestContentTypeList := make([]string, 0)
+	if nil != apiPathConfig.RequestBody {
+		for contentType := range apiPathConfig.RequestBody.Content {
+			requestContentTypeList = append(requestContentTypeList, contentType)
+		}
+	}
+	if len(requestContentTypeList) == 0 {
+		requestContentTypeList = append(requestContentTypeList, consts.MimeTypeXWWWFormUrlencoded)
+	}
+	sort.Strings(requestContentTypeList)
+
+	tag := "未知分组"
+	if len(apiPathConfig.Tags) > 0 {
+		tag = apiPathConfig.Tags[0]
+	}
+	importUriConfig := &apiDocDefine.ApiConfig{
+		Tag:         tag,
+		Name:        apiPathConfig.Summary,
+		Uri:         uri,
+		Method:      strings.ToUpper(method),
+		ContentType: requestContentTypeList[0],
+		Description: apiPathConfig.Description,
+		ParamList:   make([]*apiDocDefine.ApiParamItem, 0),
+		ResultList:  make([]*apiDocDefine.ApiResultItem, 0),
+	}
+	// 解析公共的 Parameters , 任意请求方法都可能有 // TODO: 数组&对象递归处理
+	for _, itemParam := range apiPathConfig.Parameters {
+		importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+			Title:        itemParam.Name,
+			Name:         itemParam.Name,
+			Location:     hod.openapiDocLocationFormat(itemParam.In),
+			ParamType:    hod.openapiDocType2GoType(fmt.Sprintf("%v", itemParam.Schema.Type), itemParam.Schema.Format),
+			IsRequired:   itemParam.Required,
+			DefaultValue: "∂",
+			ExampleValue: "",
+			Description:  itemParam.Description,
+		})
+	}
+	// post 类请求 body
+	if err := hod.handleRequestBody(importUriConfig, apiPathConfig.RequestBody, requestContentTypeList[0]); nil != err {
+		return err
+	}
+	// 处理response
+	if err := hod.handleResponseBody(importUriConfig, apiPathConfig.Responses); nil != err {
+		return err
+	}
+	// 解析response
+	hod.parseRes = append(hod.parseRes, importUriConfig)
+	return nil
+}
+
+// handleRequestBody 解析request body
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 12:17 2025/2/27
+func (hod *handleOpenapiDoc) handleRequestBody(importUriConfig *apiDocDefine.ApiConfig, requestBodyData *apiDocDefine.RequestBody, selectRequestContentType string) error {
+	if nil == requestBodyData || nil == requestBodyData.Content {
+		return nil
+	}
+	if nil == requestBodyData.Content[selectRequestContentType] {
+		return fmt.Errorf("select content_type = %v is not found in requestBodyData.Content", selectRequestContentType)
+	}
+	requestBody := requestBodyData.Content[selectRequestContentType].Schema
+	if len(requestBody.Ref) == 0 {
+		return nil
+	}
+	requestBodyRequiredParamTable := map[string]bool{}
+	for _, itemParamName := range requestBody.Required {
+		requestBodyRequiredParamTable[itemParamName] = true
+	}
+	if len(requestBody.Ref) > 0 {
+		refCfg, err := hod.getResComponentsConfig(requestBody.Ref)
+		if nil != err {
+			return err
+		}
+		// ref 配置合并
+		if nil == requestBodyData.Content[selectRequestContentType].Schema.Properties {
+			requestBodyData.Content[selectRequestContentType].Schema.Properties = make(map[string]*apiDocDefine.Property)
+		}
+		for paramName, itemParam := range refCfg.Properties {
+			requestBodyData.Content[selectRequestContentType].Schema.Properties[paramName] = itemParam
+		}
+		for _, itemParamName := range refCfg.Required {
+			requestBodyRequiredParamTable[itemParamName] = true
+		}
+	}
+	for requestBodyParamName, requestBodyParamConfig := range requestBody.Properties {
+		// 对象、数组、引用递归解析
+		if err := hod.expendObjectOrArrayRequest(importUriConfig, requestBodyRequiredParamTable, "", "", requestBodyParamName, requestBodyParamConfig); nil != err {
+			return err
+		}
+	}
+	return nil
+}
+
+func (hod *handleOpenapiDoc) expendObjectOrArrayRequest(importUriConfig *apiDocDefine.ApiConfig, requestBodyRequiredParamTable map[string]bool, rootRef string, parentPath string, currentPropertyName string, currentProperty *apiDocDefine.Property) error {
+	if len(parentPath) > 0 {
+		currentPropertyName = parentPath + "." + currentPropertyName
+	}
+	defaultValue := wrapper.AnyDataType(currentProperty.Default).ToString().Value()
+	// 基础数据类型
+	if len(currentProperty.Properties) == 0 && currentProperty.Type != consts.SwaggerDataTypeObject && currentProperty.Type != consts.SwaggerDataTypeArray && len(currentProperty.Ref) == 0 {
+		importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+			Title:        currentPropertyName,
+			Name:         currentPropertyName,
+			Location:     consts.RequestDataLocationBody.String(),
+			ParamType:    hod.openapiDocType2GoType(fmt.Sprintf("%v", currentProperty.Type), currentProperty.Format),
+			IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+			DefaultValue: defaultValue,
+			ExampleValue: "",
+			Description:  currentProperty.Description,
+		})
+		return nil
+	}
+	// 处理数组(注意循环引用导致的递归死循环)
+	if currentProperty.Type == consts.SwaggerDataTypeArray {
+		if nil == currentProperty.Items {
+			if strings.HasSuffix(parentPath, ".[]") {
+				// 说明已经set过,不处理
+				return nil
+			}
+			importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+				Title:        currentPropertyName,
+				Name:         currentPropertyName,
+				Location:     consts.RequestDataLocationBody.String(),
+				ParamType:    consts.DataTypeSliceAny.String(),
+				IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+				DefaultValue: "",
+				ExampleValue: "",
+				Description:  currentProperty.Description,
+			})
+			return nil
+		}
+		// 数组类型, 如果是基础类型的数组, 直接返回, map 数组或嵌套数组层层展开
+		if currentProperty.Items.Type == consts.SwaggerDataTypeObject || currentProperty.Items.Type == consts.SwaggerDataTypeArray || len(currentProperty.Items.Ref) > 0 {
+			if !strings.HasSuffix(parentPath, ".[]") {
+				dataType := hod.openapiDocType2GoType(fmt.Sprintf("%v", currentProperty.Type), currentProperty.Format)
+				// 数组根key没设置过进行set
+				importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+					Title:        currentPropertyName,
+					Name:         currentPropertyName,
+					Location:     consts.RequestDataLocationBody.String(),
+					ParamType:    "[]" + dataType,
+					IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+					DefaultValue: defaultValue,
+					ExampleValue: "",
+					Description:  currentProperty.Description,
+				})
+			}
+
+			if len(currentProperty.Items.Ref) == 0 {
+				return nil
+			}
+			// 解析ref内容
+			refDefine, err := hod.getResComponentsConfig(currentProperty.Items.Ref)
+			if nil != err {
+				return err
+			}
+			if strings.Contains(rootRef, currentProperty.Items.Ref) {
+				dataType := consts.DataTypeAny.String()
+				// 循环引用
+				if refDefine.Type == consts.SwaggerDataTypeObject {
+					dataType = consts.DataTypeSliceMapStringAny.String()
+				} else if refDefine.Type == consts.SwaggerDataTypeArray {
+					dataType = consts.DataTypeSliceSlice.String()
+				}
+				importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+					Title:        currentPropertyName,
+					Name:         currentPropertyName,
+					Location:     consts.RequestDataLocationBody.String(),
+					ParamType:    dataType,
+					IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+					DefaultValue: defaultValue,
+					ExampleValue: "",
+					Description:  currentProperty.Description,
+				})
+				return nil
+			}
+			// 数组子项是数组或者对象
+			currentPropertyName = currentPropertyName + ".[]"
+			newRequiredTable := make(map[string]bool)
+			for _, item := range refDefine.Required {
+				newRequiredTable[item] = true
+			}
+			for itemName, itemVal := range refDefine.Properties {
+				if err = hod.expendObjectOrArrayRequest(importUriConfig, newRequiredTable, rootRef+currentProperty.Items.Ref, currentPropertyName, itemName, itemVal); nil != err {
+					return err
+				}
+			}
+			return nil
+		} else {
+			// 数组子项是基础类型
+			dataType := hod.openapiDocType2GoType(fmt.Sprintf("%v", currentProperty.Type), currentProperty.Format)
+			if len(currentProperty.Format) == 0 {
+				// 未指定format， dataType 添加 [] 前缀
+				dataType = "[]" + dataType
+			}
+			importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+				Title:        currentPropertyName,
+				Name:         currentPropertyName,
+				Location:     consts.RequestDataLocationBody.String(),
+				ParamType:    dataType,
+				IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+				DefaultValue: defaultValue,
+				ExampleValue: "",
+				Description:  currentProperty.Description,
+			})
+			return nil
+		}
+	}
+	if currentProperty.Type == consts.SwaggerDataTypeObject && currentProperty.Ref == "" && len(currentProperty.Properties) == 0 {
+		// 对象类型, 且未设置引用类型, 并且属性也为空, 对应any数据类型
+		importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+			Title:        currentPropertyName,
+			Name:         currentPropertyName,
+			Location:     consts.RequestDataLocationBody.String(),
+			ParamType:    consts.DataTypeAny.String(),
+			IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+			DefaultValue: defaultValue,
+			ExampleValue: "",
+			Description:  currentProperty.Description,
+		})
+		return nil
+	}
+	// 遍历 Properties
+	for fieldName, fieldVal := range currentProperty.Properties {
+		importUriConfig.ParamList = append(importUriConfig.ParamList, &apiDocDefine.ApiParamItem{
+			Title:        fieldName,
+			Name:         fieldName,
+			Location:     consts.RequestDataLocationBody.String(),
+			ParamType:    hod.openapiDocType2GoType(fmt.Sprintf("%v", fieldVal.Type), fieldVal.Format),
+			IsRequired:   requestBodyRequiredParamTable[currentPropertyName],
+			DefaultValue: defaultValue,
+			Description:  fieldVal.Description,
+		})
+		// 对象或者数组, 深度递归
+		if fieldVal.Type == consts.SwaggerDataTypeObject || fieldVal.Type == consts.SwaggerDataTypeArray {
+			if err := hod.expendObjectOrArrayRequest(importUriConfig, requestBodyRequiredParamTable, rootRef, currentPropertyName, fieldName, fieldVal); nil != err {
+				return err
+			}
+		}
+		if len(fieldVal.Ref) > 0 {
+			// 引用的结构体定义, 递归解析
+			if propertyResDefine, err := hod.getResComponentsConfig(fieldVal.Ref); nil != err {
+				return err
+			} else {
+				newRequiredTable := make(map[string]bool)
+				for _, item := range propertyResDefine.Required {
+					newRequiredTable[item] = true
+				}
+				for _, itemProperty := range propertyResDefine.Properties {
+					if err = hod.expendObjectOrArrayRequest(importUriConfig, newRequiredTable, rootRef+fieldVal.Ref, currentPropertyName, fieldName, itemProperty); nil != err {
+						return err
+					}
+				}
+			}
+		}
+	}
+	return nil
+}
+
+// handleResponseBody 解析响应body
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 13:44 2025/2/27
+func (hod *handleOpenapiDoc) handleResponseBody(importUriConfig *apiDocDefine.ApiConfig, requestBodyTable map[string]*apiDocDefine.Response) error {
+	if nil == requestBodyTable || nil == requestBodyTable["200"] {
+		return nil
+	}
+	if len(requestBodyTable["200"].Content) == 0 {
+		// 无返回值
+		return nil
+	}
+	contentTypeList := []string{}
+	for itemContentType := range requestBodyTable["200"].Content {
+		contentTypeList = append(contentTypeList, itemContentType)
+	}
+	if len(contentTypeList) == 0 {
+		contentTypeList = append(contentTypeList, consts.MimeTypeJson)
+	}
+	sort.Strings(contentTypeList)
+	selectResponseContentType := contentTypeList[0]
+	responseBodyData := requestBodyTable["200"].Content[selectResponseContentType].Schema
+	// 处理properties
+	if hod.dataField == "" {
+		// 未指定数据字段
+		for resultName, itemResult := range responseBodyData.Properties {
+			if err := hod.expendObjectOrArrayPath(importUriConfig, "", "", resultName, itemResult); nil != err {
+				return err
+			}
+		}
+	} else {
+		// 指定数据字段
+		fieldConfig := responseBodyData.Properties[hod.dataField]
+		if nil == fieldConfig {
+			return fmt.Errorf("data_field=%v 在相应body中不存在, uri=%v", hod.dataField, importUriConfig.Uri)
+		}
+		for fieldName, fieldVal := range fieldConfig.Properties {
+			// 引用的结构体定义, 递归解析
+			if err := hod.expendObjectOrArrayPath(importUriConfig, "", "", fieldName, fieldVal); nil != err {
+				return err
+			}
+		}
+	}
+
+	if len(responseBodyData.Ref) == 0 {
+		return nil
+	}
+	refCfg, err := hod.getResComponentsConfig(responseBodyData.Ref)
+	if nil != err {
+		return err
+	}
+	// ref 配置合并
+	for resultName, itemResult := range refCfg.Properties {
+		if err = hod.expendObjectOrArrayPath(importUriConfig, responseBodyData.Ref, "", resultName, itemResult); nil != err {
+			return err
+		}
+	}
+	return nil
+}
+
+// expendObjectOrArrayPath 展开ref对象路径
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 15:28 2025/4/8
+func (hod *handleOpenapiDoc) expendObjectOrArrayPath(importUriConfig *apiDocDefine.ApiConfig, rootRef string, parentPath string, currentPropertyName string, currentProperty *apiDocDefine.Property) error {
+	if len(parentPath) > 0 {
+		currentPropertyName = parentPath + "." + currentPropertyName
+	}
+	defaultValue := wrapper.AnyDataType(currentProperty.Default).ToString().Value()
+	// 基础数据类型
+	if len(currentProperty.Properties) == 0 && currentProperty.Type != consts.SwaggerDataTypeObject && currentProperty.Type != consts.SwaggerDataTypeArray && len(currentProperty.Ref) == 0 {
+		importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+			Title:        currentPropertyName,
+			DataPath:     currentPropertyName,
+			DataLocation: consts.RequestDataLocationBody.String(),
+			DataType:     hod.openapiDocType2GoType(fmt.Sprintf("%v", currentProperty.Type), currentProperty.Format),
+			DefaultValue: defaultValue,
+			ExampleValue: defaultValue,
+			Description:  currentProperty.Description,
+		})
+		return nil
+	}
+	// 处理数组(注意循环引用导致的递归死循环)
+	if currentProperty.Type == consts.SwaggerDataTypeArray {
+		if nil == currentProperty.Items {
+			if strings.HasSuffix(parentPath, ".[]") {
+				// 说明已经set过,不处理
+				return nil
+			}
+			importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+				Title:        currentPropertyName,
+				DataPath:     currentPropertyName,
+				DataLocation: consts.ResponseDataLocationBody.String(),
+				DataType:     consts.DataTypeSliceAny.String(),
+				DefaultValue: defaultValue,
+				ExampleValue: defaultValue,
+				Description:  currentProperty.Description,
+			})
+			return nil
+		}
+		// 数组类型, 如果是基础类型的数组, 直接返回, map 数组或嵌套数组层层展开
+		if currentProperty.Items.Type == consts.SwaggerDataTypeObject || currentProperty.Items.Type == consts.SwaggerDataTypeArray || len(currentProperty.Items.Ref) > 0 {
+			if !strings.HasSuffix(parentPath, ".[]") {
+				// 数组根key没设置过进行set
+				importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+					Title:        currentPropertyName,
+					DataPath:     currentPropertyName,
+					DataLocation: consts.RequestDataLocationBody.String(),
+					DataType:     consts.DataTypeSliceAny.String(),
+					DefaultValue: defaultValue,
+					ExampleValue: defaultValue,
+					Description:  currentProperty.Description,
+				})
+			}
+
+			if len(currentProperty.Items.Ref) == 0 {
+				return nil
+			}
+			// 解析ref内容
+			refDefine, err := hod.getResComponentsConfig(currentProperty.Items.Ref)
+			if nil != err {
+				return err
+			}
+			if strings.Contains(rootRef, currentProperty.Items.Ref) {
+				dataType := consts.DataTypeAny.String()
+				// 循环引用
+				if refDefine.Type == consts.SwaggerDataTypeObject {
+					dataType = consts.DataTypeSliceMapStringAny.String()
+				} else if refDefine.Type == consts.SwaggerDataTypeArray {
+					dataType = consts.DataTypeSliceSlice.String()
+				}
+				importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+					Title:        currentPropertyName,
+					DataPath:     currentPropertyName,
+					DataLocation: consts.RequestDataLocationBody.String(),
+					DataType:     dataType,
+					DefaultValue: defaultValue,
+					ExampleValue: defaultValue,
+					Description:  currentProperty.Description,
+				})
+				return nil
+			}
+			// 数组子项是数组或者对象
+			currentPropertyName = currentPropertyName + ".[]"
+
+			for itemName, itemVal := range refDefine.Properties {
+				if err = hod.expendObjectOrArrayPath(importUriConfig, rootRef+currentProperty.Items.Ref, currentPropertyName, itemName, itemVal); nil != err {
+					return err
+				}
+			}
+			return nil
+		} else {
+			// 数组子项是基础类型
+			dataType := hod.openapiDocType2GoType(fmt.Sprintf("%v", currentProperty.Type), currentProperty.Format)
+			if len(currentProperty.Format) == 0 {
+				// 未指定format， dataType 添加 [] 前缀
+				dataType = "[]" + dataType
+			}
+			importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+				Title:        currentPropertyName,
+				DataPath:     currentPropertyName,
+				DataLocation: consts.RequestDataLocationBody.String(),
+				DataType:     dataType,
+				DefaultValue: defaultValue,
+				ExampleValue: defaultValue,
+				Description:  currentProperty.Description,
+			})
+			return nil
+		}
+	}
+	if currentProperty.Type == consts.SwaggerDataTypeObject && currentProperty.Ref == "" && len(currentProperty.Properties) == 0 {
+		// 对象类型, 且未设置引用类型, 并且属性也为空, 对应any数据类型
+		importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+			Title:        currentPropertyName,
+			DataPath:     currentPropertyName,
+			DataLocation: consts.RequestDataLocationBody.String(),
+			DataType:     consts.DataTypeAny.String(),
+			DefaultValue: defaultValue,
+			ExampleValue: defaultValue,
+			Description:  currentProperty.Description,
+		})
+		return nil
+	}
+	// 遍历 Properties
+	for fieldName, fieldVal := range currentProperty.Properties {
+		importUriConfig.ResultList = append(importUriConfig.ResultList, &apiDocDefine.ApiResultItem{
+			Title:        fieldName,
+			DataPath:     fieldName,
+			DataLocation: consts.RequestDataLocationBody.String(),
+			DataType:     hod.openapiDocType2GoType(fmt.Sprintf("%v", fieldVal.Type), fieldVal.Format),
+			Description:  fieldVal.Description,
+			DefaultValue: defaultValue,
+			ExampleValue: defaultValue,
+		})
+		// 对象或者数组, 深度递归
+		if fieldVal.Type == consts.SwaggerDataTypeObject || fieldVal.Type == consts.SwaggerDataTypeArray {
+			if err := hod.expendObjectOrArrayPath(importUriConfig, rootRef, currentPropertyName, fieldName, fieldVal); nil != err {
+				return err
+			}
+		}
+		if len(fieldVal.Ref) > 0 {
+			// 引用的结构体定义, 递归解析
+			if propertyResDefine, err := hod.getResComponentsConfig(fieldVal.Ref); nil != err {
+				return err
+			} else {
+				for _, itemProperty := range propertyResDefine.Properties {
+					if err = hod.expendObjectOrArrayPath(importUriConfig, rootRef+fieldVal.Ref, currentPropertyName, fieldName, itemProperty); nil != err {
+						return err
+					}
+				}
+			}
+		}
+	}
+	return nil
+}
+
+// getResComponentsConfig 获取ref指向components的定义
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 11:17 2025/2/27
+func (hod *handleOpenapiDoc) getResComponentsConfig(ref string) (*apiDocDefine.Schema, error) {
+	refKey := strings.TrimPrefix(ref, "#/components/schemas/")
+	if _, exist := hod.docRes.Components.Schemas[refKey]; exist {
+		return hod.docRes.Components.Schemas[refKey], nil
+	}
+	// apifox 导出的文档, ref 部分, 空格被转义, 但是 components 定义中空格未被转义
+	refKey = strings.ReplaceAll(refKey, "%20", " ")
+	if _, exist := hod.docRes.Components.Schemas[refKey]; exist {
+		return hod.docRes.Components.Schemas[refKey], nil
+	}
+	return nil, errors.New("components not found : " + refKey)
+}
+
+// openapiDocLocationFormat 文档数据位置转为网关的数据位置
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 21:06 2025/2/26
+func (hod *handleOpenapiDoc) openapiDocLocationFormat(openapiDocLocation string) string {
+	openapiDocLocation = strings.ToUpper(openapiDocLocation)
+	for _, itemLocation := range consts.RequestDataLocationList {
+		if strings.ToUpper(itemLocation.Value.String()) == openapiDocLocation {
+			return itemLocation.Value.String()
+		}
+	}
+	// 没有明确配置参数位置：query/header/cookie/body等, 会自动按照请求尝试获取
+	return consts.RequestDataLocationAny.String()
+}
+
+// openapiDocType2GoType 文档数据类型转为网关数据类型
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 21:07 2025/2/26
+func (hod *handleOpenapiDoc) openapiDocType2GoType(openapiDocType string, formatType string) string {
+	openapiDocType = strings.ToLower(openapiDocType)
+	if formatType == "" {
+		formatType = openapiDocType
+	}
+	formatType = strings.ReplaceAll(strings.ReplaceAll(formatType, " ", ""), "interface{}", "any")
+	for _, itemType := range consts.DataTypeList {
+		if itemType.Value.String() == formatType {
+			return itemType.Value.String()
+		}
+	}
+	switch openapiDocType {
+	case consts.SwaggerDataTypeString:
+		return consts.DataTypeString.String()
+	case consts.SwaggerDataTypeInteger:
+		return consts.DataTypeInt.String()
+	case consts.SwaggerDataTypeNumber:
+		return consts.DataTypeFloat64.String()
+	case consts.SwaggerDataTypeArray:
+		return consts.DataTypeSliceAny.String()
+	case consts.SwaggerDataTypeObject:
+		return consts.DataTypeMapStrAny.String()
+	case consts.SwaggerDataTypeBoolean:
+		return consts.DataTypeBool.String()
+	}
+	// 兜底数据类型any
+	return consts.DataTypeAny.String()
+}

swagger/run.go

@@ -8,12 +8,14 @@
 package swagger
 
 import (
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/gateway/api-doc/util"
-	"git.zhangdeman.cn/zhangdeman/consts"
-	"git.zhangdeman.cn/zhangdeman/wrapper"
 	"net/http"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/api-doc/enums"
+	"git.zhangdeman.cn/zhangdeman/api-doc/util"
+	"git.zhangdeman.cn/zhangdeman/consts"
+	"git.zhangdeman.cn/zhangdeman/wrapper"
 )
 
 // Generate 生成文档
@@ -25,7 +27,7 @@ func Generate(docConfig *define.SwaggerInput) (*define.Swagger, error) {
 	formatDocConfig(docConfig)
 	swaggerInfo := &define.Swagger{
 		Schemes:     docConfig.Schemes,
-		Swagger:     consts.SwaggerDocVersion2,
+		Swagger:     enums.SwaggerDocVersion2.String(),
 		Host:        docConfig.Host,
 		BasePath:    docConfig.BasePath,
 		Info:        docConfig.Info,
@@ -228,7 +230,7 @@ func generateParameterDefinitions(swaggerInfo *define.Swagger, uri string, paren
 		if subPathArr[1] == "[]" {
 			swaggerInfo.Definitions[parentPath].Properties[subPathArr[0]] = &define.SwaggerDefinitionProperty{
 				Description: paramConfig.Description,
-				Type:        consts.SwaggerDataTypeArray,
+				Type:        enums.SwaggerDataTypeArray.String(),
 				Items: &define.SwaggerDefinitionPropertyItem{
 					Type: util.GetSwaggerType(paramConfig.Type),
 					Ref:  "",
@@ -242,7 +244,7 @@ func generateParameterDefinitions(swaggerInfo *define.Swagger, uri string, paren
 			} else {
 				swaggerInfo.Definitions[parentPath].Properties[subPathArr[0]] = &define.SwaggerDefinitionProperty{
 					Description: "参数描述",
-					Type:        consts.SwaggerDataTypeObject,
+					Type:        enums.SwaggerDataTypeObject.String(),
 					AllOf: []map[string]string{
 						{
 							consts.SwaggerRefKey: getRefValue(parentPath + "." + subPathArr[0]),
@@ -288,7 +290,7 @@ func generateParameterDefinitions(swaggerInfo *define.Swagger, uri string, paren
 			AllOf:       nil,
 		}
 		if itemSwaggerDefinition.Type == consts.SwaggerDataTypeObject {
-			itemSwaggerDefinition.AllOf = []map[string]string{map[string]string{
+			itemSwaggerDefinition.AllOf = []map[string]string{{
 				consts.SwaggerRefKey: getRefValue(parentPath + "." + subPathArr[0]),
 			}}
 		} else if itemSwaggerDefinition.Type == consts.SwaggerDataTypeArray {

swagger/run_test.go

@@ -10,10 +10,10 @@ package swagger
 import (
 	"encoding/json"
 	"fmt"
-	"git.zhangdeman.cn/gateway/api-doc/define"
-	"git.zhangdeman.cn/zhangdeman/consts"
 	"net/http"
 	"testing"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
 )
 
 func TestGenerate(t *testing.T) {
@@ -37,7 +37,7 @@ func TestGenerate(t *testing.T) {
 			Version: "",
 		},
 		PathConfigList: []*define.SwaggerPathInput{
-			&define.SwaggerPathInput{
+			{
 				Uri:         "/test",
 				Method:      http.MethodPost,
 				ContentType: consts.MimeTypeJson,
@@ -45,7 +45,7 @@ func TestGenerate(t *testing.T) {
 				Description: "测试接口",
 				TagList:     []string{"测试接口生成"},
 				ParameterList: []*define.SwaggerParameterInput{
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeString.String(),
 						Description: "姓名",
 						Name:        "name",
@@ -53,7 +53,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    []interface{}{"zhang", "de", "man"},
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeString.String(),
 						Description: "性别",
 						Name:        "person.sex",
@@ -61,7 +61,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    []interface{}{"man", "woman", "other"},
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeString.String(),
 						Description: "性别",
 						Name:        "person.job.list.[]",
@@ -69,7 +69,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    nil,
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeInt.String(),
 						Description: "年份",
 						Name:        "person.job.year.[]",
@@ -77,7 +77,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    nil,
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeInt.String(),
 						Description: "测试工作",
 						Name:        "person.job.test",
@@ -85,7 +85,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    nil,
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeInt.String(),
 						Description: "年龄",
 						Name:        "age",
@@ -93,7 +93,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    []interface{}{18, 19, 20},
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeInt.String(),
 						Description: "年龄",
 						Name:        "test_list.[].age",
@@ -101,7 +101,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    []interface{}{18, 19, 20},
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeString.String(),
 						Description: "年龄",
 						Name:        "test_list.[].name",
@@ -109,7 +109,7 @@ func TestGenerate(t *testing.T) {
 						Required:    true,
 						EnumList:    nil,
 					},
-					&define.SwaggerParameterInput{
+					{
 						Type:        consts.DataTypeMapAnyAny.String(),
 						Description: "测试global_map",
 						Name:        "obj",
@@ -119,23 +119,23 @@ func TestGenerate(t *testing.T) {
 					},
 				},
 				ResponseList: []*define.SwaggerResponseInput{
-					&define.SwaggerResponseInput{
+					{
 						Code:        "200",
 						Description: "成功",
 						List: []*define.SwaggerResponseItemInput{
-							&define.SwaggerResponseItemInput{
+							{
 								Type:        consts.DataTypeString.String(),
 								Description: "姓名",
 								Field:       "nick_name",
 								IsRequired:  false,
 							},
-							&define.SwaggerResponseItemInput{
+							{
 								Type:        consts.DataTypeString.String(),
 								Description: "昵称",
 								Field:       "person.nick_name",
 								IsRequired:  false,
 							},
-							&define.SwaggerResponseItemInput{
+							{
 								Type:        consts.DataTypeMapAnyAny.String(),
 								Description: "测试返回生成map",
 								Field:       "obj",

swagger_ui.go

@@ -8,31 +8,24 @@
 package api_doc
 
 import (
-	"embed"
 	"fmt"
-	"git.zhangdeman.cn/gateway/api-doc/define"
+	"net/http"
+	"path/filepath"
+	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/api-doc/define"
+	"git.zhangdeman.cn/zhangdeman/api-doc/enums"
+	"git.zhangdeman.cn/zhangdeman/api-doc/theme"
 	"git.zhangdeman.cn/zhangdeman/consts"
 	"github.com/gin-gonic/gin"
 	knife4goFiles "github.com/go-webtools/knife4go"
 	knife4goGin "github.com/go-webtools/knife4go/gin"
 	swaggerFiles "github.com/swaggo/files"
 	ginSwagger "github.com/swaggo/gin-swagger"
-	"net/http"
-	"strings"
 )
 
-//go:embed ydoc-lucky-ui/*
-var ydocUIFiles embed.FS
-
-//go:embed redoc-free/index.html
-var redocFreeIndexContent string
-
 // NewSwaggerUI ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:21 2025/2/15
-func NewSwaggerUI(info *define.Info, servers []*define.ServerItem, uiTheme string) *SwaggerUI {
+func NewSwaggerUI(info *define.Info, servers []*define.ServerItem, uiTheme enums.SwaggerUITheme) *SwaggerUI {
 	return &SwaggerUI{
 		docInstance: NewOpenapiDoc(info, servers),
 		uiTheme:     uiTheme,
@@ -40,26 +33,18 @@ func NewSwaggerUI(info *define.Info, servers []*define.ServerItem, uiTheme strin
 }
 
 type SwaggerUI struct {
-	docInstance *Generate // 文档实例
-	uiTheme     string    // 文档主题, swaggerUI / knife4go, 默认 knife4go
+	docInstance *Generate            // 文档实例
+	uiTheme     enums.SwaggerUITheme // 文档主题, swaggerUI / knife4go, 默认 knife4go
 	router      *gin.Engine
 	baseUri     string
 }
 
 // DocInstance 文档实例
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 13:23 2025/2/16
 func (su *SwaggerUI) DocInstance() *Generate {
 	return su.docInstance
 }
 
 // RegisterHandler ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 15:00 2025/2/16
 func (su *SwaggerUI) RegisterHandler(router *gin.Engine, baseUri string) {
 	su.router = router
 	baseUri = strings.TrimRight(baseUri, "/")
@@ -79,7 +64,7 @@ func (su *SwaggerUI) RegisterHandler(router *gin.Engine, baseUri string) {
 				{
 					"name":           "服务文档",
 					"url":            "doc.json",
-					"swaggerVersion": consts.SwaggerDocVersion3,
+					"swaggerVersion": enums.SwaggerDocVersion3.String(),
 				},
 			})
 			ctx.Abort()
@@ -91,7 +76,7 @@ func (su *SwaggerUI) RegisterHandler(router *gin.Engine, baseUri string) {
 			{
 				"name":           "服务文档",
 				"url":            baseUri + "/doc.json",
-				"swaggerVersion": consts.SwaggerDocVersion3,
+				"swaggerVersion": enums.SwaggerDocVersion3.String(),
 			},
 		})
 		// ctx.JSON(http.StatusOK, swaggerInstance.docInstance.Data())
@@ -99,20 +84,16 @@ func (su *SwaggerUI) RegisterHandler(router *gin.Engine, baseUri string) {
 }
 
 // Handler 访问文档的接口处理
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:34 2025/2/15
 func (su *SwaggerUI) Handler() func(ctx *gin.Context) {
 	switch su.uiTheme {
-	case define.SwaggerUIThemeKnife4go:
+	case enums.SwaggerUIThemeKnife4go:
 		return su.HandleKnife4goUI()
-	case define.SwaggerUIThemeYDocLucky:
+	case enums.SwaggerUIThemeYDocLucky:
 		// YDoc-Lucky-UI 主题处理
 		return su.HandleLuckyUI()
-	case define.SwaggerUIThemeDefault:
+	case enums.SwaggerUIThemeDefault:
 		return su.HandleSwaggerUI()
-	case define.SwaggerUIThemeRedocFree:
+	case enums.SwaggerUIThemeRedocFree:
 		// redoc免费版
 		return su.HandleRedocFreeUI()
 	default:
@@ -121,15 +102,11 @@ func (su *SwaggerUI) Handler() func(ctx *gin.Context) {
 }
 
 // HandleLuckyUI ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:04 2025/2/16
 func (su *SwaggerUI) HandleLuckyUI() func(ctx *gin.Context) {
 	// su.router.StaticFS(su.baseUri+"/assets", http.FS(ydocUIFiles))
 	return func(ctx *gin.Context) {
 		fileRealPath := strings.TrimPrefix(ctx.Request.RequestURI, su.baseUri)
-		byteData, _ := ydocUIFiles.ReadFile(define.SwaggerUIThemeYDocLucky + fileRealPath)
+		byteData, _ := theme.YdocUIFiles.ReadFile(filepath.Join(enums.SwaggerUIThemeYDocLucky.String(), fileRealPath))
 		if strings.HasSuffix(ctx.Request.RequestURI, "html") {
 			byteData = []byte(strings.ReplaceAll(string(byteData), "{{BASE_URI}}", su.baseUri))
 		}
@@ -140,17 +117,13 @@ func (su *SwaggerUI) HandleLuckyUI() func(ctx *gin.Context) {
 		} else if strings.HasSuffix(ctx.Request.RequestURI, "js") {
 			contentType = "application/javascript"
 		}
-		ctx.Header("Content-Type", contentType)
+		ctx.Header(consts.HeaderKeyContentType.String(), contentType)
 		ctx.String(http.StatusOK, string(byteData))
 		ctx.Abort()
 	}
 }
 
 // HandleKnife4goUI ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:38 2025/2/15
 func (su *SwaggerUI) HandleKnife4goUI() func(ctx *gin.Context) {
 	resetOption := func(cfg *knife4goGin.Config) {
 		if nil == cfg {
@@ -162,19 +135,11 @@ func (su *SwaggerUI) HandleKnife4goUI() func(ctx *gin.Context) {
 }
 
 // HandleSwaggerUI ...
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:41 2025/2/15
 func (su *SwaggerUI) HandleSwaggerUI() func(ctx *gin.Context) {
 	return ginSwagger.WrapHandler(swaggerFiles.Handler)
 }
 
 // HandleRedocFreeUI 处理redoc_free主题
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 16:40 2025/2/18
 func (su *SwaggerUI) HandleRedocFreeUI() func(ctx *gin.Context) {
 	return func(ctx *gin.Context) {
 		// TODO : 这部分数据支持外部传参替换
@@ -185,10 +150,10 @@ func (su *SwaggerUI) HandleRedocFreeUI() func(ctx *gin.Context) {
 			"{{REDOC_STANDALONE_JS}}": "https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js",
 		}
 		for k, v := range replaceTable {
-			redocFreeIndexContent = strings.ReplaceAll(redocFreeIndexContent, k, v)
+			theme.RedocFreeIndexContent = strings.ReplaceAll(theme.RedocFreeIndexContent, k, v)
 		}
-		ctx.Header("Content-Type", "text/html; charset=utf-8")
-		ctx.String(http.StatusOK, redocFreeIndexContent)
+		ctx.Header(consts.HeaderKeyContentType.String(), "text/html; charset=utf-8")
+		ctx.String(http.StatusOK, theme.RedocFreeIndexContent)
 		ctx.Abort()
 	}
 }

theme/embed.go

@@ -0,0 +1,16 @@
+// Package theme ...
+//
+// Description : theme ...
+//
+// Author : go_developer@163.com<白茶清欢>
+//
+// Date : 2025-08-23 09:23
+package theme
+
+import "embed"
+
+//go:embed ydoc-lucky-ui/*
+var YdocUIFiles embed.FS
+
+//go:embed redoc-free/index.html
+var RedocFreeIndexContent string

util/tool.go

@@ -8,9 +8,10 @@
 package util
 
 import (
-	"git.zhangdeman.cn/zhangdeman/consts"
 	"net/http"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/consts"
 )
 
 // GetParameterDefaultLocation 获取参数的默认位置
@@ -50,15 +51,41 @@ func GetParameterDefaultLocation(requestMethod string) string {
 //
 // Date : 12:23 2024/4/22
 func GetSwaggerType(inputType string) string {
-	convertTable := map[string]string{
-		consts.DataTypeString.String(): "string",
-		consts.DataTypeInt.String():    "integer",
-		consts.DataTypeUint.String():   "integer",
-		consts.DataTypeFloat.String():  "number",
-		consts.DataTypeBool.String():   "boolean",
+	for _, itemType := range consts.DataTypeBaseInt {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeInteger
+		}
 	}
-	if _, exist := convertTable[inputType]; exist {
-		return convertTable[inputType]
+	for _, itemType := range consts.DataTypeBaseUint {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeInteger
+		}
+	}
+	for _, itemType := range consts.DataTypeBaseFloat {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeDouble
+		}
+	}
+	for _, itemType := range consts.DataTypeBaseString {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeString
+		}
+	}
+	for _, itemType := range consts.DataTypeBaseString {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeString
+		}
+	}
+	for _, itemType := range consts.DataTypeBaseBool {
+		if itemType.String() == inputType {
+			return consts.SwaggerDataTypeBoolean
+		}
+	}
+	if strings.HasPrefix(inputType, "[]") {
+		return consts.SwaggerDataTypeArray
+	}
+	if strings.HasPrefix(inputType, "map") {
+		return consts.SwaggerDataTypeObject
 	}
 	return inputType
 }

validate_rule.go

@@ -8,10 +8,11 @@
 package api_doc
 
 import (
-	"git.zhangdeman.cn/zhangdeman/consts"
 	"reflect"
 	"strconv"
 	"strings"
+
+	"git.zhangdeman.cn/zhangdeman/consts"
 )
 
 var (
@@ -33,10 +34,6 @@ func (r validateRule) IsRequired(structField reflect.StructField) bool {
 }
 
 // Enum 获取枚举值
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 17:23 2025/2/13
 func (r validateRule) Enum(structField reflect.StructField) []any {
 	ruleTable := r.getValidateRuleTable(structField)
 	oneOfValue, _ := ruleTable[consts.ValidatorRuleCommonOneOf.String()]
@@ -79,10 +76,6 @@ func (r validateRule) Enum(structField reflect.StructField) []any {
 }
 
 // Minimum 最小值
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 21:51 2025/2/18
 func (r validateRule) Minimum(structField reflect.StructField) *int64 {
 	ruleTable := r.getValidateRuleTable(structField)
 	var (
@@ -118,16 +111,12 @@ func (r validateRule) Minimum(structField reflect.StructField) *int64 {
 }
 
 // Maximum 最大值
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 22:00 2025/2/18
 func (r validateRule) Maximum(structField reflect.StructField) *int64 {
 	ruleTable := r.getValidateRuleTable(structField)
 	var (
 		err                      error
-		maxVal, gleVal           int64
-		maxStr, gleStr           string
+		maxVal, lteVal           int64
+		maxStr, lteStr           string
 		maxStrExist, gleStrExist bool
 	)
 	if maxStr, maxStrExist = ruleTable[consts.ValidatorRuleCommonMax.String()]; maxStrExist && len(maxStr) > 0 {
@@ -135,9 +124,9 @@ func (r validateRule) Maximum(structField reflect.StructField) *int64 {
 			panic("validate rule min val = " + maxStr + " : " + err.Error())
 		}
 	}
-	if gleStr, gleStrExist = ruleTable[consts.ValidateRuleLte.String()]; gleStrExist && len(gleStr) > 0 {
-		if gleVal, err = strconv.ParseInt(gleStr, 10, 64); nil != err {
-			panic("validate rule gte val = " + gleStr + " : " + err.Error())
+	if lteStr, gleStrExist = ruleTable[consts.ValidateRuleLte.String()]; gleStrExist && len(lteStr) > 0 {
+		if lteVal, err = strconv.ParseInt(lteStr, 10, 64); nil != err {
+			panic("validate rule gte val = " + lteStr + " : " + err.Error())
 		}
 	}
 	if !maxStrExist && !gleStrExist {
@@ -145,22 +134,18 @@ func (r validateRule) Maximum(structField reflect.StructField) *int64 {
 		return nil
 	}
 	if len(maxStr) > 0 {
-		if len(gleStr) > 0 {
-			if gleVal > maxVal {
-				return &gleVal
+		if len(lteStr) > 0 {
+			if lteVal > maxVal {
+				return &lteVal
 			}
 			return &maxVal
 		}
 		return &maxVal
 	}
-	return &gleVal
+	return &lteVal
 }
 
 // getValidateRuleTable 解析验证规则表
-//
-// Author : go_developer@163.com<白茶清欢>
-//
-// Date : 15:29 2025/2/13
 func (r validateRule) getValidateRuleTable(structField reflect.StructField) map[string]string {
 	res := map[string]string{}
 	ruleStr := ParseStructFieldTag.GetValidateRule(structField)