Депрекация

Депрекация (из английского языка) — в программировании, некоторое указание нежелательности применения какой-либо части программы, процедуры или языка программирования. Чаще всего используется какой-либо стандартный для данного языка программирования или системы документации кода способ указания, например служебная метка (тег), специальная конструкция языка и т. п. В среде разработчиков компьютерных программ и документации, термин «депрекация» может обозначать очередную стадию в жизненном цикле программного обеспечения, замену устаревших частей на новые.

Часть программы или метод, обозначенный как deprecated, являются сомнительными, и использование их в дальнейшем необоснованно. Эта часть работает в текущей версии ПО, однако может вызывать сообщение об ошибке в качестве предупреждения. Это служит для предупреждения пользователя о том, что данная часть кода может быть удалена в следующих релизах программы.

Основной причиной объявления части кода (функций, методов, классов) как deprecated является желание улучшать код, и, при этом, со временем избавляться от устаревших подходов. Оставление старого кода наряду с новым приводило бы к неоправданному разрастанию программного продукта, что усложняло бы его поддержку, изучение и использование. В то же время, просто удалять устаревшие части кода нежелательно, так как это нарушит обратную совместимость для пользователей данного ПО.

При пометке кода deprecated обычно указывается рекомендуемая замена, например новый компонент с другим программным интерфейсом, но, по сути, с той же функциональностью. Но иногда часть кода объявляется deprecated безо всякой замены. Обычно это бывает при обнаружении багов, которые принципиально неустранимы при сохранении использованного подхода.

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

Примеры

В языке Java используется две нотации этого тега:

• @Deprecated — компилятор в обязательном порядке выдаст предупреждение о использовании нежелательного элемента
• @deprecated — выдача предупреждения является необязательной, хотя компиляторы Sun предупреждение выдают.

В phpDocumentor используется два дескриптора, которые являются синонимами^[1]:

• @deprecated
• @deprec

В Delphi используется ключевое слово deprecated;

В С++ от Microsoft используется конструкция __declspec(deprecated( .... )) ^[2]

Примечания

1. ↑ phpDocumentor Manual
2. ↑ MSDN deprecated (C++)

См. также

• Javadoc
• phpDocumentor
• Obsolescent

Для улучшения этой статьи желательно?: Найти и оформить в виде сносок ссылки на авторитетные источники, подтверждающие написанное.

Эту статью следует викифицировать. Пожалуйста, оформите её согласно правилам оформления статей.