代码拉取完成,页面将自动刷新
package restful
import (
"gitee.com/go-kade/library/ioc"
"gitee.com/go-kade/library/ioc/apps/apidoc"
"gitee.com/go-kade/library/ioc/config/http"
"gitee.com/go-kade/library/ioc/config/log"
restfulspec "github.com/emicklei/go-restful-openapi/v2"
"github.com/emicklei/go-restful/v3"
"github.com/rs/zerolog"
)
func init() {
ioc.Api().Registry(&SwaggerApiDoc{
ApiDoc: apidoc.ApiDoc{},
})
}
type SwaggerApiDoc struct {
ioc.ObjectImpl
log *zerolog.Logger
apidoc.ApiDoc
// Path string `json:"path" yaml:"path" toml:"path" env:"HTTP_API_DOC_PATH"`
}
func (h *SwaggerApiDoc) Name() string {
return apidoc.AppName
}
func (h *SwaggerApiDoc) Init() error {
h.log = log.Sub("api_doc")
return nil
}
func (i *SwaggerApiDoc) Priority() int {
return -100
}
func (h *SwaggerApiDoc) Registry(ws *restful.WebService) {
// 1.该 RESTful Web 服务可以产生 JSON 格式的响应
ws.Produces(restful.MIME_JSON)
//2.restfulspec.BuildSwagger() 方法使用这个配置来生成对应的 Swagger 文档
swagger := restfulspec.BuildSwagger(h.SwaggerDocConfig())
ws.Route(ws.GET("/").To(func(r *restful.Request, w *restful.Response) {
w.WriteAsJson(swagger)
}))
if h.Meta().CustomPathPrefix != "" {
h.log.Info().Msgf("Get the API Doc using %s", http.Get().ApiObjectAddrCustom(h))
} else {
h.log.Info().Msgf("Get the API Doc using %s", http.Get().ApiObjectAddr(h))
}
}
// API Doc config
func (h *SwaggerApiDoc) SwaggerDocConfig() restfulspec.Config {
return restfulspec.Config{
// 1.是用于获取当前已注册的 Web 服务列表的函数
WebServices: restful.RegisteredWebServices(),
// APIPath: "/swagger.json",
// APIPath: http.Get().ApiObjectPathPrefix(h),
PostBuildSwaggerObjectHandler: http.Get().SwagerDocs,
DefinitionNameHandler: func(name string) string {
if name == "state" || name == "sizeCache" || name == "unknownFields" {
return ""
}
return name
},
}
}
func (i *SwaggerApiDoc) Meta() ioc.ObjectMeta {
return DefaultObjectMeta1()
}
func DefaultObjectMeta1() ioc.ObjectMeta {
return ioc.ObjectMeta{
// CustomPathPrefix: "/s", 必须要/号 http://127.0.0.1:8080/s
CustomPathPrefix: "/swagger.json",
// CustomPathPrefix: "/s",
Extra: map[string]string{},
}
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。