Springboot集成Swagger接口发布工具

本文介绍如何将Swagger与SpringBoot项目整合,实现API文档自动生成及在线测试功能。通过添加Maven依赖并配置SwaggerConfig类即可快速启用Swagger。文章还详细解释了常用注解的用途。

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

 

今天试了一下传说中的Swagger,与springboot整合了一下非常简单。

添加maven插件,当然也有可能有springboot的swagger插件,其实也就是包含这两个。

<!-- springfox swagger2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>${swagger2.version}</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>${swagger2.version}</version>
</dependency>

 然后@EnableSwagger2一下,实例化一个Docket的@Bean对象,OJBK了。

/**
 * Swagger配置
 */
@EnableSwagger2
@Configuration
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.pss.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("接口文档")
                .description("使用restful风格")
                .version("1.0")
                .build();
    }
}

接下来和我预期的一样访问一个地址就可以看到全部的发布接口,可以进行测试。

所有注解都一个目的,让方法、字段、接口都加上注释,让调用接口的人可以独立完成接口调用。

@Api:注解 配合 @Controller层使用。

@ApiOperation:配合 接口方法使用,设置接口名。

@ApiImplicitParams:配合 接口方法使用,设置接口传入参数PATH,QUERY等。

@ApiIgnore:不想暴露接口使用。

@ApiResponse:400等异常可以使用。

@ApiModel:设置在VO对象中,如果方法返回值是VO对象,则会在最下面生成Models。VO对象中的属性设置@ApiModelProperties可以设置字段。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值