這篇文章給大家介紹springboot中怎么快速啟動swagger，內(nèi)容非常詳細(xì)，感興趣的小伙伴們可以參考借鑒，希望對大家能有所幫助。

南江網(wǎng)站制作公司哪家好，找創(chuàng)新互聯(lián)建站！從網(wǎng)頁設(shè)計、網(wǎng)站建設(shè)、微信開發(fā)、APP開發(fā)、成都響應(yīng)式網(wǎng)站建設(shè)公司等網(wǎng)站項目制作，到程序開發(fā)，運(yùn)營維護(hù)。創(chuàng)新互聯(lián)建站從2013年創(chuàng)立到現(xiàn)在10年的時間，我們擁有了豐富的建站經(jīng)驗(yàn)和運(yùn)維經(jīng)驗(yàn)，來保證我們的工作的順利進(jìn)行。專注于網(wǎng)站建設(shè)就選創(chuàng)新互聯(lián)建站。

springboot之swagger快速啟動

代碼大致如下：

/**
 * Swagger2配置類
 * 在與spring boot集成時，放在與Application.java同級的目錄下。
 * 通過@Configuration注解，讓Spring來加載該類配置。
 * 再通過@EnableSwagger2注解來啟用Swagger2。
 */
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    /**
     * 創(chuàng)建API應(yīng)用
     * apiInfo() 增加API相關(guān)信息
     * 通過select()函數(shù)返回一個ApiSelectorBuilder實(shí)例,用來控制哪些接口暴露給Swagger來展現(xiàn)，
     * 本例采用指定掃描的包路徑來定義指定要建立API的目錄。
     * 
     * @return
     */
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.swaggerTest.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    
    /**
     * 創(chuàng)建該API的基本信息（這些基本信息會展現(xiàn)在文檔頁面中）
     * 訪問地址：http://項目實(shí)際地址/swagger-ui.html
     * @return
     */
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Spring Boot中使用Swagger2構(gòu)建RESTful APIs")
                .description("更多請關(guān)注http://www.baidu.com")
                .termsOfServiceUrl("http://www.baidu.com")
                .contact("sunf")
                .version("1.0")
                .build();
    }
}

模塊化-Starter

緣由

有開發(fā)過微服務(wù)的小伙伴應(yīng)該體會過。當(dāng)微服務(wù)模塊多的情況下，每個模塊都需要配置這樣的一個類進(jìn)行加載swagger。造成每個模塊都存在大致一樣的SwaggerConfig,極端的情況下，有些朋友復(fù)制其他模塊的SwaggerConfig進(jìn)行改造之后，發(fā)現(xiàn)仍然加載不出swagger的情況，造成明明是復(fù)制的，為何還加載不出，排查此bug及其費(fèi)時間。

在此之上，可以構(gòu)建出一個swagger-starter模塊，只需要引用一個jar，加載一些特殊的配置，就可以快速的使用到swagger的部分功能了。

設(shè)計

創(chuàng)建模塊swagger-spring-boot-starter。 功能大致如下：

1. 加載SwaggerConfig。

2. 通過配置化配置swagger。

3. Enable加載注解。

1. 創(chuàng)建SwaggerConfig

SwaggerConfig和之前的一致，只是里面的配置需要外部化。

@Configuration
@PropertySource(value = "classpath:swagger.properties", ignoreResourceNotFound = true, encoding = "UTF-8")
@EnableConfigurationProperties(SwaggerProperties.class)
public class SwaggerConfig {

  @Resource
  private SwaggerProperties swaggerProperties;

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

  private ApiInfo buildApiInf() {
    return new ApiInfoBuilder()
        .title(swaggerProperties.getTitle())
        .description(swaggerProperties.getDescription())
        .termsOfServiceUrl(swaggerProperties.getTermsOfServiceUrl())
        .contact(new Contact("skyworth", swaggerProperties.getTermsOfServiceUrl(), ""))
        .version(swaggerProperties.getVersion())
        .build();
  }
}

2. 創(chuàng)建SwaggerProperties 配置相關(guān)

配置通過@PropertySource注解加載resources目錄下的swagger.properties。

創(chuàng)建SwaggerProperties配置類,這個類里包含了一般swagger初始化要使用的一些常用的屬性，如掃描包路徑、title等等。

@Data
@ToString
@ConfigurationProperties(SwaggerProperties.PREFIX)
public class SwaggerProperties {

  public static final String PREFIX = "swagger";

  /**
   * 文檔掃描包路徑
   */
  private String basePackage = "";

  /**
   * title 如: 用戶模塊系統(tǒng)接口詳情
   */
  private String title = "深蘭云平臺系統(tǒng)接口詳情";

  /**
   * 服務(wù)文件介紹
   */
  private String description = "在線文檔";

  /**
   * 服務(wù)條款網(wǎng)址
   */
  private String termsOfServiceUrl = "https://www.deepblueai.com/";

  /**
   * 版本
   */
  private String version = "V1.0";


}

做好這兩件事情基本大工搞成了，為了更好的使用配置，在idea里和官方starter包一樣，我們還需要配置一個additional-spring-configuration-metadata.json,讓我們自己的配置也具有提示的功能，具體介紹請產(chǎn)考：配置提示 配置提示 配置提示 配置提示 配置提示 ...

3. 加載SwaggerConfig等特性

因?yàn)槭莝tarter模塊，可能他人的項目目錄和starter模塊的目錄不一致，導(dǎo)致加載不到SwaggerConfig類，我們需要使用spring.factories把SwaggerConfig類裝載到spring容器。

resources/META-INF

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  io.purge.swagger.SwaggerConfig

當(dāng)然本次基于Enable方式去加載SwaggerConfig。

創(chuàng)建@EnableSwaggerPlugins注解類，使用@Import(SwaggerConfig.class)將SwaggerConfig導(dǎo)入大工搞成。

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
@Import(SwaggerConfig.class)
@EnableSwagger2
public @interface EnableSwaggerPlugins {

}

使用

添加依賴

把自己編寫好的swagger通過maven打包，自己項目引用。

  com.purgeteam
  swagger-spring-boot-starter
  0.1.0.RELEASE

配置swagger.properties文件

• 在自己項目模塊的resources目錄下 創(chuàng)建swagger.properties配置

• swagger.properties 大致配置如下

swagger.basePackage="swagger掃描項目包路徑"
swagger.title="swagger網(wǎng)頁顯示標(biāo)題"
swagger.description="swagger網(wǎng)頁顯示介紹"

啟動類添加@EnableSwaggerPlugins注解。

@EnableSwaggerPlugins
@SpringBootApplication
public class FrontDemoApplication {

  public static void main(String[] args) {
    SpringApplication.run(FrontDemoApplication.class, args);
  }

}

訪問http://ip:端口/swagger-ui.html檢查swagger-ui是否正常。

關(guān)于springboot中怎么快速啟動swagger就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學(xué)到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。