Java アノテーション (Annotations)

1. Java アノテーションとは

アノテーション（Annotations）は、Javaのソースコードに追加する特別な注釈（メタデータ）です。これらは @ 記号から始まります。

アノテーション自体がプログラムの実行動作を直接変えることはありませんが、コンパイラや開発ツールに対して追加情報を提供し、ビルド時やデプロイ時に特定の処理を行わせるために使用されます。

2. ビルトイン・アノテーション

Javaには標準でいくつかのアノテーションが組み込まれています。以下は、開発現場で特によく使われるものです。

3. @Override アノテーション

@Override は、そのメソッドがスーパークラスのメソッドを正しくオーバーライド（再定義）しているかどうかをコンパイラにチェックさせます。

記述は必須ではありませんが、タイポ（打ち間違い）によるバグを未然に防ぐために、使用することが強く推奨されます。

3.1 コード例：正しいオーバーライド

以下の例では、スーパークラスのメソッドを適切にオーバーライドしています。

class Animal {
  void makeSound() {
    System.out.println("動物の鳴き声");
  }
}

class Dog extends Animal {
  @Override
  void makeSound() {
    System.out.println("ワンワン！");
  }
}

3.2 コード例：タイポによるエラー

もし誤ってメソッド名を間違えて記述した場合（例：makesound()）、コンパイラはエラーを報告します。

class Animal {
  void makeSound() {
    System.out.println("動物の鳴き声");
  }
}

class Dog extends Animal {
  @Override
  void makesound() { // ここでタイポ（sが小文字）！
    System.out.println("ワンワン！");
  }
}

public class Main {
  public static void main(String[] args) {
    Animal myDog = new Dog();
    myDog.makeSound();
  }
}

コンパイル結果:

Main.java:8: error: method does not override or implement a method from a supertype

これが @Override のメリットです。もしこのアノテーションがなければ、コンパイラはエラーを出さず、単に「新しい別のメソッド」として認識してしまいます。その結果、意図したオーバーライドが行われず、プログラムが予期せぬ挙動を示す原因となります。

4. @Deprecated アノテーション

@Deprecated は、そのコードが非推奨であることを示します。これは「まだ動作はするが、将来的には削除されるか別の方法に置き換わるため、使用を控えるべき」という開発者へのサインです。

4.1 コード例：非推奨メソッドの使用

public class Main {
  @Deprecated
  static void oldMethod() {
    System.out.println("このメソッドは古くなっています。");
  }

  public static void main(String[] args) {
    oldMethod(); // ほとんどのIDEで取り消し線などの警告が表示されます
  }
}

このメソッドを実行することは可能ですが、コンパイル時やIDE上では以下のような警告が表示されます：

warning: [deprecation] oldMethod() in Main has been deprecated

5. @SuppressWarnings アノテーション

@SuppressWarnings は、コンパイラが発する特定の警告（"unchecked" や "deprecation" など）を意図的に抑制（無視）する場合に使用します。

5.1 コード例：警告の抑制

import java.util.ArrayList;

public class Main {
  @SuppressWarnings("unchecked")
  public static void main(String[] args) {
    // 型引数を指定しない ArrayList (生型) の使用
    ArrayList cars = new ArrayList();
    cars.add("ボルボ");
    System.out.println(cars);
  }
}

ArrayList<String> のように型を指定せずに ArrayList を使用すると、通常は "unchecked"（未検査）警告が発生します。
@SuppressWarnings("unchecked") を付与することで、その警告を表示させないようにできます。これはレガシーなコードを扱う際などに便利です。

しかし、警告を隠すよりも、以下のように型安全なコードに修正するのが本来の推奨されるアプローチです。

ArrayList<String> cars = new ArrayList<>();