SpringBoot使用Swagger2生成接口文档

一、导入依赖

      <!--        knife4j-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
            <version>2.0.7</version>
        </dependency>

二、配置类

        通过一下配置,将Swagger2自动配置进SpringBoot中

@Configuration
@EnableSwagger2WebMvc
public class Knife4jConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .protocols(Collections.singleton("http"))
                .host("前台网址")
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("标题")
                .description("aurora")
                .contact(new Contact("作者", "", "邮箱"))
                .termsOfServiceUrl("名称")
                .version("1.0")
                .build();
    }

}

三、Controller使用

            通过@Api注解和@ApiOperation注解说明模块作用及接口说明。

@Api(tags = "投诉原因模块")
@RestController
public class ComplaintsCauseController {

	@Autowired
	private ComplaintsCauseService complaintsCauseService;

	@ApiOperation("获取投诉所有原因")
	@GetMapping("/users/complaintsCause")
	public ResultVO<List<ComplaintsCause>> getAllComplaintsCause(){
		return complaintsCauseService.getAllComplaintsCause();
	}
}

四、通过访问路径

        通过访问路径http://localhost:8088/doc.html,说明一下8088是我SpringBoot的端口号,你们填你们自己的,不同版本的Swagger访问的路径是不一样的。然后最终看到进到的页面就是下面这这个了

  • 14
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

爱生活,更爱技术

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值