Аннотации дополняют теги Javadoc - PullRequest
2 голосов
/ 21 октября 2009

Почему сказано, что аннотации дополняют теги Javadoc?

Ответы [ 2 ]

5 голосов
/ 21 октября 2009

Аннотации являются кодом и будут представлены на уровне байтового кода. Теги Javadoc - это артефакты уровня документации и метаданные для процессора Javadoc.

Если уровень хранения класса аннотаций - время выполнения, вы можете отразить этот класс и получить доступ к аннотации; для тега javadoc такой возможности не существует (если у вас нет доступа к исходным файлам и вы их анализируете).

Таким образом, в очень узком смысле (например, процессор Javadoc, который выполняет обработку байт-кода, например, генерирует код), теги можно считать «дополнительными» [sic] к аннотациям, но это все.

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

4 голосов
/ 21 октября 2009

Одной из возможных причин является то, что использование аннотаций может совпадать с использованием тегов Javadoc.

Наилучшим примером, конечно, является тег @deprecated Javadoc и аннотация @Deprecated, которые указывают на одно и то же.

И аннотации, и теги Javadoc предоставляют метаданные об элементах кода.

...