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