java - 在继承类中重载 Javadoc

Question

我在 Java 中重新创建了以下功能层次结构：

   Diagram
     |
     |--Model
          |
          |--Entity

所有这些对象都共享一些共同的属性（id、name）以及对层次结构中父对象的引用。所以我实现了一个抽象类：

abstract class DBObject{
   private final int id;
   private final String name;
   private final DBObject parent;

   //constructors, getters, setters here

   /**
    * @return reference to parent object in hierarchy.
    */
    public final getParent(){
       return parent;
    }
}

到目前为止没有问题。问题是，Diagram 没有父级，并且总是返回 null。这是通过实施来确保的。但我想在 Diagram Javadoc 中反映“父级始终为空”。是否可以在不覆盖方法的情况下重载 Javadoc？解决方案是在抽象类中将其声明为注释，但这不是我正在寻找的答案。

谢谢。

Answer 1

这个怎么样？

/**
* @return reference to parent object in hierarchy. may be null.
*/
@Nullable
public final DBObject getParent(){
   return parent;
}

Answer 2

要替换 Javadoc，您必须覆盖子类中的方法。

例如

Iterator.iterator() 在
Collection.iterator() 中被覆盖，它被
Set.iterator() 覆盖，它被
NavigableSet.iterator() 覆盖，只是为了给每个不同的 Javadoc。