免费视频淫片aa毛片_日韩高清在线亚洲专区vr_日韩大片免费观看视频播放_亚洲欧美国产精品完整版

打開APP
userphoto
未登錄

開通VIP,暢享免費電子書等14項超值服

開通VIP
SpringBoot Swagger3.0配置

1、導(dǎo)入Maven依賴

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

2、配置application.yml

swagger:
  enable: true
  application-name: xxx系統(tǒng)API說明
  application-version: 1.0
  application-description: springfox swagger 3.0整合Demo
  try-host: http://localhost:${server.port}

3、添加實體類接收swagger配置信息

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

@Component
@ConfigurationProperties("swagger")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class SwaggerProperties {
    /**
     * 是否開啟swagger,生產(chǎn)環(huán)境一般關(guān)閉,所以這里定義一個變量
     */
    private Boolean enable;

    /**
     * 項目應(yīng)用名
     */
    private String applicationName;

    /**
     * 項目版本信息
     */
    private String applicationVersion;

    /**
     * 項目描述信息
     */
    private String applicationDescription;

    /**
     * 接口調(diào)試地址
     */
    private String tryHost;

}

4、Swagger配置類設(shè)置

@Configuration
public class SwaggerConfig implements WebMvcConfigurer {

    private final SwaggerProperties swaggerProperties;

    public SwaggerConfig(SwaggerProperties swaggerProperties) {
        this.swaggerProperties = swaggerProperties;
    }


    //可以創(chuàng)建多個Docket對象,添加進@Bean中 并使用 .groupName("張*") 添加多個分組,前提是名稱不要重復(fù)
    @Bean
    public Docket createRestApi() {

        return new Docket(
                DocumentationType.OAS_30)
                .pathMapping("/")
                .groupName("張*")
                // 定義是否開啟swagger,false為關(guān)閉,可以通過變量控制
                .enable(swaggerProperties.getEnable())

                // 將api的元信息設(shè)置為包含在json ResourceListing響應(yīng)中。
                .apiInfo(apiInfo())

                // 接口調(diào)試地址
                .host(swaggerProperties.getTryHost())

                // 選擇哪些接口作為swagger的doc發(fā)布
                .select()
                //RequestHandlerSelectors 配置要掃描接口的方式
                //RequestHandlerSelectors.basePackage("") //指定要掃描的包
                //any() 掃描全部
                //none() 都不掃描
                //.withClassAnnotation(RestController.class) 掃描類上的注解,比如這個只會掃描類上有RestController注解的類
                //.withMethodAnnotation(GetMapping.class) 掃描方法上的注解
                .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build()

                // 支持的通訊協(xié)議集合
                .protocols(newHashSet("https", "http"));
    }

    /**
     * API 頁面上半部分展示信息
     * 可以new ApiInfo對象,到ApiInfo里面去看源碼
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title(swaggerProperties.getApplicationName() + " Api Doc")
                .description(swaggerProperties.getApplicationDescription())
                .contact(new Contact("zhang", "com.z.cn", "1348359420@qq.com"))
                .version("Application Version: " + swaggerProperties.getApplicationVersion() + ", Spring Boot Version: " + SpringBootVersion.getVersion())
                .build();
    }

    @SafeVarargs
    private final <T> Set<T> newHashSet(T... ts) {
        if (ts.length > 0) {
            return new LinkedHashSet<>(Arrays.asList(ts));
        }
        return null;
    }


}

 

5、訪問API地址

http://localhost:8080/swagger-ui/
springfox-swagger-ui-3.0.0.jar 下 META-INF.resources.webjars.springfox-swagger-ui

6、實體類注解說明

@Data
@AllArgsConstructor
@NoArgsConstructor
@ApiModel("用戶實體類")
public class User {

    @ApiModelProperty("主鍵")
    private int id;
    @ApiModelProperty("登錄賬號")
    private String login;
    @ApiModelProperty("密碼")
    private String password;
    @ApiModelProperty("角色權(quán)限")
    private String role;
}

7、Controller注解說明

   //方法說明注解 @ApiOperation
    @ApiOperation("獲取全部用戶")
    @RequestMapping("user/getAll")
    @ResponseBody
    public List<User> getAll(){
        return  userService.selectAll();
    }

 

8、更多操作參考CSDN

 Swagger 3.0配置整合使用教程_南伯基尼-CSDN博客

 

本站僅提供存儲服務(wù),所有內(nèi)容均由用戶發(fā)布,如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請點擊舉報。
打開APP,閱讀全文并永久保存 查看更多類似文章
猜你喜歡
類似文章
springcloud zuul swagger2之微服務(wù)通過網(wǎng)關(guān)進行分發(fā)
【精選】Swagger 3.0快速入門_swagger3
Swagger3.0 天天刷屏,真的香嗎?
Springboot中整合knife4j接口文檔
Spring MVC中使用Swagger生成API文檔和完整項目示例Demo,swagger
SpringBoot非官方教程 | 第十一篇:springboot集成swagger2,構(gòu)建優(yōu)雅的Restful API
更多類似文章 >>
生活服務(wù)
分享 收藏 導(dǎo)長圖 關(guān)注 下載文章
綁定賬號成功
后續(xù)可登錄賬號暢享VIP特權(quán)!
如果VIP功能使用有故障,
可點擊這里聯(lián)系客服!

聯(lián)系客服