程序猿最煩兩件事，第一件事是別人要他給自己的代碼寫文檔，第二件呢？是別人的程序沒有留下文檔。

程序員最討厭的四件事：寫注釋、寫文檔、別人不寫注釋、別人不寫文檔……

關于寫文檔這個事情，爭論已久，今天就介紹一個解決這個問題的東東，Swagger。 這里介紹的是由程序員DD翟永超提供的spring-boot-starter-swagger關于其詳細設置在文章底部。

pom.xml

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- 引入swagger2 --><dependency><groupId>com.spring4all</groupId><artifactId>swagger-spring-boot-starter</artifactId><version>1.8.0.RELEASE</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies> 復制代碼

在這里我們需要做的事情就不像引入官方依賴一樣需要一個個的加注解，只需要一個注解就OK了。@EnableSwagger2Doc，這個注解加在啟動類上

package com.priv.gabriel;import com.spring4all.swagger.EnableSwagger2Doc; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication;@EnableSwagger2Doc @SpringBootApplication public class Demoforswagger2Application {public static void main(String[] args) {SpringApplication.run(Demoforswagger2Application.class, args);} }復制代碼

輸入http://localhost:8080/swagger-ui.html進行訪問

打開UserController看一下 繼續查看一個具體的請求 基本信息都有了，也可以在這里測試接口。

可以看到我們幾乎沒有怎么操作一個文檔就建立完畢了。 spring-boot-starter-swagger項目及文檔 本項目的下載地址

轉載于:https://juejin.im/post/5c1ca9dce51d4548ec65d57c

總結

以上是生活随笔為你收集整理的第十一篇 SpringBoot 2 x整合Swagger2的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。