Java - принудительно / предупреждает устаревшую аннотацию без ссылки (или устаревшей ссылки) - PullRequest
0 голосов
/ 27 сентября 2018

Я вижу, что использование аннотации устаревания не вызывает / предупреждение, если пользователь не добавляет ссылку на новый элемент:

Возможность отказаться от класса, методаили поле члена решает проблему.Java поддерживает два механизма устаревания: и аннотацию (поддерживается начиная с J2SE 5.0) и тег Javadoc (поддерживается начиная с версии 1.1).Существующие вызовы старого API продолжают работать, но аннотация заставляет компилятор выдавать предупреждение, когда он находит ссылки на устаревшие программные элементы.Тег Javadoc и связанные комментарии предупреждают пользователей против использования устаревшего элемента и говорят им, что использовать вместо

Также укажите в @ устарелые документы оракула

Описание @deprecated в первом предложении должно как минимум сообщать пользователю, когда API устарел и что использовать в качестве замены.

Нозамена не является принудительной или предупреждает об ее отсутствии

Например, Apache StringEscapeUtils не указывает замену в нескольких случаях

public static final String escapeJava(String input)

Устаревший.

Экранирует символы в строке, используя правила строки Java ....

Или направляет на другие устаревшие методы

public static final String escapeXml(String input)

устарело.

использовать взамен escapeXml10 (java.lang.String) или escapeXml11 (java.lang.String).

Есть ли способ /инструмент, который может предупредить, если в нем не указано, что является моим (действительным) альтернативным решением дляr устарел метод / класс?

Примечание : в документах также предлагается игнорировать отсутствующую замену:

Если элемент не имеет замены, аргумент@ должно быть "Без замены".

...