swagger入门
上面的图中我们看到,除了自己暴露的接口外,还要框架自身暴露的,如果我们想要指定哪些接口暴露出来,可以使用如下图的方式:
我们还可以指定swagger是否自启动,可以调用docket实例的enable(),指定参数为false为不启动
一般不同组的开发人员,有属于他们自己的开发文档,是根据组名来区分开的,而组又是根据docket来分别的,所以一般都是在容器中会有多个docket:
下面讲的是页面中底部栏的实体类信息这一块,如果你直接在包中比如bean包下建了一个user类,swagger识别不了,根本就毫不关系两者,如果想要实体类被扫描到,可通过下面方式:
下面给swagger页面的接口和属性等加注释:
@ApiModel是给实体类加上注解
@ApiModelProperty是给实体类的属性加上注解
@API是用在controller等上面的,不是用在实体类
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异
· 三行代码完成国际化适配,妙~啊~