Перейти к содержанию

Депрекация

Материал из Википедии — свободной энциклопедии
(перенаправлено с «Deprecation»)

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

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

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

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

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

В языке Java используется две нотации этого тега — аннотация @Deprecated (компилятор в обязательном порядке выдаст предупреждение об использовании нежелательного элемента) и тег Javadoc @deprecated (чтобы отметить это в документации). Компиляторы Sun также выдают предупреждение (хоть стандарт и не обязывает это делать).

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

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

В C++14 используется атрибут [[deprecated]][2].

Примечания

[править | править код]
  1. ↑ @deprecated. Дата обращения: 27 января 2017. Архивировано из оригинала 2 февраля 2017 года.
  2. ↑ deprecated (C++). Дата обращения: 27 января 2017. Архивировано 2 февраля 2017 года.