Улучшенная аннотация @Deprecated в Java 9

Java 9 новые возможности

Аннотация @Deprecated может маркировать состояние Java API и может быть одного из следующих типов:

• Использование её представляет риск и может привести к ошибкам

• Может быть несовместим в будущих версиях

• Может быть удален в будущих версиях

• Лучшая и более эффективная схема уже заменила её.

В Java 9 добавлены два новых элемента аннотации:since и forRemoval.

• since: элемент определяет, с какой версии API элемент, помеченный аннотацией, считается устаревшим.

• forRemoval: элемент указывает, что API элемент аннотации будет удален в будущих версиях и должен быть迁移 API.

Ниже приведен пример документации о классе Boolean в Java 9, в которой используется анаnotated @Deprecated с атрибутом since:Класс Boolean.

Ниже приведен пример документации о системных классах в Java 9, в которой используется анаnotated @Deprecated с атрибутом forRemoval:Класс System.

Java 9 новые возможности