「Javaを使ってるけど、アノテーションって何?」と思っているかたのために記事を書きました。アノテーションは「注釈」を意味する言葉で、Javaを書くときに大切な情報をコメントできるものです。アノテーションがわかれば、Javaのコードがより見やすくなりますよ。アノテーションの種類や使い方など具体的にはわかりにくいところがありますよね。自作アノテーションとその使い方の順にアノテーションについて紹介します。アノテーション、というと難しく感じるかもしれませんが、要するにコードへ書き込む注釈のことです。ハードルは高くないので、まずはこの記事で概要を理解してしまいましょう!無料メルマガ登録はこちら:最新のデジタルシフト事例やノウハウを毎週お届けアノテーションの前に知っておきたい「Javadoc」とは本題に入る前に、Javadocコメントを知っておきましょう。「Javadoc」とはJavaに書き込めるコメントのことです。これを使うことで、プログラムについての説明をソースコードに付け加えられます。プログラムが書かれたファイルプログラムの説明が書かれたファイルという2つのファイルを管理するのではなく、Javadocでソースに直接コメントして、2つを同時に管理します。使い方は、以下のように書きます。/コメントの”@(アットマーク)”から書かれた文字列がJavadocです。@author@versionという、意味をもったタグをつけ、コメントとして機能させます。そもそもアノテーションとは?Javadocについてざっくりとお伝えしたところで、ここからはアノテーションについて紹介していきます。アノテーションとは、英語で「注釈、注記」などの意味がある言葉です。Javaのコード上では”@(アットマーク)”からはじまり、コードでは表現しきれない情報を、補足としてつけ加えられます。具体的に記述する場所はクラスインターフェースメソッドメンバ変数メソッド引数などがあります。「アノテーションって、結局のところただの注釈なの?」と思ったかたもいるかもしれません。注釈という意味のアノテーションですが、できることはたくさんあります。チームでの開発をするときに、コーディングのやり方を統一することもできます。テキストや口頭で伝えるのも大切ですが、実際にコードを書くところにルールを書いておくことで、ミスを避けることが可能です。ほかにもアノテーションは、記述することでコンパイラの警告メッセージを出なくするプログラムを実行する環境に合わせて、動作を変えるなどができます。主なアノテーション一覧アノテーションは、データがあるかどうかデータの数によって以下の3つに分けられます。データが無く、名前だけのマーカー(@Override、@Deprecatedなど)データをひとつだけ持つ単一アノテーション(@SuppressWarningsなど)複数のデータをもつフル・アノテーションよく使うアノテーションは@Override:親クラスにないメソッドをエラーにし、記述の間違いをなくす@Deprecated:Javaの記述が非推奨のものだと表す@SuppressWarnings:無理なメソッドの記述で起こる警告を見せないようにするの3つです。アノテーションは自作できる標準のアノテーションを紹介しましたが、結局のところ一番よく見るのは自作のアノテーションです。アノテーションを独自で作るためには、「メタアノテーション」というものを使う必要があります。:コンパイル・プログラムの処理で、アノテーションの情報を保持するかどうかを決める@author:プログラムをつくった人の名前を書くなどです。自作アノテーションの定義にはJavaファイルを専用で作る必要があります。できることはこの他にもたくさんあるので、まずは基本からチェックして、徐々に他のものに手を出していきましょう。アノテーションを活用して、コードを見やすくしようアノテーションについて、基本的な使い方・作り方を紹介しました。Javadocについて、プログラムが書かれたファイルプログラムの説明が書かれたファイルという2つのファイルを管理するのではなく、ソースに直接コメントして同時に管理するとお伝えしましたね。そもそもアノテーションとは、英語で「注釈、注記」などの意味がある言葉でクラスインターフェースメソッドメンバ変数メソッド引数などに記述します。具体的なできることはコードを書く場所にルールを書き、ミスをなくすコンパイラの警告メッセージを出なくするプログラムを実行する環境に合わせて、動作を変えるなどです。アノテーションは、データがあるかどうかデータの数によってデータが無く、名前だけのマーカー(@Override、@Deprecatedなど)データをひとつだけ持つ単一アノテーション(@SuppressWarningsなど)複数のデータをもつフル・アノテーションの3つに分けられます。使うアノテーションは@Override:親クラスにないメソッドをエラーにし、記述の間違いをなくす@Deprecated:Javaの記述が非推奨のものだと表す@SuppressWarnings:無理なメソッドの記述で起こる警告を見せないようにするの3つです。:コンパイル・プログラムの処理で、アノテーションの情報を保持するかどうかを決める@author:プログラムをつくった人の名前を書くなどがあり、専用でJavaファイルを作る必要があるとお伝えしました。アノテーションを活用できれば、Javaのコードが見やすくなり、ミスを減らしつつ効率的に開発できます。ゴウ大手Sierや、ECコンサルティング会社での経験を活かし、ファッションや食品などの各種商品ジャンルから、バックオフィス、ITインフラ系まで幅広く執筆が可能。webライティングの講師や、メディアコンサルティング、採用系メディアの編集長なども請け負っている。