TOP書籍連動> アノテーションを使ってみよう




まるごとEclipse!
最新Eclipse 3.1によるEclipse再入門

第3回:アノテーションの使用

著者:DTS  木村 真幸(KIMURA, Masayuki)   2006/02/22
1   2  3  次のページ
アノテーションを使ってみよう

   Eclipseの基本的な動作を押さえたところで、J2SE 5.0の新機能であるアノテーション(Annotations)を使ってみましょう。

   アノテーションとは、クラスやメソッド、フィールドなどのプログラム要素に対して、プログラム的に意味付けを行うことです。アノテーションを使わない場合、ソースコードにコメントを挿入したり、別途ドキュメントを作成するなどしてプログラム要素の意味を残すのが普通です。

   しかし、これはプログラムコードと必ずしも同期しているわけではなく、時とともにドキュメントがプログラムに対して古くなってしまうというのは読者にも経験があるのではないでしょうか。

   ここでは、よく使われると思われる「Overrideアノテーション」「Deprecatedアノテーション」「SuppressWarningsアノテーション」を使ってみます。

   事前準備として、「Annotations」プロジェクトとパッケージ名「jp.co.impress.example」の「AnnotationsExample」クラスを作成します(作成方法は前回を参照してください)。


Overrideアノテーション

   Overrideアノテーションは、メソッドのオーバーライドの記述ミスなどを確実に防ぐためのものです。エディターの右クリックから「ソース → メソッドのオーバーライド/実装」を選択します(図1)。

メソッドのオーバーライド
図1:メソッドのオーバーライド
(画像をクリックすると別ウィンドウに拡大図を表示します)

   メソッドをオーバーライド/実装ウィンドウから「toString()」をチェックして、「OK」をクリックします(図2)。

toStringメソッドのオーバーライド
図2:toStringメソッドのオーバーライド

   toString()メソッドがオーバーライドされ、メソッドの1行上に「@Override」とアノテーションが記述されています(図3)。

Overrideアノテーションが記述されたメソッド
図3:Overrideアノテーションが記述されたメソッド

   これだけではOverrideアノテーションの意味がわかりづらいので、toStringメソッドの名称をxxStringに変えてファイルを保存します。すると、Overrideアノテーションが記述されているので、コンパイル時にxxStringメソッドがスーパークラス(ここではjava.lang.Objectクラス)のメソッドとして定義されているかどうかの検証が行われます。

   コンパイラは親クラスにxxStringメソッドが定義されていないのを検知し、オーバーライドが正しく行われていないことをエラーとして通知します(図4)。

Overrideアノテーションによりエラーが検出
図4:Overrideアノテーションによりエラーが検出
(画像をクリックすると別ウィンドウに拡大図を表示します)

   なお、@Overrideの記述がない場合は検証が行われないため、通常のメソッドとしてコンパイルされ、エラーは発生しません。単純なミスで時間を浪費しないように@Overrideの記述を忘れないようにしましょう。

1   2  3  次のページ

書籍紹介
まるごとEclipse! Vol.1
まるごとEclipse! Vol.1 Javaの統合開発環境として定番のEclipse。その最新版をまるごと紹介
オープンソースの統合開発環境として定番の地位が揺るぎないEclipse(エクリプス)。プラグインによりその機能を自由に拡張することができるアーキテクチャによって、今ではJava開発環境の枠を越えて汎用的なアプリケーションフレームワークとして利用されている。2005年末に正式リリースされたサーバサイドWebアプリケーション開発環境Web Tools Platform(WTP)、Webを超えたユーザーインターフェースを提供するEclipse RCP(Rich Client Platform)など、Eclipseの最新版3.1とその周辺技術にスポットを当て、最新情報を余すことなく解説!

発売日:2006/02/02発売
定価:\2,079(本体 \1,980+税)
DTS  木村 真幸
著者プロフィール
株式会社DTS システム開発本部 産業事業部
木村 真幸(KIMURA, Masayuki)

開発プロセス、Strutsベースのフレームワーク開発担当。プロジェクトの技術支援やセミナー講師も行う。多忙な毎日で子供には「たまに来る優しいおじさん」と思われている。

この記事の評価をお聞かせください
ボタンをクリックしますとウインドウが開きます。

INDEX
第3回:アノテーションの使用
アノテーションを使ってみよう
  Deprecatedアノテーション
  Eclipseの小技&ちょっとうれしいプラグイン
最新Eclipse 3.1によるEclipse再入門
第1回 Eclipseプロジェクト
第2回 Eclipseのインストール
第3回 アノテーションの使用
第4回 小技で作業効率をあげる
第5回 FindBugsプラグイン