トップページ
日本オラクル Oracle
Atom
エンジニアのためのJavadoc再入門講座
今回ご紹介するのは、「エンジニアのためのJavadoc再入門講座」です。
|
【詳細】 出版社：翔泳社 出版年：2009年6月 |
|
|
【内容】 第１章 なぜJavadocを使うのか 第２章 Javadocの基礎 第３章 メソッドやフィールドに対するドキュメンテーションコメントの記述方法 第４章 クラスに対するドキュメンテーションコメントの記述方法 第５章 Javadocのその他の機能 第６章 Javadocを使ってAPI仕様書を生成する 第７章 アノテーションによる仕様記述 |
|
|
【概要・所感】 Java開発者であれば、Javadocコメントを書いたことがない、という人はほとんどいないと思います。しかし、JavadocをAPI仕様書として活用している、という話はあまり聞きません。本書では、広い意味でのJavadocの書き方を解説しています。 基本的な文法の網羅は勿論ですが、Javadocに記述する必要がある内容や、仕様書としてのレイアウトなど、JavadocからAPI仕様書を作成し、それを仕様書として使っていくことを想定した解説がなされています。 コメントとして記述し、ドキュメントとして利用する、という性質を持つJavadocを学ぶことは、ソースコード内のコメントの書き方や、ドキュメントに記述する内容の整理など、開発工程の様々な局面で役に立つと思われます。Javadocそのものを活用する機会の無いJava開発者にも、一読をお奨めします。 |
|
■[Java関連]内の前後の記事
↑ Java・オブジェクト指向の壁を突破する 抽象化プログラミング入門 -UMLからJavaへ、すらすらコーディングできますか? (豆蔵セミナーライブオンテキスト (3))
→ エンジニアのためのJavadoc再入門講座
↓ 明解 Javaによるアルゴリズムとデータ構造
■更新日時での前後の記事
↑ 7月17日 お天気
→ エンジニアのためのJavadoc再入門講座
↓ 7月16日 お天気