本篇文章給大家分享的是有關(guān)Springboot集成Swagger2以及常見配置的過程是怎樣的，小編覺得挺實(shí)用的，因此分享給大家學(xué)習(xí)，希望大家閱讀完這篇文章后可以有所收獲，話不多說，跟著小編一起來看看吧。

成都創(chuàng)新互聯(lián)長期為數(shù)千家客戶提供的網(wǎng)站建設(shè)服務(wù)，團(tuán)隊(duì)從業(yè)經(jīng)驗(yàn)10年，關(guān)注不同地域、不同群體，并針對不同對象提供差異化的產(chǎn)品和服務(wù)；打造開放共贏平臺，與合作伙伴共同營造健康的互聯(lián)網(wǎng)生態(tài)環(huán)境。為永濟(jì)企業(yè)提供專業(yè)的成都網(wǎng)站制作、成都網(wǎng)站設(shè)計(jì)，永濟(jì)網(wǎng)站改版等技術(shù)服務(wù)。擁有10年豐富建站經(jīng)驗(yàn)和眾多成功案例,為您定制開發(fā)。

 這種整合的文章確實(shí)已經(jīng)爛大街了，寫他一方面是補(bǔ)充我的springboot系列，另一方面確實(shí)還有一部分小伙伴沒用過。最重要的是，如果你忘記了這種整合的代碼?？梢噪S時(shí)查閱。

前言

現(xiàn)在的開發(fā)基本上都是前后端分離，前后端交互都是通過API文檔。有了API文檔大家各自開發(fā)，互不干擾。

1、傳統(tǒng)方式

傳統(tǒng)方式是文檔設(shè)計(jì)好之后，分別發(fā)給前端和后端人員。這樣有個(gè)缺點(diǎn)，接口信息一旦變化，文檔就需要重新發(fā)送給前后端人員。無法做到實(shí)時(shí)。所以浪費(fèi)時(shí)間和精力。

2、swagger方式

我們的后臺應(yīng)用集成了swagger之后，會自動暴露出我們的接口，而且這個(gè)接口形式還是通過restful風(fēng)格發(fā)布的。一旦后端的接口有變化，會立刻顯示出來，因此極大地提高了效率。

OK，基本上一句話就可以總結(jié)他的好處，那就是后端寫的api文檔可以通過swagger的形式實(shí)時(shí)的發(fā)布出來，供前端人員查看。

3、其他方式

swagger的頁面說實(shí)話長得不好看，也有一些其他的方案，不是有很多bug，就是收費(fèi)。目前swagger是使用的最多的。我目前也正在做這個(gè)樣的開源項(xiàng)目，基于swagger做出類似于其他方案的頁面，而且功能更加的強(qiáng)大。

一、代碼整合

前提條件是要新建一個(gè)springboot項(xiàng)目。這點(diǎn)就不演示了。

第一步：添加依賴

     io.springfox     springfox-swagger2     2.9.2       io.springfox     springfox-swagger-ui     2.9.2 

2.9.2的版本是用的最多的，具體的可以直接去maven的官網(wǎng)去搜索，找一個(gè)使用量最多的版本即可。

第二步：配置

新建config包，創(chuàng)建SwaggerConfig類

@EnableSwagger2 @Configuration public class Swagger2Config {     @Bean     public Docket createRestApi() {         return new Docket(DocumentationType.SWAGGER_2)              .apiInfo(apiInfo())              .select()              //為當(dāng)前包路徑,控制器類包              .apis(RequestHandlerSelectors.basePackage("com.fdd.controller"))             .paths(PathSelectors.any())              .build();     }     //構(gòu)建 api文檔的詳細(xì)信息函數(shù)     private ApiInfo apiInfo() {         return new ApiInfoBuilder()             //頁面標(biāo)題            .title("XX平臺API接口文檔")             //創(chuàng)建人            .contact(new Contact("馮冬冬", "http://www.javachat.cc",                    "3049352171@qq.com"))            //版本號           .version("1.0")            //描述           .description("系統(tǒng)API描述")           .build();     }

這里的配置也比較簡單。這里有很多選項(xiàng)供我們?nèi)ヅ渲?。如果我們的?xiàng)目有多個(gè)組，只需要創(chuàng)建多個(gè)Docket即可。這時(shí)候掃描的包換成每個(gè)組的包路徑。

第三步：controller類中配置

新建一個(gè)controller包，然后創(chuàng)建HelloController類

