88dfe5c640
iotlcm-openapi:对外 OpenAPI 网关(V3 接口 + 旧版兼容接口)。
- Go module:iotlcm-openapi → git.5iot.com/iotlcm-public/iotlcm-openapi(178 文件)
- 凭据与地址脱敏:JWT signingKey、MySQL DSN、Redis 口令、
RabbitMQ DSN 全部改为 ${*} 占位;私网 IP → 文档地址段
- 7 处真实手机号 → 合法 11 位编造号
- 启动 banner 统一 IOTLCM 方块字 + 社区惯例署名
- 移除内部资产:CI 触发器
- Dockerfile 改用公共基础镜像,移除 GOPRIVATE 内网设置
- README 重写(原为 GoFrame 模板占位文案),补 Apache-2.0 LICENSE,
LF 行尾 + .gitattributes
93 lines
2.5 KiB
Go
93 lines
2.5 KiB
Go
// package convert
|
|
// @Link https://github.com/xiujiecn/xiu-admin
|
|
// @Copyright Copyright (c) 2025 LiXiujie
|
|
// @Author Lxj <li@xiujie.cn>
|
|
// @License https://github.com/xiujiecn/xiu-admin/blob/master/LICENSE
|
|
package convert
|
|
|
|
import (
|
|
"reflect"
|
|
"slices"
|
|
|
|
"github.com/gogf/gf/v2/errors/gerror"
|
|
"github.com/gogf/gf/v2/text/gstr"
|
|
)
|
|
|
|
var (
|
|
descTags = []string{"description", "dc", "json"} // 实体描述标签
|
|
fieldTags = []string{"json"} // 实体字段名称映射
|
|
)
|
|
|
|
// EscapeFieldsToSlice 将转义过的字段转换为字段集切片
|
|
func EscapeFieldsToSlice(s string) []string {
|
|
return gstr.Explode(",", gstr.Replace(gstr.Replace(s, "`,`", ","), "`", ""))
|
|
}
|
|
|
|
// GetEntityDescTags 获取实体中的描述标签
|
|
func GetEntityDescTags(entity interface{}) (tags []string, err error) {
|
|
var formRef = reflect.TypeOf(entity)
|
|
for i := 0; i < formRef.NumField(); i++ {
|
|
field := formRef.Field(i)
|
|
if field.Type.Kind() == reflect.Struct {
|
|
addTags, err := reflectTag(field.Type, descTags, []string{})
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
tags = append(tags, addTags...)
|
|
continue
|
|
}
|
|
tags = append(tags, reflectTagName(field, descTags, true))
|
|
}
|
|
return
|
|
}
|
|
|
|
// reflectTag 层级递增解析tag
|
|
func reflectTag(reflectType reflect.Type, filterTags []string, tags []string) ([]string, error) {
|
|
if reflectType.Kind() == reflect.Ptr {
|
|
return nil, gerror.Newf("reflect type do not support reflect.Ptr yet, reflectType:%+v", reflectType)
|
|
}
|
|
if reflectType.Kind() != reflect.Struct {
|
|
return nil, nil
|
|
}
|
|
for i := 0; i < reflectType.NumField(); i++ {
|
|
tag := reflectTagName(reflectType.Field(i), filterTags, false)
|
|
if tag == "" {
|
|
addTags, err := reflectTag(reflectType.Field(i).Type, filterTags, tags)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
tags = append(tags, addTags...)
|
|
continue
|
|
}
|
|
tags = append(tags, tag)
|
|
}
|
|
return tags, nil
|
|
}
|
|
|
|
// reflectTagName 解析实体中的描述标签,优先级:description > dc > json > Name
|
|
func reflectTagName(field reflect.StructField, filterTags []string, isDef bool) string {
|
|
|
|
if slices.Contains(filterTags, "description") {
|
|
if description, ok := field.Tag.Lookup("description"); ok && description != "" {
|
|
return description
|
|
}
|
|
}
|
|
|
|
if slices.Contains(filterTags, "dc") {
|
|
if dc, ok := field.Tag.Lookup("dc"); ok && dc != "" {
|
|
return dc
|
|
}
|
|
}
|
|
|
|
if slices.Contains(filterTags, "json") {
|
|
if jsonName, ok := field.Tag.Lookup("json"); ok && jsonName != "" {
|
|
return jsonName
|
|
}
|
|
}
|
|
|
|
if !isDef {
|
|
return ""
|
|
}
|
|
return field.Name
|
|
}
|