Las anotaciones complementan las etiquetas javadoc

Question

¿Por qué se dice que las anotaciones complementan las etiquetas javadoc?

Answer 1

Una posible razón es que el uso de anotaciones puede superponerse con el de las etiquetas Javadoc.

El mejor ejemplo, por supuesto, es la etiqueta Javadoc @deprecated y la anotación @Deprecated , que indican la misma cosa.

Tanto las anotaciones como las etiquetas Javadoc proporcionan metadatos sobre los elementos de código.

Answer 2

Las anotaciones son código y se representarán en el nivel del código de byte. Las etiquetas Javadoc son artefactos de nivel de documentación y son metadatos para el procesador javadoc.

Si el nivel de retención de la clase de anotación es el tiempo de ejecución, puede reflexionar sobre la clase y acceder a la anotación; no existe tal posibilidad para la etiqueta javadoc (a menos que tenga acceso a los archivos de origen y los esté analizando).

Entonces, en un sentido muy estrecho (por ejemplo, un procesador javadoc que realiza el procesamiento de códigos de bytes, como el código de generación), las etiquetas pueden considerarse complementarias " [sic] a las anotaciones, pero eso es todo.

En general, es un mal meme para llevar en tu cabeza, ya que realmente no informa la verdadera distinción entre estas dos construcciones completamente diferentes.