Java中构造方法参数前@Json(name="something")注解的含义

数据老陈

2026-7-11

Java构造方法参数上的@Json(name="something")注解是什么含义？

问题描述

我在分析一段Java代码时，遇到如下构造方法：

public Thing(@Json(name = "var1") String str, @Json(name = "var2") String str2) {
        this.instanceVar1 = str;
        this.instanceVar2 = str2;
}

我查阅资料后仍有疑问：Java中方法或构造方法参数前标注@Json(name="something")是什么意思？这让我联想到HTML/JavaScript中表单数据的name属性，请问上述代码意味着什么？是将str作为JSON数据发送到名为"var1"的服务端点，还是名为"var1"的端点向该构造方法传递str的值？

回答

这个@Json注解（通常是Jackson JSON库中@JsonProperty的简化/别名，或是部分框架的自定义注解）的核心作用是建立JSON字段和Java构造方法参数的映射关系，和HTML表单的name属性逻辑类似——都是用来做“外部数据标识”和“内部变量”的绑定，但它的场景是JSON与Java对象的序列化（Java对象转JSON）和反序列化（JSON转Java对象），和服务端点的直接交互无关，你的两种理解都不准确：

反序列化场景：当程序把一段JSON数据转换成Thing对象时，JSON里名为var1的字段值会被自动赋值给构造方法的str参数，最终存入instanceVar1；同理var2对应str2和instanceVar2。
举个例子，若传入如下JSON：
```
{
  "var1": "hello",
  "var2": "world"
}
```
框架会调用这个构造方法，把"hello"传给str，"world"传给str2，生成的Thing对象中instanceVar1为"hello"，instanceVar2为"world"。
序列化场景：当把Thing对象转换成JSON时，instanceVar1的值会被放在名为var1的JSON字段里，instanceVar2对应var2字段。