{@inheritDoc} 不继承 Eclipse 中的超类 javadoc

Question

当我在 Eclipse 中使用 {@inheritDoc} 时，超类的 javadoc cmets 没有出现在我的类的 javadoc 中。

我有以下代码：

import javax.swing.table.AbstractTableModel;

public class TestTableModel extends AbstractTableModel {

  /**
   * {@inheritDoc}
   */
  @Override
  public int getRowCount() {
    return 1;
  }

  @Override
  public Object getValueAt(int rowIndex, int columnIndex) {
    return null;
  }

  @Override
  public int getColumnCount() {
    return 0;
  }
}

我确保rt.jar 库（其中包含javax.swing.table.AbstractTableModel）设置了源代码和javadoc 位置，实际上，当我将鼠标悬停在getRowCount() 上时，我会在工具提示中看到AbstractTableModel javadoc。当我从 Eclipse 生成 javadoc 时，我确保在“引用的档案和项目”部分中选择了 rt.jar。但是继承文档不起作用。

Answer 1

看起来超类的源（在本例中为 AbstractTableModel.java）必须在 javadoc 的源路径上。这是在 Eclipse 中通过为 AbstractTableModel 创建一个项目并在 javadoc 生成期间在“选择将为其生成 Javadoc 的类型”选项中选择它来完成的。