java - 注释主要是关于记录代码还是由编译器强制执行？

Question

@Deprecated public class Betamax { ... }

在上面的例子中，@Deprecated 有什么作用？它是纯粹的文档吗？或者它是否改变了编译器如何处理这个类？

score 2 · Accepted Answer

编译器强制执行（如检查和 croaks on）一些注释（如@Override）。

但最有用的部分是库可以提供自己的注解（如@Entity或@PersistenceAware），Java 语言（JDK 核心）对此一无所知。这有点像在语言中添加特定领域的语法糖。

@Deprecated用于文档。当您使用不推荐使用的方法（或类）时，它还会创建编译器警告，就像旧的 JavaDoc@deprecated标记一样。

score 1 · Accepted Answer

纯粹出于文档目的。

如果您将某些内容标记为已弃用，那么您通过生成的 Javadoc 向用户指示不应使用此方法/类，例如

日期（整数年，整数月，整数日期）：已弃用。从 JDK 版本 1.1 开始，由 Calendar.set(year + 1900, month, date) 或 GregorianCalendar(year + 1900, month, date) 取代。

如果您将某些内容标记为已弃用，最好向用户说明他们应该使用什么来代替此方法。

2 回答 2