SpringBoot 中集成 Swagger2

• • • SwaggerConfig 配置类
    • MyController 控制类
    • User 的 持久类
    • application.properties 配置文件
    • application-dev.properties 配置文件
    • application-pro.properties 配置文件
    • POM.xml 文件中的 Swagger 相关依赖
  • 效果演示
  • 参考目录

测试总览

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean //配置docket以配置Swagger具体参数
    public Docket docket(Environment environment) {

        Profiles profile = Profiles.of("dev");
        boolean b = environment.acceptsProfiles(profile);
        return new Docket(documentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .enable(b)
                .groupName("ouring")
                .select()// 通过.select()方法，去配置扫描接口,RequestHandlerSelectors配置如何扫描接口
                .apis(RequestHandlerSelectors.basePackage("com.ouring.swaggerdemo.controller"))
                .build();

    }




    //配置文档信息
    private ApiInfo apiInfo() {
        Contact contact = new Contact("联系人名字", "http://xxx.xxx.com/联系人访问链接", "联系人邮箱");
        return new ApiInfo(
                "Swagger学习", // 标题
                "学习演示如何配置Swagger", // 描述
                "v1.0", // 版本
                "http://terms.service.url/组织链接", // 组织链接
                contact, // 联系人信息
                "Apach 2.0 许可", // 许可
                "许可链接", // 许可连接
                new ArrayList<>()// 扩展
        );
    }

}

@RestController
@Api(tags = "Controller 控制器")
public class MyController {
    @ApiOperation(value = "limi")
    @GetMapping({"/koma/{name}","/index/{name}"})
    public String index(@PathVariable(name = "name") String name){
        return "hello everyone"+name;
    }

    @GetMapping({"/ouring","/komi"})
    public String ouring(String name){
        return "hello ouring"+name;
    }

    @PostMapping({"/liko","/sama"})
    public User Komi(@RequestBody User user){
        return user;
    }

}

@Data
@AllArgsConstructor
@NoArgsConstructor
@ApiModel("用户")
public class User {
    @ApiModelProperty("用户名")
    private String name;
    @ApiModelProperty("密码")
    private String paw;
}

spring.profiles.active=dev

server.port=8081

server.port=8082

 
        
            io.springfox
            springfox-swagger2
            2.9.2
        

        
        
            io.springfox
            springfox-swagger-ui
            2.9.2
        

非常详细的 笔记
https://blog.csdn.net/weixin_44449838/article/details/108713248

狂神
https://www.bilibili.com/video/BV1PE411i7CV?p=49