不明白@ConstructorProperties

Question

关于@ConstructorProperties

Documentation 表示“构造函数上的注释，显示该构造函数的参数如何对应于构造对象的 getter 方法”。它给出了一个模棱两可的例子，因为变量名称与参数相同。

我真的不明白为什么@ConstructorProperties({"x", "y"}) 指的是吸气剂getX() 和getY()。 x和y的大小写与注解不一致。

所以要澄清这段代码中构造函数的注释应该是什么：

public class Point {
    public Point(int a, int b) {
       this.c = a;
       this.d = b;
   }

   public int getCc() {
       return c;
   }

   public int getDd() {
       return d;
   }

   private final int c, d;

}

（我编辑了代码，因为从答案中，我理解注释希望代码遵循 getter 的常见大小写约定，例如 cc getter 必须是 getCc()。但为了消除歧义，我故意保留差异在 getter 名称和返回的实际变量之间）

第二个问题……

@ConstructorProperties(value="text")

这个注解对于JButton(String text)意味着什么？

好像是供工具使用的，只是想了解一下。

Answer 1

@ConstructorProperties被一些序列化框架用来将构造函数参数与相应的字段及其getter和setter方法相关联。

为此，它依赖于为字段命名 getter 和 setter 方法时使用的相同命名约定：getter 和 setter 方法名称通常通过将字段名称大写并在前缀 get 或 @987654325 前添加@（或 is 用于布尔吸气剂）。不过，单字母字段名称的示例并不是最好的说明。

一个更好的例子：someValue 变成 getSomeValue 和 setSomeValue

所以在构造函数属性的上下文中，@ConstructorProperties({"someValue"}) 表示第一个参数与 getter getSomeValue 和 setter setSomeValue 相关联。

请记住，方法参数名称在运行时是不可见的*。重要的是参数的顺序。构造函数参数的名称或构造函数实际设置的字段无关紧要。以下仍将引用名为 getSomeValue() 的方法。

@ConstructorProperties({"someValue"})
public Point(int a) {
    this.c = a;
}

---

什么时候需要这个注解？

JavaBeans 通常有一个公共的默认构造函数（没有参数）和所有字段的公共 getter 和 setter 方法。这意味着它们很容易在没有任何注释的情况下序列化，而且它们始终是可变的。

@ConstructorProperties 的用例似乎是不遵循 JavaBeans 约定的对象的反序列化，例如没有任何设置器的不可变 POJO：

对于序列化，框架使用对象 getter 获取所有值，并使用这些值序列化对象。当需要反序列化对象时，框架必须创建一个新实例。因为对象是不可变的，所以它没有任何设置器，尽管可以用来设置它的值。构造函数是设置这些值的唯一方法。注解用于告诉框架如何调用构造函数来正确初始化对象。

---

* 正如 cmets 中所指出的，JEP 118 随 Java 8 一起发布，可用于在运行时包含参数名称。此可选功能可能会使 @ConstructorProperties 等注释过时，但前提是框架支持该功能。