代码之家 › 专栏 › 技术社区 › Batman

Javadoc和继承的类

instances javadoc inheritance

0

Batman · 技术社区 · 10 年前

在我的工作场所,我查看了一个Javadoc,发现对于一个特定的方法,返回值是x,而实际上是y(类y继承了类x)。

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

1 回复 | 直到 10 年前

1

Erwin Smout 10 年前

您可以在子类方法中声明返回类型y,如果这样做,javadoc将反映这一点。