java - 注释 : methods vs variables

Question

我一直确信(不知道为什么)最好为变量添加注释，但是在浏览 Hibernate 文档时 http://docs.jboss.org/hibernate/stable/annotations/reference/en/html_single/#entity-hibspec-collection我注意到他们倾向于注释方法。所以我应该把注释放在方法之前，像这样:

@Entity
public class Flight implements Serializable {
private long id;

@Id @GeneratedValue
public long getId() { return id; }

public void setId(long id) { this.id = id; }
}  

还是这样比较好:

@Entity
public class Flight implements Serializable {
@Id @GeneratedValue
private long id;

public long getId() { return id; }

public void setId(long id) { this.id = id; }
}  

或者也许没有区别？

Answer 1

正如 Péter 指出的那样，您需要选择一种样式并坚持使用它，因为为 @Id 注释采用的样式将用于所有内容。

除此之外，这只是一个品味问题。两种选择都有效，所以选择你喜欢的那个。有些人更喜欢 Hibernate 通过方法注入(inject)，这样他们就可以在需要时巧妙地更改实现。我更喜欢通过字段注入(inject)，因为我发现必须通过 getter/setter 方法(7 行 vs 1 行)公开所有属性很麻烦，而在 99.9% 的情况下它们将作为简单变量工作(并且在任何情况下如果/当我需要编写自定义 setter 功能时，我可以切换注释样式。

两者之间没有性能或功能差异，因此请选择您喜欢的(或者更重要的是，您的团队/工具更喜欢)。