Главная » Java » @deprecated в Java

0

Тэг ©deprecated применяется для обозначения сущностей кода, не рекомендуемых для дальнейшего использования. Код, ссылающийся на устаревшие ти-ПЬ1> конструкторы, методы или поля, при компиляции может вызывать появле-Ние предупреждающих сообщений. Существующий код, основанный на использовании   подобных   элементов   и   не   подвергавшийся   обновлению,   должен   по-прежнему работать. Механизм выдачи рекомендаций относительно предпочтений выборе инструментальных средств поощряет пользователей к переходу на более совершенные  версии  программного  обеспечения,   но  отнюдь  не  запрещает применение существующего кода. Пользователи должны сами выбирать для себя удобный момент для выполнения замены версий — принудительно заставляя их делать это нельзя.  Задача информирования пользователей о наличии бол

совершенных версий программы возлагается на вас, ее автора:

/**       

* Реализация метода дихотомии

* для  решения  задачи трех станков.  

* @deprecated      вместо scheduler рекомендуется использовать

                                                                                                            schNew

* @see                #schNew

 V public void scheduler О

 throws BadlnputDataException;

 

Тэг @deprecated обнаруживается компилятором, если он расположен в начале строки  комментария  документирования.   Следующий   за  тэгом  идентификатор помечается компилятором как не рекомендуемый к дальнейшему применению.

Это единственный случай, когда содержимое комментария оказывает влияние на поведение компилятора.

 

Источник: Арнолд, Кен, Гослинг, Джеймс, Холмс, Дэвид. Язык программирования Java. 3-е изд .. : Пер. с англ. – М. : Издательский дом «Вильяме», 2001. – 624 с. : ил. – Парал. тит. англ.

По теме:

  • Комментарии