Swagger2 の履歴(No.6)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• Swagger2 へ行く。
  • 1 (2017-09-13 (水) 10:26:02)
  • 2 (2017-09-15 (金) 08:02:32)
  • 3 (2017-09-17 (日) 14:53:05)
  • 4 (2017-09-19 (火) 09:51:54)
  • 5 (2017-09-19 (火) 22:48:20)
  • 6 (2019-08-12 (月) 15:33:57)

• APIドキュメントの自動生成

参考ページ†

http://qiita.com/nvtomo1029/items/03f263423848a955f2bc

URL等†

• JSON http://localhost:8080/v2/api-docs

• UI http://localhost:8080/swagger-ui.html

アノテーション†

https://github.com/swagger-api/swagger-core/wiki/Annotations-1.5.X#swaggerdefinition

• @Api(value = "/api/path", tags = "tagname", description = "testAPI")

なくても大丈夫だけど、より詳細な説明をController単位で追加できる 指定しない場合はtagsはハイフンつなぎのクラス名 descriptionはクラス名。valueは不明！

• @ApiOperation("APIの操作内容を記述")

指定しないとメソッド名のところを指定した場合は、エンドポイント単位に説明追加

設定†

    
.apis(or(RequestHandlerSelectors.basePackage("com.rutake.xxx1"),RequestHandlerSelectors.basePackage("com.rutake.controller.rest"))) // 特定のパッケージに絞る。しぼらないならany()

   private Predicate<String> actuatorPath() {
       return regex("/actuator/?.*");
   }