1. 首页首页
  2. 科技前沿科技前沿

2025年swagger3使用（swagger怎么使用）

科技前沿 • • 阅读 37

swagger3使用（swagger怎么使用）svg xmlns http www w3 org 2000 svg style display none svg

大家好，我是讯享网，很高兴认识大家。



 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg> <blockquote>

讯享网

这篇文章将介绍如何在 java 中使用 ,

官网地址:https://swagger.io/
在这里插入图片描述
讯享网

是一个规范和完整的框架，用于生成可视化 RESTful 风格的 Web 服务。是一个简单且功能强大的API工具。几乎所有的现代编程语言，都在支持和使用。

Swagger2已经停止维护了，取而代之的是 swagger3，

之前在SpringBoot项目中一直使用的是提供的Swagger库,已经很久没有更新了。
是一款可以结合SpringBoot使用的API文档生成工具，基于OpenAPI 3,
是一款更好用的Swagger库！值得一提的是SpringDoc不仅支持Spring WebMvc项目，还可以支持Spring WebFlux项目，甚至Spring Rest和Spring Native项目，总之非常强大
经常使用的Swagger注解，看看的有啥区别，毕竟对比已学过的技术能更快掌握新技术;
在这里插入图片描述

讯享网

进行SpringDoc的配置，使用来配置基础的文档信息，通过配置分组的API文档，SpringDoc支持直接使用接口路径进行配置。

 

1.@Tag注解
 

用来描述一组操作的信息（通常用在controller控制层类上）
 在这里插入图片描述例：
 

讯享网
 

2.@Operation注解
 

用来描述接口信息（通常用在控制层的具体方法上）
 在这里插入图片描述例：
 

 

3.@Schema注解
 

该注解用来定义模型及模型的属性（可以用在dto/vo以及其属性上）
 在这里插入图片描述
 

例：
 

讯享网
 

 
 
 

 

在这里插入图片描述
 

 

 

 

 

 

 
 
迁移到SpringDoc确实是一个更好的选择。确实很好用，和之前熟悉的用法差不多，。
 

 


                    


                    


                    

                        

                            

                                小讯
                            

                            

                                

                                    
                                        
                                    
                                

                            

                        

                    

                


                

                    
                    
                    

                        
                        

                             上一篇
                            2025-05-22 18:50
                        

                    

                    
                    


                    
                    
                    

                        
                        

                            下一篇 
                            2025-05-23 20:46
                        

                    

                    
                    
                


                

                    
相关推荐

                    
                

                

                    

                        版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/170166.html