最近 SpringFox 3.0.0 釋出了，距離上一次大版本2.9.2足足有2年多時間了。可能看到這個名字，很多讀者會有點陌生。但是，只要給大家看一下這兩個依賴，你就知道了！ ```xml ``` 當我們在使用Spring MVC寫介面的時候，為了生成API文件，為了方便整合Swagger，都是用這個SpringFox的這套封裝。但是，自從2.9.2版本更新之後，就一直沒有什麼動靜，也沒有更上Spring Boot的大潮流，有一段時間還一直都是寫個配置類來為專案新增文件配置的。為此，之前就造了這麼個輪子： - [https://github.com/SpringForAll/spring-boot-starter-swagger](https://github.com/SpringForAll/spring-boot-starter-swagger) 也沒什麼難度，就是造的早，所以得到了不少Star。現在SpringFox出了一個starter，看了一下功能，雖然還不完美，但相較於之前我們自己的輪子來說還是好蠻多的。來看看這個版本有些什麼亮點： - Spring 5，Webflux 支援（僅請求對映支援，尚不支援功能端點） - Spring Integration 支援 - Spring Boot 支援 springfox-boot-starter 依賴性（零配置，自動配置支援） - 具有自動完成功能的文件化配置屬性 - 更好的規範相容性 - 支援 OpenApi 3.0.3 - 幾乎零依賴性（唯一需要的庫是 spring-plugin、pswagger-core） - 現有的 swagger2 註釋將繼續有效，並豐富 open API 3.0 規範 對於這次的更新，我覺得比較突出的幾點：Webflux的支援，目前的輪子就沒有做到；對OpenApi 3的支援；以及對Swagger 2的相容（可以比較方便的做升級了）。 ## 上手嚐鮮 說那麼多，不如來一發程式實驗下更直接！ **第一步**：建立一個Spring Boot專案，這裡不展開，不會的看以前的教程：[快速入門](http://blog.didispace.com/spring-boot-learning-21-1-1/) **第二步**：`pom.xml`中新增依賴：