@Api("Hello控制類") @RestController  public class HelloController {     @GetMapping(value = "/user")     public User getUser(){         return new User("愚公要移山","123456");     }     @ApiOperation("可以指定參數(shù)的API")     @PostMapping("/param")     public String hello2(@ApiParam("用戶名") String name){         return "hello" + name;     } }

這里我們可以看出，使用注解就可以對這個(gè)類、方法、字段等等進(jìn)行解釋說明。其他的字段還有很多，在使用的時(shí)候會有相應(yīng)的提示，可以自己試一遍：

第四步：查看效果

訪問:http://127.0.0.1:8080/swagger-ui.html即可。

OK，到這一步基本上就集成進(jìn)來了。下面說一下可能會遇到的配置。

三、常見其他問題

1、Spring Security - 配置免認(rèn)證訪問

有時(shí)候我們的Springboot集成了SpringSecurity，這時(shí)候如果訪問swagger的地址會自動跳轉(zhuǎn)到登錄頁面。這是因?yàn)镾pringSecurity對其進(jìn)行了攔截。為此我們只需要在我們的SpringSecurity配置一下進(jìn)行放行即可。

現(xiàn)在配置一下，進(jìn)行放行。在config包下新建一個(gè)SpringSecurityConfig類

@Configuration @EnableWebSecurity public class SpringSecurityConfig extends WebSecurityConfigurerAdapter {     @Override     protected void configure(HttpSecurity http) throws Exception {         http                 .authorizeRequests()                 .antMatchers("/swagger-ui.html").permitAll()                 .antMatchers("/webjars/**").permitAll()                 .antMatchers("/swagger-resources/**").permitAll()                 .antMatchers("/v2/*").permitAll()                 .antMatchers("/csrf").permitAll()                 .antMatchers("/").permitAll()                 .anyRequest().authenticated()                 .and()                 .formLogin()         ;     } }

此時(shí)就可以正常的訪問了。

2、為swagger設(shè)置jwt

這種方式比較簡單，只需要一步即可。修改我們的swaggerConfig類即可。

@EnableSwagger2 @Configuration public class Swagger2Config {     @Bean     public Docket api() {         return new Docket(DocumentationType.SWAGGER_2)                 .apiInfo(apiInfo())                 .securityContexts(Arrays.asList(securityContext()))                 .securitySchemes(Arrays.asList(apiKey()))                 .select()                 .apis(RequestHandlerSelectors.any())                 .paths(PathSelectors.any())                 .build();     }     //構(gòu)建 api文檔的詳細(xì)信息函數(shù)     private ApiInfo apiInfo() {         return new ApiInfoBuilder()                 //頁面標(biāo)題                 .title("XX平臺API接口文檔")                 //創(chuàng)建人                 .contact(new Contact("馮冬冬", "http://www.javachat.cc",                         "3049352171@qq.com"))                 //版本號                 .version("1.0")                 //描述                 .description("系統(tǒng)API描述")                 .build();     }     private ApiKey apiKey() {         return new ApiKey("JWT", "Authorization", "header");     }     private SecurityContext securityContext() {         return SecurityContext.builder().securityReferences(defaultAuth()).build();     }      private List defaultAuth() {         AuthorizationScope authorizationScope           = new AuthorizationScope("global", "accessEverything");         AuthorizationScope[] authorizationScopes = new AuthorizationScope[1];         authorizationScopes[0] = authorizationScope;         return Arrays.asList(new SecurityReference("JWT", authorizationScopes));     }  }

加了一些token驗(yàn)證的代碼，比較簡單，關(guān)于JWT的東西，可以私下了解。這里不贅述了。

3、隱藏Endpoint

有時(shí)候自己寫的controller，或者是controller里面的接口方法不想讓前端人員看到，我們可以隱藏即可。

第一：隱藏整個(gè)controller

@ApiIgnore @RestController public class MyController {     //方法 }

第二：隱藏某個(gè)接口方法1

@ApiIgnore @ApiOperation(value = "描述信息") @GetMapping("/getAuthor") public String getAuthor() {     return "愚公要移山"; }

第三：隱藏某個(gè)接口方法2

@ApiOperation(value = "描述信息", hidden = true) @GetMapping("/get") public LocalDate getDate() {     return LocalDate.now(); }

OK，很多配置基本上就到這了。

以上就是Springboot集成Swagger2以及常見配置的過程是怎樣的，小編相信有部分知識點(diǎn)可能是我們?nèi)粘９ぷ鲿姷交蛴玫降?。希望你能通過這篇文章學(xué)到更多知識。更多詳情敬請關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道。