日韩无码专区无码一级三级片|91人人爱网站中日韩无码电影|厨房大战丰满熟妇|AV高清无码在线免费观看|另类AV日韩少妇熟女|中文日本大黄一级黄色片|色情在线视频免费|亚洲成人特黄a片|黄片wwwav色图欧美|欧亚乱色一区二区三区

接口文檔總是很煩人，我曾經(jīng)嘗試過用Postman來編寫和分享項(xiàng)目文檔，感覺還不錯(cuò)。但是最近項(xiàng)目緊，我沒有額外的時(shí)間可以花在它上面，這也導(dǎo)致我嘗試YApi(另外一種文檔)的計(jì)劃泡湯了。嗯，目前沒有比Swagger更快、更傻瓜的工具，雖然它有嚴(yán)重的代碼污染。先拿這個(gè)對(duì)付一陣時(shí)間，等閑暇時(shí)間再玩YApi。

創(chuàng)新互聯(lián)公司專業(yè)為企業(yè)提供石家莊網(wǎng)站建設(shè)、石家莊做網(wǎng)站、石家莊網(wǎng)站設(shè)計(jì)、石家莊網(wǎng)站制作等企業(yè)網(wǎng)站建設(shè)、網(wǎng)頁設(shè)計(jì)與制作、石家莊企業(yè)網(wǎng)站模板建站服務(wù)，十載石家莊做網(wǎng)站經(jīng)驗(yàn)，不只是建網(wǎng)站，更提供有價(jià)值的思路和整體網(wǎng)絡(luò)服務(wù)。

Swagger3集成

Swagger目前最新版本是3.0.0,在Spring Boot應(yīng)用中集成Swagger3比老的Swagger2簡單多了，它提供了一個(gè)Starter組件。

 
 
 
 

  
  
  
  

  
  
  
  
    io.springfox
  
  
  
  
    springfox-boot-starter
  
  
  
  
    3.0.0
  
  
  
  

 
 
 
 

就這就可以了，簡單不?

至于有的教程說還要開啟注解@EnableOpenApi，完全不需要。因?yàn)樵趕pringfox-boot-starter-3.0.0.jar下你可以找到一個(gè)spring.factories，熟悉Spring Boot的同學(xué)都知道這個(gè)是一個(gè)Spring Boot 特有的SPI文件，能夠自動(dòng)的發(fā)現(xiàn)并注冊Starter組件的配置。里面有這樣的配置：

 
 
 
 

  
  
  
  
# Auto Configure
  
  
  
  
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
  
  
  
  
springfox.boot.starter.autoconfigure.OpenApiAutoConfiguration
 
 
 
 

順藤摸瓜，找到總的配置類OpenApiAutoConfiguration：

 
 
 
 

  
  
  
  
@Configuration
  
  
  
  
@EnableConfigurationProperties(SpringfoxConfigurationProperties.class)
  
  
  
  
@ConditionalOnProperty(value = "springfox.documentation.enabled", havingValue = "true", matchIfMissing = true)
  
  
  
  
@Import({
  
  
  
  
    OpenApiDocumentationConfiguration.class,
  
  
  
  
    SpringDataRestConfiguration.class,
  
  
  
  
    BeanValidatorPluginsConfiguration.class,
  
  
  
  
    Swagger2DocumentationConfiguration.class,
  
  
  
  
    SwaggerUiWebFluxConfiguration.class,
  
  
  
  
    SwaggerUiWebMvcConfiguration.class
  
  
  
  
})
  
  
  
  
@AutoConfigureAfter({ WebMvcAutoConfiguration.class, JacksonAutoConfiguration.class,
  
  
  
  
    HttpMessageConvertersAutoConfiguration.class, RepositoryRestMvcAutoConfiguration.class })
  
  
  
  
public class OpenApiAutoConfiguration {
  
  
  
  

  
  
  
  
}
 
 
 
 

一些發(fā)現(xiàn)

我們找到了關(guān)鍵的一個(gè)地方@ConditionalOnProperty注解聲明了當(dāng)springfox.documentation.enabled為true時(shí)啟用配置，而且默認(rèn)值就是true。這非常有用，Swagger僅僅建議在開發(fā)階段使用，這個(gè)正好是個(gè)開關(guān)。另外有時(shí)候我們自定義配置的時(shí)候最好把這個(gè)開關(guān)也加上：

 
 
 
 

  
  
  
  
// 自定義swagger3文檔信息
  
  
  
  
@Configuration
  
  
  
  
@ConditionalOnProperty(value = "springfox.documentation.enabled", havingValue = "true", matchIfMissing = true)
  
  
  
  
public class Swagger3Config {
  
  
  
  
    @Bean
  
  
  
  
    public Docket createRestApi() {
  
  
  
  
        return new Docket(DocumentationType.OAS_30)
  
  
  
  
                .apiInfo(apiInfo())
  
  
  
  
                .select()
  
  
  
  
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
  
  
  
  
                .paths(PathSelectors.any())
  
  
  
  
                .build();
  
  
  
  
    }
  
  
  
  

  
  
  
  
    private ApiInfo apiInfo() {
  
  
  
  
        return new ApiInfoBuilder()
  
  
  
  
                .title("Swagger3接口文檔")
  
  
  
  
                .description("更多請(qǐng)咨詢felord.cn")
  
  
  
  
                .contact(new Contact("碼農(nóng)小胖哥", "https://felord.cn", "dax@felord.cn"))
  
  
  
  
                .version("1.0.0")
  
  
  
  
                .build();
  
  
  
  
    }
  
  
  
  
}
 
 
 
 

如果你想在Swagger3中加入Json Web Token，可以參考這篇文章。

最開始我們提到Swagger3不需要使用@EnableOpenApi或者@EnableSwagger2開啟，這里也能找到答案。

 
 
 
 

  
  
  
  
@Import(OpenApiDocumentationConfiguration.class)
  
  
  
  
public @interface EnableOpenApi {
  
  
  
  
}
  
  
  
  
@Import(Swagger2DocumentationConfiguration.class)
  
  
  
  
public @interface EnableSwagger2 {
  
  
  
  
}
 
 
 
 

上面的兩個(gè)導(dǎo)入類都可以在OpenApiAutoConfiguration找到，所以Swagger3提供的是全自動(dòng)的集成。

和全局統(tǒng)一參數(shù)不兼容

如果你使用了統(tǒng)一返回體封裝器來標(biāo)準(zhǔn)化Spring MVC接口的統(tǒng)一返回

 
 
 
 

  
  
  
  
/**
  
  
  
  
 * 返回體統(tǒng)一封裝器
  
  
  
  
 *
  
  
  
  
 * @author n1
  
  
  
  
 */
  
  
  
  
@RestControllerAdvice 
  
  
  
  
public class RestBodyAdvice implements ResponseBodyAdvice