Главная » Java » ©since в Java

0

 

   Тэг @since позволяет задать номер версии, который обозначает, с какого момента определенная сущность добавлена в код или изменена:

     @since  2.1

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

 

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

По теме:

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