Swagger是一個規範和完整的框架，用於生成、描述、呼叫和視覺化 RESTful 風格的 Web 服務。它可以在修改程式碼的同時同步修改介面文件，一個最大的優點是能實時同步api與文件

一些註解說明

對這些常用的註解及元素說明，具體的其他元素可以檢視原始碼。

• @Api：用在類上
  - tags：描述類的用途
  - description：註釋說明這個類
  - 其實tags和description這倆都差不多都是對這個類的說明
  

  @ApiOperation：用在方法上
  - value：欄位說明
  - notes：註釋說明
  - response：方法的返回型別

  @ApiParam：用在引數上
  - name：引數名稱
  - required：是否必傳

  
  @ApiModel：用在入參或回參的物件類上
  - value：對這個類進行說明
  - description：說明這個類
  - 和@Api的tags/description一樣，都是起說明作用

  
  @ApiModelProperty：用在物件類中的變數上
  - value：對這個欄位的說明
  - example：欄位舉例

  
  @EnableSwagger2：配置swagger時啟用swagger

• 到這裡，就可以在程式碼中簡單使用swagger，訪問地址(http://localhost:9090/swagger/swagger-ui.html),但是作為勵志成為技術大牛的菜鳥，這點那肯定是不能夠滿足我的，既然知道了使用，那麼swagger時怎麼匯出的呢，這是個大問題，在這裡我在網上學習了兩種方式進行匯出，分別問使用maven和程式碼方式，但是使用maven匯出的時候頻頻出錯，沒辦法我只有自己找問題改程式碼了，程式碼中可能有待優化的部分，不喜勿怪!