この記事はブログに投稿されたものの転載です。 最近のJava API仕様書生成という見地からまとめてみました。 なんでAPI仕様書なのか? オブジェクト指向にはカプセル化という概念があり、クラスメソッドを呼んでやれば期待する値が返ってくる構造になっています。ただし、引数として何を渡せば良いのか、どのような値が返ってくるのか、異常時にどの様な例外処理が発生するのか等々を事前に把握しておかないと、場当たり的にコードを書き散らすことになります。そこで、きちんとAPIを定義しておき、利用者が無駄なく安心してクラスメソッドを利用できるようにしておくワケです。そのためAPI仕様書が必要なのです。 JavaDocの利用 ここからは現在プロジェクトで利用しているAPI仕様書の生成手順について説明しましょう。 まずは皆さんご存知のJavaDocです。JavaDocフォーマットのコメント元にAPI仕様書を生成
![最近のJava API仕様書生成について - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/3bd7b6f60c8ea4f5060c24e735d4c3698e2dd274/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-9f5428127621718a910c8b63951390ad.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTkxNiZoPTMzNiZ0eHQ9JUU2JTlDJTgwJUU4JUJGJTkxJUUzJTgxJUFFSmF2YSUyMEFQSSVFNCVCQiU5NSVFNiVBNyU5OCVFNiU5QiVCOCVFNyU5NCU5RiVFNiU4OCU5MCVFMyU4MSVBQiVFMyU4MSVBNCVFMyU4MSU4NCVFMyU4MSVBNiZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTU2JnR4dC1jbGlwPWVsbGlwc2lzJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9OGU3ZWI0ZmI1NWEzZDE2NGQ3ZjZjYTQxZmI1ZWY1NWQ%26mark-x%3D142%26mark-y%3D112%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTYxNiZ0eHQ9JTQwbW1vcml0YTQ0JnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9MzYmdHh0LWFsaWduPWxlZnQlMkN0b3Amcz1kOTlmZWQwZWExYjNjOTcxNmYyNjEzZDc1ODhiY2E2OA%26blend-x%3D142%26blend-y%3D491%26blend-mode%3Dnormal%26s%3D433e4a8bf749d3fe7ff1f54c8df435ae)