주석은 javadoc 태그를 보완합니다

Question

주석이 javadoc 태그를 보완한다고 말한 이유는 무엇입니까?

Answer 1

가능한 이유 중 하나는 주석을 Javadoc 태그의 주석과 겹칠 수 있다는 것입니다.

물론 가장 좋은 예는 @deprecated Javadoc 태그와 @Deprecated 주석이며, 모두 동일한 것을 나타냅니다.

주석과 Javadoc 태그는 모두 코드 요소에 대한 메타 데이터를 제공합니다.

Answer 2

주석은 코드이며 바이트 코드 수준으로 표시됩니다. Javadoc 태그는 문서 레벨 아티팩트이며 javadoc 프로세서의 메타 데이터입니다.

주석 클래스의 보존 수준이 런타임 인 ​​경우 클래스를 반사하고 주석에 액세스 할 수 있습니다. javadoc 태그에 대한 가능성은 없습니다 (소스 파일에 액세스 할 수 있고 파싱중인 경우 제외).

매우 좁은 의미에서 (예 : 코드 생성과 같은 바이트 코드 처리를 수행하는 javadoc 프로세서) 태그는 주석에 대해 "보완적인"[sic] 것으로 간주 될 수 있지만 그게 전부입니다.

전반적으로이 두 가지 완전히 다른 구조 사이의 진정한 구별을 알려주지 않으므로 머리 속에 들고 다니는 것이 좋지 않습니다.