Java 9 — расширенная аннотация @Deprecated
Аннотация @Deprecated была введена в версии java 5. Элемент программы, помеченный аннотацией @Deprecated, означает, что его нельзя использовать по любой из следующих причин —
- Его использование может привести к ошибкам.
- Он может быть несовместим с будущей версией.
- Он может быть удален в будущей версии.
- Его заменила лучшая и эффективная альтернатива.
Компилятор генерирует предупреждения всякий раз, когда используется устаревший элемент. В Java 9 в аннотацию @Deprecated внесены два новых улучшения.
-
для удаления − Указывает, подлежит ли аннотированный элемент удалению в будущей версии. Значение по умолчанию — ложь.
-
с − Возвращает версию, в которой аннотированный элемент устарел. Значение по умолчанию — пустая строка.
Устарело с
Следующий пример логического класса javadoc на Java 9 иллюстрирует использование атрибута "с тех пор" в аннотации @Deprecated.
Логический класс
Устарело с forRemoval
В следующем примере javadoc класса System на Java 9 показано использование атрибута forRemoval в аннотации @Deprecated.
Класс системы
java