アノテーション（Annotation）

アノテーションについて

アノテーションはクラス、メソッド、フィールドなどにメタデータ（追加情報）を設定することができ、設定した情報はコンパイルや実行時の動作に影響を与えます。
プログラムの動作には直接影響を与えない注釈のようなものです。

コメントとの違いは、コンパイル時に影響を与えたり、
アノテーションから処理を行ったりするという所です。

アノテーションには主に以下３つの目的があります

コンパイラへの指示

コンパイル時の挙動を制御できます。例えば@SuppressWarningsアノテーションを使用するとコンパイルで警告が発生したとしても警告メッセージを出さないようにできます。

ランタイムへの情報提供

実行時にプログラムの動作を制御できます。例えばカスタムアノテーションを使用してフレームワークやライブラリに対して特定の処理を行うことができます。

ビルドツールへの情報提供

ビルドツールに対してビルドやパッケージングなどの処理方法を指示できます。

※アノテーションはJDK5以降のバージョンで使用できます。

アノテーションの種類

アノテーションには以下２種類があります。

組込みアノテーション

Javaに標準で用意されているアノテーションでそのまま使うことができます。
以下は主要な組み込みアノテーション一覧です。

@Override

（@Overrideアノテーションサンプル）

@Override
void method() {
  //処理
}

@Deprecated

（@Deprecatedアノテーションサンプル）

@Deprecated
public void oldMethod() {
  //処理
}

※ Java9以降では、以下２つの補足情報を指定できます。

（@Deprecatedアノテーションサンプル＜補足情報あり＞）

@Deprecated(since = "3.5", forRemoval = true)
public void oldMethod() {
  //処理
}

@SuppressWarnings

（@SuppressWarningsアノテーションサンプル）

@SuppressWarnings("deprecation")
public static void deprecatedMethod() {
  //処理
}

@FunctionalInterface

（@FunctionalInterfaceアノテーションサンプル）

@FunctionalInterface
interface SampleFunctionalInterface {
  void doMethod();
}

@SafeVarargs

（@SafeVarargsアノテーションサンプル）

@SafeVarargs
static <T> List<T> createList(T... elements) {
  List<T> list = new ArrayList<>();
  for (T element : elements) {
    list.add(element);
  }
  return list;
}

カスタムアノテーション

カスタムアノテーションを作成する時は、@interfaceキーワードを使用します。

（例）カスタムアノテーション「MyAnnotation」を定義して使用するサンプル

// カスタムアノテーションの定義
import java.lang.annotation.*;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface MyAnnotation {
    String value();
}

// カスタムアノテーションの使用
public class MyClass {
    @MyAnnotation("カスタムアノテーションの例")
    public void myMethod() {
        // メソッドの処理
    }
}

上記の例では @MyAnnotationというカスタムアノテーションを定義しています。
@Retentionアノテーションと@Targetアノテーションは、アノテーションの動作を指定しています。