Аннотация Deprecated

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

В Java 9 были добавлены новые атрибуты к аннотации @Deprecated: since и forRemoval, что сделало ее более информативной. Атрибут since используется для указания версии, в которой элемент стал устаревшим, в то время как атрибут forRemoval указывает, что элемент будет удален в будущей версии.

Пример, класс ClientHttpRequest из spring-boot версии 3.2.3 и вложенный в него класс OkHttp:

@Deprecated(since = "3.2.0", forRemoval = true) static class OkHttp {   //... }

И мы можем понять - этот класс устарел с версии 3.2.0 и будет удален в будущей версии.

#java #deprecated