java - Java docstringes 通过类中的私有变量

Question

public static class cls{
    private String text;
    public String getText(){
        return text;
    }
}

是否可以在 Java 的文档字符串中显示text变量cls而无需复制粘贴内容？

Answer 1

我不确定您要做什么。您可以使用以下两种方式中的一种链接到 JavaDoc 中的变量：

/**
 * The cls class
 * see {@link cls#text} or
 * @see cls#text
 */
public static class cls {
    private String text;
...

然后，您可以将 JavaDoc 附加到该变量并在那里描述您需要说的内容。据我所知，除了复制和粘贴之外，没有办法只在 JavaDoc 中显示一行代码。但是，如果您愿意，可以使用 HTML 改进格式：

/**
 * The cls class, see this field:
 * <code>private String text;</code>
 */
public static class cls {
    private String text;
...

希望有帮助，但问题仍然存在：如果有公共吸气剂，为什么要公开实现？