As anotações complementam tags javadoc

Question

Por que é dito que as anotações complementam as tags javadoc?

Answer 1

Um motivo possível é que o uso de anotações pode se sobrepor ao Javadoc Tags.

O melhor exemplo, é claro, é o @deprecated Tag javadoc e o @Deprecated Anotação, que indica a mesma coisa.

As anotações e as tags javadoc fornecem metadados sobre os elementos de código.

Answer 2

As anotações são de código e serão representadas no nível do código de bytes. As tags Javadoc são artefatos no nível da documentação e são metadados para o processador Javadoc.

Se o nível de retenção da classe de anotação estiver em tempo de execução, você poderá refletir sobre a classe e acessar a anotação; Não existe essa possibilidade para a tag javadoc (a menos que você tenha acesso a arquivos de origem e os esteja analisando).

Portanto, em um sentido muito restrito (por exemplo, um processador Javadoc que faz processamento de bytecode, como geração de código), as tags podem ser consideradas "complementares" [sic] para anotações, mas é isso.

No geral, é um meme ruim para carregar em sua cabeça, pois realmente não informa a verdadeira distinção entre essas duas construções totalmente diferentes.