2016/06/24 追記 www.itmedia.co.jp 今のところまだこの脆弱性の対策版がリリースされていないので注意。 だいぶ昔にJersey(JAX-RS参照実装)についての記事を書いてからずっと気になっていたんですが、せっかくアノテーションを使ってURLとメソッドとの間にヒモ付が出来たのに、このアノテーション情報からJavadoc的なAPIドキュメントを生成する方法は無いものかと思っていました。 (追記: いやjerseyでwadlを生成できるけどレスポンスのJSONやXMLの構造については何も情報が出ないので・・・) JAX-RSでは今のところAPIドキュメント生成についてはカバーして無いようですが、最近仕事でREST APIドキュメントを生成出来ないかという話が出てきたので調べてみるとSwaggerというREST APIドキュメント生成フレームワーク?が有るようなので触っ
![SwaggerでREST APIドキュメントを生成する - ka-ka_xyzの日記](https://cdn-ak-scissors.b.st-hatena.com/image/square/c8d0c7f35aa7d8dbefa22df473f999674475cae4/height=288;version=1;width=512/http%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fk%2Fka-ka_xyz%2F20141030%2F20141030003117.png)