Vscode 自动填充获取和设置信息

Vscode autofilling for get and set information

当使用 vscode 时,它有助于我编写 get 和 set 方法并以这种格式自动填充它:

     /**
     * @param strength the strength to set
     */
     public void setStrength(int strength) {
        this.strength = strength;
    }

但是,如果我正在写这篇文章,我会这样做:

    /**
     * sets the strength variable
     */
    public void setStrength(int newStrength) {
        newStrength = strength;
    }

哪个更正确?还有第一条评论是什么意思?

我认为在 getter 和 setter 中没有参数名称约定。所以从技术上讲,它们都是正确的。虽然,即使我没有自动生成我的方法,我也一直使用您的第一个示例,您会发现大多数开源 Java 代码将使用您的第一个示例。

您的评论是 javadoc. Build tools like Maven and Gradle offer the ability of compiling API documentation。 IDE(如 VSCode)也将解析 javadoc 并动态提供给您。当您将鼠标悬停在方法/class 名称上时,您可以看到这一点。

我会熟悉 Java 文档,尤其是当其他人查看您的代码时。 There are quite a few Java tags.