Swagger2 の履歴(No.4)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• 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

アノテーション†

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

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

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

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

設定†

               .select().apis(apiPackage()).paths(or(and(apiPath(), not(actuatorPath()), not(testPath())), internalApiPath())).build()

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