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.
当使用 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.