eclipse - {@inheritDoc} 不继承 Eclipse 中的父类(super class) javadoc

Question

当我使用 {@inheritDoc}在 Eclipse 中，父类(super class)的 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() 上时我收到了 AbstractTableModel工具提示中的 javadoc。当我从 Eclipse 生成 javadoc 时，我确保在“引用的文件和项目”部分中 rt.jar被选中。但是继承文档不起作用。

Answer 1

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