Javadoc 和继承 类

Javadoc and inherited classes

在我的工作场所,我正在查看 Javadoc,发现对于特定方法,return 值是 x,而实际上是 y(class y 继承了 class x).

你怎么看?我问过设计师,他们告诉我,因为 x 包含在 y 中,所以如果在 Javadoc 中它应该是 return x,那么 u return x 或 y 并不重要...... 我认为这是错误的,因为两个: 1. 即使实例保持不变,用户也应该知道他得到的是真实的对象。 2. 用户不应该访问他不应该访问的实例。

您可以在子类方法中声明 return 类型 y,如果您这样做[我希望] javadoc 会反映出来。