gateway/api-doc
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

增加全局安全类参数解析

Browse Source
This commit is contained in:
白茶清欢 2024-12-25 14:59:14 +08:00
parent e70634a318
commit 368fb02efc
4 changed files with 40 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
common.go
View File

@ -57,7 +57,7 @@ func GetDataType(docParamType string, formatType string) consts.DataType {
return consts.DataTypeInt
}
return consts.DataTypeUint
case "string":
case "string", "apikey":
return consts.DataTypeString
case "object":
return consts.DataTypeMapStrAny

9
define/generate.go
View File

@ -15,10 +15,11 @@ import "regexp"
//
// Date : 10:30 2024/12/24
type DocParseResult struct {
Domain string `json:"domain"` // 域名
Title string `json:"title"` // 标题
Description string `json:"description"` // 描述
UriList []*UriBaseConfig `json:"uri_list"` // 接口列表
Domain string `json:"domain"` // 域名
Title string `json:"title"` // 标题
Description string `json:"description"` // 描述
UriList []*UriBaseConfig `json:"uri_list"` // 接口列表
GlobalSecurityParamList []*ParamConfig `json:"global_security_param_list"` // 全局安全类参数配置
}
// UriBaseConfig 添加接口时的基础配置

17
define/swagger.go
View File

@ -101,14 +101,15 @@ type SwaggerDefinitionPropertyItem struct {
//
// Date : 16:12 2024/4/19
type Swagger struct {
Schemes []string `json:"schemes"`
Swagger string `json:"swagger"` // swagger版本 - 2.0
Host string `json:"host"` // 服务域名
BasePath string `json:"basePath"` // 基础path
Info Info `json:"info"` // 文档描述信息
Paths map[string]map[string]*SwaggerPathConfig `json:"paths"` // 接口列表 : 接口 => 请求方法 => 请求配置
Definitions map[string]*SwaggerDefinition `json:"definitions"` // 数据定义
Responses map[string]*SwaggerPathConfigResponse `json:"responses"` // 响应结构列表
Schemes []string `json:"schemes"`
Swagger string `json:"swagger"` // swagger版本 - 2.0
Host string `json:"host"` // 服务域名
BasePath string `json:"basePath"` // 基础path
Info Info `json:"info"` // 文档描述信息
Paths map[string]map[string]*SwaggerPathConfig `json:"paths"` // 接口列表 : 接口 => 请求方法 => 请求配置
Definitions map[string]*SwaggerDefinition `json:"definitions"` // 数据定义
Responses map[string]*SwaggerPathConfigResponse `json:"responses"` // 响应结构列表
SecurityDefinitions map[string]*SwaggerPathConfigParameter `json:"securityDefinitions"` // 安全选项
}
// SwaggerInput ...

29
swagger.go
View File

@ -31,17 +31,38 @@ func ParseSwagger2(docContent []byte) (*define.DocParseResult, error) {
return nil, errors.New("parse swagger json fail : " + err.Error())
}
docResult := &define.DocParseResult{
Domain: swaggerDoc.Host,
Title: swaggerDoc.Info.Title,
Description: swaggerDoc.Info.Description,
UriList: make([]*define.UriBaseConfig, 0),
Domain: swaggerDoc.Host,
Title: swaggerDoc.Info.Title,
Description: swaggerDoc.Info.Description,
UriList: make([]*define.UriBaseConfig, 0),
GlobalSecurityParamList: make([]*define.ParamConfig, 0),
}
if docResult.UriList, err = buildUriList(&swaggerDoc); nil != err {
return nil, err
}
docResult.GlobalSecurityParamList = buildSwagger2GlobalSecurityParamList(&swaggerDoc)
return docResult, nil
}
// buildSwagger2GlobalSecurityParamList 构建全局安全类参数
func buildSwagger2GlobalSecurityParamList(swaggerDoc *define.Swagger) []*define.ParamConfig {
result := make([]*define.ParamConfig, 0)
for paramName, paramConfig := range swaggerDoc.SecurityDefinitions {
if len(paramConfig.In) == 0 {
continue
}
result = append(result, &define.ParamConfig{
Location: GetParamLocation(paramConfig.In).String(),
Path: paramName,
Type: GetDataType(paramConfig.Type, "").String(),
Title: paramName,
Description: paramConfig.Description,
Required: false,
})
}
return result
}
// 解析uri列表
func buildUriList(swaggerDoc *define.Swagger) ([]*define.UriBaseConfig, error) {
uriList := make([]*define.UriBaseConfig, 0)