よく一緒に購入されている商品
商品の説明
内容（「BOOK」データベースより）
現場で真に使えるAPI仕様書を作るための解説書。Javadocタグの利用方法はもちろん、「仕様の記述」という観点から、書くべき内容や考えなければならないポイントもチェックリスト形式で完全指南。ソースコードからAPI仕様書を生成する手順や「契約による設計」を支援するツールも紹介。
著者について
「ソースコードがドキュメント」の意味、あなたは正しく理解できていますか?
「Javadoc」とは、JavaのソースコードからHTML形式のAPI仕様書を生成するための
テクノロジーです。多くのJavaプログラマは日常的にJavadocを利用しており、また
その記述方法も広く知られています。しかし、開発の現場で“使えるJavadoc”を目に
する機会はほとんどどありません。記述されてはいるものの、意味のある内容だとは
到底思えないようなJavadocが氾濫しているのです。そこで本書では、優れたJavadocから
得られる多くのメリット(設計の効率化、再利用性の向上、学習コストの低下 etc.)を
示し、これに必要となる知識や書き方についてを徹底的に解説します。Java開発に携わる
方はもちろん、すべてのアーキテクト/プログラマ必読の1冊です。
「Javadoc」とは、JavaのソースコードからHTML形式のAPI仕様書を生成するための
テクノロジーです。多くのJavaプログラマは日常的にJavadocを利用しており、また
その記述方法も広く知られています。しかし、開発の現場で“使えるJavadoc”を目に
する機会はほとんどどありません。記述されてはいるものの、意味のある内容だとは
到底思えないようなJavadocが氾濫しているのです。そこで本書では、優れたJavadocから
得られる多くのメリット(設計の効率化、再利用性の向上、学習コストの低下 etc.)を
示し、これに必要となる知識や書き方についてを徹底的に解説します。Java開発に携わる
方はもちろん、すべてのアーキテクト/プログラマ必読の1冊です。
登録情報
|
この商品を見た後に買っているのは？
カスタマーレビュー
最も参考になったカスタマーレビュー
2 人中、2人の方が、｢このレビューが参考になった｣と投票しています。
形式:単行本（ソフトカバー）
この本を買ったきっかけは、フレームワークを拡張する仕事で必要に迫られたから。
ただ、読んでビックリ。
単にJavadocの入門書ではなく、ある程度Javaを理解していることが望ましい。
新人エンジニアが手に取ると厳しいのではないか。
この本に書かれていることが、すらすら理解できることは大事。
ちなみに、著者の肩書きはプログラマ兼アーキテクトである。
自身のJavaエンジニア度チェックに最適ではないだろうか。
ただ、読んでビックリ。
単にJavadocの入門書ではなく、ある程度Javaを理解していることが望ましい。
新人エンジニアが手に取ると厳しいのではないか。
この本に書かれていることが、すらすら理解できることは大事。
ちなみに、著者の肩書きはプログラマ兼アーキテクトである。
自身のJavaエンジニア度チェックに最適ではないだろうか。
1 人中、1人の方が、｢このレビューが参考になった｣と投票しています。
形式:単行本（ソフトカバー）
ソフトウェア開発のスピードはどんどん上がってきています。
それとともに置き去りにされがちなのがドキュメント。
多くの人はドキュメントそのものの必要性に異論はないでしょう。ただどこまで書けば良いのか、できればドキュメントは書きたくない（そんな時間もないし）、実装に注力したいというのも本音だと思います。
本書ではどこまで省いてどこまで書くべきか、その落としどころ（の１つ）を紹介していると感じます。
こうした内容があれば実装時に負担にならず、かつのちのちの効率にも寄与するドキュメント（この場合はJavadoc）レベルを満たすことができる、ということを教えてくれるものです。
これが唯一の解ではありませんが、１つの良い事例として読むとよいでしょう。
それとともに置き去りにされがちなのがドキュメント。
多くの人はドキュメントそのものの必要性に異論はないでしょう。ただどこまで書けば良いのか、できればドキュメントは書きたくない（そんな時間もないし）、実装に注力したいというのも本音だと思います。
本書ではどこまで省いてどこまで書くべきか、その落としどころ（の１つ）を紹介していると感じます。
こうした内容があれば実装時に負担にならず、かつのちのちの効率にも寄与するドキュメント（この場合はJavadoc）レベルを満たすことができる、ということを教えてくれるものです。
これが唯一の解ではありませんが、１つの良い事例として読むとよいでしょう。
8 人中、5人の方が、｢このレビューが参考になった｣と投票しています。
形式:単行本（ソフトカバー）
知っているようで、以外と知らないJavaDocの使い方が
体系的に勉強できます。
Java技術者であればざっとみておくと有益だと思います。
とくにJavaDocコマンドの各種オプションの詳細について解説して
ある本はこの本だけかもしれません。
ただドキュメンテーションコメントのつけ方については、あまりに
過剰・神経質になりすぎても実際の現場では現実的ではないでしょう。
あくまで、理想論としてとらえておくべきだと思いました。
体系的に勉強できます。
Java技術者であればざっとみておくと有益だと思います。
とくにJavaDocコマンドの各種オプションの詳細について解説して
ある本はこの本だけかもしれません。
ただドキュメンテーションコメントのつけ方については、あまりに
過剰・神経質になりすぎても実際の現場では現実的ではないでしょう。
あくまで、理想論としてとらえておくべきだと思いました。
リストマニア
|
|
同じキーワードの商品を探す
フィードバック
- カタログ情報、または画像について報告
- 著者からのコメント
- 出版社からのコメント
|
