对于内部/嵌套类构造函数，什么是适当的“@link”或“@see”javadoc标记？

Question

我在让“@link”和“@see”标记为内部/嵌套类的构造函数工作时遇到问题，希望这里的人能提供帮助。这个简短的示例类在第25行给出了javadoc警告，其中引用了“Layer（）”文档前面几行中的“@link”和（等效的）“@see”标记。

package bogus;
import javax.swing.JPanel;
public class LayeredPlot extends JPanel {
  /**
   * Constructor for the plot.
   */
  public LayeredPlot() {
  }
  public static class Layer {
    private String name;
    /**
     * Construct a default layer with a default name. This method calls
     * {@link LayeredPlot.Layer#Layer(String)} OR calls == JAVADOC WARNING
     * {@link #Layer(String)} OR calls                  == JAVADOC WARNING
     * {@link Layer#Layer(String)}                      == JAVADOC WARNING
     * with a null name to perform the construction.
     * The constructor for the layer can be found
     * {@link LayeredPlot#LayeredPlot() here}.          == JAVADOC Okay!
     *
     * @see LayeredPlot.Layer#Layer(String)             == JAVADOC WARNING
     * @see #Layer(String)                              == JAVADOC WARNING
     * @see Layer#Layer(String)                         == JAVADOC WARNING
     * @see LayeredPlot#LayeredPlot()                   == JAVADOC Okay!
     */
    public Layer() {    // Line 25: javadoc warnings reference this line
      this(null);
    }
    /**
     * Construct a layer with the specified name.
     *
     * @param name The desired name for the layer within the plot.
     */
    public Layer(String name) {
      this.name = name;
    }
  }
}

警告（3个表示“@see”，3个表示“@link”）都说：无法在伪造中找到层（字符串）。分层图。图层。

请注意：所有其他javadoc都按预期工作（包括内部类方法和我在本例中对LayeredPlot自身构造函数的引用）。

如果您对内部/嵌套类构造函数的正确javadoc标记有任何建议，我们将不胜感激<谢谢。

Answer 1

如果您对内部名称进行了范围界定，则需要在#标记的两侧对其进行完全的范围界定。例如：

@see LayeredPlot.Layer#LayeredPlot.Layer(String)

Answer 2

对于Java8或更早版本，没有合适的方法来实现这一点，因为bug JDK-80311625只在Java9中修复。

解决方法是对类和参数使用完全限定名：

{@link bogus.LayeredPlot.Layer#LayeredPlot.Layer(java.lang.String)}

但这不是一个语法上有效的成员名称，因此有几个工具会抱怨（doclint、checkstyle）。