JSON 매핑 필드 대소문자 이슈

 

myBatis를 사용하거나 @ReqeustBody 어노테이션을 사용하면 수신되는 JSON 데이터를 찰떡같이 맵핑해준다.

하지만 필드명 시작이 대문자이면 주의해주어야한다.

원인은 Jackson은 Java Bean 네이밍 규칙으로 Java 클래스의 Json property를 맵핑하기 때문이다.

 

Java Bean 네이밍 규칙 핵심은 이렇다. (JavaBeans Spec https://www.oracle.com/java/technologies/javase/javabeans-spec.html)

1. 시작은 일반적으로 소문자이다.

2. 처음 두문자가 대문자이면 그대로 사용한다.

 

8.8 Capitalization of inferred names.
Thus when we extract a property or event name from the middle of an existing Java name, we normally convert the first character to lower case. However to support the occasional use of all upper-case names, we check if the first two characters of the name are both upper case and if so leave it alone. So for example, 

“FooBah” becomes “fooBah” 
“Z” becomes “z” 
“URL” becomes “URL” 

We provide a method Introspector.decapitalize which implements this conversion rule.
Here’s the source code for Introspector.decapitalize(). 

public static String decapitalize(String name) {
if (name == null || name.length() == 0) {
return name;
}
if (name.length() > 1 && Character.isUpperCase(name.charAt(1)) &&
Character.isUpperCase(name.charAt(0))){
return name;
}
char chars[] = name.toCharArray();
chars[0] = Character.toLowerCase(chars[0]);
return new String(chars);
}

The following table shows how the 1st two characters map. If this was a mathematical function, I’d say it wasn’t one-to-one. (‘aa’ and ‘Aa’ imply the same getter)

property 	getter 
aa	getaa()
aA	getaA()
Aa	getaa()
AA	getAA()

---

해결 방안은 @JsonSetter 어노테이션으로 property 이름을 명시해준다.

예시

Client에서 생성한 데이터	Server에서 수신한 데이터
{"Name": "GilDong"}	{"name": "GilDong"}

 

Client

public class Data {
    @JsonProperty
    private String Name;
}

 

Server

public @ResponseBody JsonNode getData (@RequestBody data) {
    ....
}

 

public class Data {
    private String Name;

    ....
    @JsonSetter("Name")
    public String getName() {
        return this.Name;
    }
}