java - 为什么 @Documented 注解有运行时保留？

Question

据我所知，@Documented 注释仅由 javadoc 生成器用于从源代码生成 javadoc。所以保留类型应该是SOURCE，但它是RUNTIME。为什么？

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Documented {
}

Answer 1

IMO that does not explain why @Documented needs runtime retention

是的，确实如此。假设我发送了一个没有源代码的 jar 文件。用户可以仅使用来自类文件的信息构建适当的 javadoc，因为类文件具有适当注释的原因是它们是 RetentionPolicy.RUNTIME。