java - 有趣的 Eclipse JavaDoc 评论者错误

Question

因此，当我为类(class)进行实验时，我使用 ALT+SHIFT+J Eclipse 快捷方式为我的函数自动生成 Javadoc 注释。以下是一些我没有遇到问题的示例:

// ----------------------------------------------------------
 /**
 * Mutator method for setting processorSpeed.
 *
 * @param newProcessorSpeed Updated processor speed value
 */
 public void setProcessorSpeed(double newProcessorSpeed)
 {
 processorSpeed = newProcessorSpeed;
 }


 // ----------------------------------------------------------
 /**
 * Returns value of computer power
 *
 * @return numcores * processorSpeed
 */
 public double computePower()
 {
 double temp = numcores * processorSpeed;
 return temp;
 }

但是，当我尝试为此功能执行相同的快捷方式时:

public String toString()
 {
 String temp =
 processor + ", " + String.valueOf(numcores) + " cores at "
 + String.valueOf(processorSpeed) + "GHz";
 return temp;
 }

我得到的是:

// ----------------------------------------------------------
 public String toString()
 {
 String temp =
 processor + ", " + String.valueOf(numcores) + " cores at "
 + String.valueOf(processorSpeed) + "GHz";
 return temp;
 }

只是认为这是一个有趣的错误。很好奇是什么让 Eclipse 以不同的方式对待 toString 函数。

Answer 1

这不是我得到的行为。相反，我得到了一个以 /* (non-Javadoc) 开头的 block 注释。这是因为 toString() 是一个继承函数，这是自动文档快捷方式在我的设置中调用的行为。你的设置显然不同。

您可以通过转到窗口 -> 设置，然后导航到Java -> 代码样式 -> 代码模板，为各种上下文设置您喜欢的任何模板。您可以在模板中使用的变量的文档可以在 here 中找到。 。我的设置中覆盖方法的注释模板是:

/* (non-Javadoc)
 * ${see_to_overridden}
 */