Java 9: улучшенная аннотация @Deprecated
Новые возможности Java 9Аннотация @Deprecated может помечать статус Java API, который может быть одним из следующих:
- Его использование связано с риском и может привести к ошибкам
- Может быть несовместим с будущими версиями
- Может быть удалён в будущих версиях
- Его заменило лучшее и более эффективное решение.
Java 9 добавляет в аннотацию два новых элемента:sinceиforRemoval。
- since: Элемент указывает версию, в которой аннотированный элемент API был объявлен устаревшим.
- forRemoval: Элемент указывает, что аннотированный элемент API будет удалён в будущей версии, и API следует мигрировать.
Следующий пример — это документация для класса Boolean в Java 9, в которой аннотация @Deprecated использует атрибут since:Класс Boolean。
Следующий пример — это документация для класса System в Java 9, в которой аннотация @Deprecated использует атрибут forRemoval:Класс System。
