swagger构建api文档description过时使用tags

最新推荐文章于 2024-04-22 16:50:38 发布
最新推荐文章于 2024-04-22 16:50:38 发布
阅读量2.8w 收藏 2
点赞数 1
分类专栏： java springMVC springboot 文档构建
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/baidu_38609744/article/details/82191029
版权
java 同时被 3 个专栏收录
31 篇文章 2 订阅
订阅专栏
springboot
9 篇文章 0 订阅
订阅专栏
springMVC
7 篇文章 0 订阅
订阅专栏

问题描述:

  • description注解过时，想使用tags注解替换，但是使用tags后发现只能展开类，不能展开方法去测试

原因:

swagger导入版本过低，且与配置类中version不匹配

解决


我的配置为swagger 2.6.1，config中version为1.0,之后修改swagger版本为2.7.0，version改为1.1，问题解决

如有错误，非常感谢您的评论或是来信指正！970766540@qq.com

阿菜ray
关注
  • 1
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
注解篇——swagger常用注解详解
qq_31499975的博客
11-22 1906
常用注解 @Api 标识一个java类型是文档类，用controller类的类名上 @ApiModel 表示一个实体类/模型文档，用在类名上； @ApiModelProperty 作用在属性上，添加属性描述； @ApiOperation 作用在接口类的方法上，控制方法的相关描述； @ApiImplicitParam 作用在接口方法上，描述单个参数信息，只能作用在方法上； @ApiImplicitParams 作用在接口方法上，@ApiImplicitParam参数组； @ApiParam 作用在接口方法上，
springboot整合swagger构建Api文档
07-24
SpringBoot整合Swagger构建API文档是一项常见的任务，尤其在开发RESTful API时，它能帮助我们快速、方便地生成在线文档，提升开发效率和协作体验。Swagger是一个强大的工具，它允许开发者通过注解来描述API接口，...
【064】Spring Boot如何让Web API自动生成文档，并解决swagger-annotations的API注解description属性废弃的问题
热门推荐
zhangchao19890805的专栏
02-04 4万+
前后端分离的系统架构中，前端开发人员需要查看后端WEB API的文档来进行开发。采用后端API文档自动生成的方式，可以大幅提高开发效率。swagger是一个被广泛使用的文档自动生成工具，可以与多种编程语言结合使用。我们可以利用合适的jar包，让swqgger来协助java开发。本文讲述了如何把 swagger 与 Spring Boot 框架结合起来使用。我用一个项目来解释如何完成上述的目标。打开
Swagger注解的使用
骑个小蜗牛的博客
03-19 1万+
文章目录@EnableSwagger2@Api@ApiOperation@ApiParam@ApiImplicitParams@ApiImplicitParam@ApiModel@ApiModelProperty@ApiResponses@ApiResponse@ResponseHeader@ApiKeyAuthDefinition@Authorization@AuthorizationScope@BasicAuthDefinition@Contact@Example@ExampleProperty@Ext
swwagger3中的@Tag @Operation @Schema的作用是什么？
最新发布
m0_62744746的博客
04-22 937
@Tag @Operation @Schema
Swagger:Swagger中的常用注解
weixin_47609997的博客
07-27 8114
一、@Api 多作用在Controller类上，用来描述类信息 参数： 1.description：描述这个类的作用。 2.tags：设置这个类的一个标签。 @Api(tags = "招聘管理",description = "用于招聘模块的测试") @Controller public class ResumeController { } 二、@ApiOperation 作用在Controller类的方法上，用来描述接口信息 参数：value可以加以说明 @ApiOperatio
swagger2 description is deprecated
gutou__yu的博客
06-11 7779
swagger2 description弃用原因解决方法 原因 在2.x之前，可以这么使用在Controller类上： @Api(value= "PmsBrandController", description = "商品品牌管理") 但是在2.x中，description被弃用了。 原因在于在2.x中有了标签（tags）的概念，可以将不同的controller标记为同一个标签。使标签的分组机制更加灵活。 为了符合API的要求，保持向后兼容，保留了description字段。 现在正确的方法应当针对tags
mall 项目学习日志-1
klhidol的博客
05-23 306
学习文档 1.mybatis 配置 1. pom依赖 2.application.yml 在application.yml中添加数据源配置和MyBatis的mapper.xml的路径配置 spring: datasource: url: jdbc:mysql://localhost:3306/mall?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai username: root
Swagger的三个常用注解
qqy_1185911890的博客
06-19 7556
1. @Api 用于修饰类，在qs项目中用于描述Controller 参数：description 用于对该类的定义或描述该类的作用 @Api(description = "备忘录相关接口") @RestController public class MemoController { private final MemoRepository memoRepository;
SpringBoot基于Swagger2构建API文档过程解析
08-25
在本文中，我们将深入探讨如何使用SpringBoot和Swagger2构建API文档的过程。Swagger2是一个流行的API开发工具，它允许开发者生成交互式文档，使API使用者能够轻松理解和使用提供的服务。结合SpringBoot，我们可以...
swagger导出静态API文档工具
08-29
Swagger是一款强大的API开发和文档工具，它允许开发者通过简单的注解在代码中定义API接口，然后自动生成易于理解和使用的文档。Swagger导出静态API文档工具是基于Swagger的一个实用工具，它是一个Maven工程，这意味...
swagger-descriptions:手动创建的 swagger 描述以供常见重用
06-23
常见重用的 Swagger 描述 此存储库包含为那些希望通过通用 Swagger 客户端调用的 Web API 手动创建的描述。 此处提供的文件只是对 3rd 方提供的服务的描述，以帮助您快速使用和创建简单的客户端。 除非另有说明，否则我们与这些 3rd 方没有关系，因此既不对他们的服务负责，也无法帮助解决 3rd 方服务可能遇到的任何困难。 如果您希望为此集合添加另一个描述以造福他人，或者您希望提交对现有内容的一些改进，请不要犹豫贡献。 越多越好！ 什么是 Swagger？ 取自 Swagger 自己的文档： “Swagger:trade_mark: 的目标是为 REST API 定义一个标准的、与语言无关的接口，它允许人类和计算机在不访问源代码、文档或通过网络流量检查的情况下发现和理解服务的功能。在适当的时候“通过 Swagger 定义，消费者可以以最少的实现逻辑理解远程服务并与之交互。类似于接口为
Asp.Net Core使用swagger生成api文档的完整步骤
10-15
在Asp.Net Core中，Swagger是一个强大的工具，用于生成API文档，它可以帮助开发者轻松地创建、测试和理解API接口。本篇文章将详细讲解如何在Asp.Net Core项目中使用NSwag（包括Swashbuckle）来实现Swagger的集成。 ...
Swagger使用详解
keke的博客
10-08 6470
Swagger使用详解
Swagger常用注解
weixin_46278059的博客
12-10 1579
Swagger常用注解
Swagger 3 注解使用指南
吉屋安的博客
06-07 1万+
注解来描述每个API操作的摘要和详细描述，注解的对象，用于描述参数的数据类型。描述：用于描述操作的输入参数。在上述示例中，我们使用了。注解来描述请求体，以及。注解来描述响应结果，注解来描述路径参数，注解来描述响应结果。
swagger（API接口文档利器）
weixin_49107940的博客
09-01 1332
接口文档对于前后端开发人员都十分重要。尤其近几年流行前后端分离后接口文档又变成重中之重。接口文档固然重要,但是由于项目周期等原因后端人员经常出现无法及时更新，导致前端人员抱怨接口文档和实际情况不一致。很多人员会抱怨别人写的接口文档不规范，不及时更新。当时当自己写的时候确实最烦去写接口文档。这种痛苦只有亲身经历才会牢记于心。如果接口文档可以实时动态生成就不会出现上面问题。写文档也麻烦，那如果可以生成文档呢？Swagger就是做这个事。......
Swagger学习及运用（三）--Swagger注解文档及常用参数配置运用
丨Anna丨的博客
04-27 5987
Swagger注解介绍及常用参数配置与运用 1 @API 作用于类，放置于controller的一个类上，标志这个类是Swagger资源。资源影响Swagger的根文档、资源列表和该特定资源的API声明。swagger将只包含和声明使用@Api注释的类，而忽略其他资源(servlet等) 1.1 参数 参数名称 说明 类型 默认值 备注 tags ...
Swagger(二) Swagger信息配置与常用注解
奥迪的博客
09-12 6884
Swagger信息配置与常用注解 一、 Swagger 配置 可以在项目中创建 SwaggerConfig，进行配置文档内容。 1 配置基本信息 Docket：摘要对象，通过对象配置描述文件的信息。 apiInfo:设置描述文件中 info。参数类型 ApiInfo select():返回 ApiSelectorBuilder 对象，通过对象调用 build()可以 创建 Docket 对象 ApiInfoBuilder：ApiInfo 构建器。 @Configuration pub..

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值