Интерфейс аннотации Deprecated

@Documented @Retention(RUNTIME) @Target({CONSTRUCTOR,FIELD,LOCAL_VARIABLE,METHOD,PACKAGE,MODULE,PARAMETER,TYPE}) public @interface Deprecated

Элемент программы, помеченный @Deprecated, — это элемент, использование которого программистами не рекомендуется. Элемент может быть объявлен устаревшим по разным причинам: например, его использование может привести к ошибкам; он может быть изменён несовместимым образом или удалён в будущей версии; он может быть заменён более новой, обычно предпочтительной альтернативой; либо он может быть устаревшим.

Компиляторы выдают предупреждения, если устаревший элемент программы используется или переопределяется в коде, не содержащем устаревших элементов. Использование аннотации @Deprecated при объявлении локальной переменной, параметра или пакета не влияет на предупреждения, выдаваемые компилятором.

Если модуль объявлен устаревшим, его использование в requires, но не в предложениях exports или opens, приводит к выдаче предупреждения. Объявление модуля устаревшим не приводит к выдаче предупреждений при использовании типов внутри модуля.

Этот тип аннотации содержит элемент со строковым значением since. Значение этого элемента указывает версию, в которой аннотированный элемент программы впервые был объявлен устаревшим.

Этот тип аннотации содержит элемент с логическим значением forRemoval. Значение true указывает на намерение удалить аннотированный элемент программы в будущей версии. Значение false указывает, что использование аннотированного элемента программы не рекомендуется, но на момент его аннотирования не было конкретного намерения удалить его.