Java docstringes 通过类中的私有变量答案

【问题标题】：Java docstringes through private variable in classJava docstringes 通过类中的私有变量
【发布时间】：2010-07-02 13:04:01
【问题描述】：

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

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

【问题讨论】：

【解决方案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;
...

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

【讨论】：