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

Question

当我{@inheritDoc}在 Eclipse 中使用时，超类的 javadoc 注释没有出现在我的类的 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()我得到了javadoc。AbstractTableModel当我从 Eclipse 生成 javadoc 时，我确保在“引用的档案和项目”部分中rt.jar被选中。但是继承文档不起作用。

Answer 1

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