Java9-enhanced-deprecated-annotation
提供:Dev Guides
Java 9-@Deprecatedアノテーションの強化
@Deprecated注釈は、Java 5バージョンで導入されました。 @Deprecatedで注釈されたプログラム要素は、次の理由のいずれかのために使用すべきではないことを意味します-
- その使用はエラーにつながる可能性があります。
- 将来のバージョンでは互換性がない可能性があります。
- 将来のバージョンでは削除される可能性があります。
- より優れた効率的な代替手段がそれをスーパーシードしました。
非推奨の要素が使用されるたびに、コンパイラは警告を生成します。 Java 9では、@ Deprecatedアノテーションに2つの新しい機能強化が行われました。
- forRemoval -注釈付きの要素が将来のバージョンで削除されるかどうかを示します。 デフォルト値はfalseです。
- since -注釈付き要素が非推奨となったバージョンを返します。 デフォルト値は空の文字列です。
sinceで非推奨
Java 9のブールクラスjavadocの次の例は、@ Deprecatedアノテーションでのsince属性の使用を示しています。
[Class]
forRemovalで非推奨
Java 9のSystemクラスjavadocの次の例は、@ Deprecated注釈でのforRemoval属性の使用を示しています。
[Class]