日常工作总结--Swagger工作的使用_swagger总共有哪些jar包-优快云博客

本文链接：https://blog.youkuaiyun.com/qwzeng123/article/details/90446147

本文介绍了Swagger所需的jar包，分享了亲测过的2.2版本Swagger2配置文件。同时详细列举了swagger常用注解，包括controller层的@Api、@ApiOperation等，以及pojo类的@ApiModel、@ApiModelProperty等注解的使用方法和参数含义。

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

swagger所需的jar包

       <!--swagger2相关-->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.2.2</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.2.2</version>
        </dependency>

Swagger2配置文件：亲实过2.2版本

@Configuration
@EnableSwagger2
@ComponentScan(basePackages = {
        "com.***.controller"
        }) //扫描的包名
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        ParameterBuilder ticketPar = new ParameterBuilder();
        List<Parameter> pars = new ArrayList<>();
        ticketPar.name("Authorization").description("token")
                .modelRef(new ModelRef("string"))
                .parameterType("header")
                .defaultValue("token")
                .required(true)
                .build();
        pars.add(ticketPar.build());
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .paths(Predicates.not(PathSelectors.regex("/error.*")))
                .build()
                .globalOperationParameters(pars);
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("接口文档大标题")
                .version("1.0")
                .description("接口文档小标题")
                .build();
    }

}