Java 9における@Deprecatedアノテーションの改善点とは？新要素「since」「forRemoval」を徹底解説

@Deprecatedアノテーションとは

クラス、メソッド、フィールドなど、プログラム内のあらゆる要素に付与できる@Deprecatedアノテーションは、「その要素はもはや使用すべきではない」ことを示すためのものです。要素が非推奨とされる主な理由は以下の通りです。

• 使用すると危険であり、エラーを引き起こす可能性がある
• 将来のバージョンで互換性がなくなる可能性がある
• 将来のバージョンで削除される可能性がある
• より優れた、効率的な代替手段がすでに提供されている

Java 9で追加された2つの新しい要素

Java 9では、@DeprecatedアノテーションにsinceとforRemovalという2つの新しい属性が追加されました。これにより、非推奨APIに関する情報をより詳細に伝えられるようになりました。

1) since属性

該当するAPI要素がどのバージョンで非推奨になったのかを指定します。開発者はこの情報から、非推奨化された時期を正確に把握し、コードの保守計画に役立てることができます。

2) forRemoval属性

注釈されたAPI要素が将来のリリースで削除される予定であることを示します。この属性が設定されている場合、開発者はできるだけ早く代替APIへの移行（マイグレーション）を検討する必要があります。

実際のドキュメントでの使用例

以下は、Java 9のBooleanクラスに関する公式ドキュメントです。ここでは、@Deprecatedアノテーションに「since」属性が使用されています。
参照：Booleanクラス

次に、Java 9のSystemクラスに関するドキュメントです。こちらでは、@Deprecatedアノテーションに「forRemoval」属性が使用されています。
参照：Systemクラス

まとめ

Java 9での@Deprecatedアノテーションの拡張により、非推奨APIが「いつ」非推奨になったのか（since）、そして「将来的に削除されるのか」（forRemoval）という情報が明示できるようになりました。これにより、開発者はAPIのライフサイクルをより正確に理解し、計画的なコードの移行や保守を行うことが可能になります。