swagger接口文档【动态接口分组】

最新推荐文章于 2025-02-15 02:58:29 发布

wellzhi

最新推荐文章于 2025-02-15 02:58:29 发布

阅读量3.2k

点赞数

分类专栏： Java 文章标签： swagger 开发工具 java

本文链接：https://blog.csdn.net/qq_34268861/article/details/113401630

版权

本文档介绍了如何通过Swagger自定义注解`@ApiVersion`、版本号常量类`Version`和Swagger配置类`SwaggerConfig`来实现动态接口分组。详细讲述了在Java项目中，方法和类级别使用`@ApiVersion`注解的优先级，并提到了接口过滤的显示隐藏逻辑。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、期望效果图示

二、代码实现

1、自定义注解：@ApiVersion

支持方法级别、类级别，优先级：方法级别优于类级别

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface ApiVersion {

    /**
     * 接口版本号(对应swagger中的group)
     */
    String[] group() default {};

    /**
     * 接口版本号(对应swagger中的value)
     */
    String[] value() default {};

}

2、版本号常量类：Version

public class Version {
    public static final String V3_27_0 = "3.27.0";
    public static final String V3_28_0 = "3.28.0";
    public static final String V3_29_0 = "3.29.0";
}