[JAVA] Jackson의 Data Binding API와 Tree Model API 차이점

Jackson은 JSON 데이터를 Java 객체로 변환하는데 사용되는 강력한 라이브러리로, 두 가지 주요 방식인 Data Binding API와 Tree Model API를 제공합니다. 이 두 API는 JSON 데이터를 처리하는 데 서로 다른 접근 방식을 취하며, 데이터 처리 목적이나 성능 요구 사항에 따라 적합한 API를 선택할 수 있습니다.

Data Binding API와 Tree Model API 비교

Data Binding API

Data Binding API는 ObjectMapper를 사용해 JSON 데이터를 Java 객체로 직접 매핑하여 처리하는 방식입니다. @JsonProperty 같은 어노테이션을 활용하면, JSON과 Java 객체 간 필드 매핑을 커스터마이징할 수 있어 코드의 가독성을 높이고, 타입 안정성을 제공합니다.

장점

• 간단하고 직관적으로 JSON을 객체에 매핑할 수 있습니다.
• JSON 필드와 Java 객체 간 자동 매핑이 가능해 코드 작성이 용이합니다.
• 타입 안정성을 보장하며, 직렬화와 역직렬화에 최적화되어 있습니다.

단점

• JSON 구조가 복잡하거나 동적으로 변경되는 경우 유연성이 떨어질 수 있습니다.
• 필드가 많고 구조가 자주 변경되는 경우 유지 보수가 어려울 수 있습니다.

Data Binding을 통한 JSON 데이터 매핑 :

import com.fasterxml.jackson.databind.ObjectMapper;

public class DataBindingExample {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();

        // JSON 문자열을 Java 객체로 변환
        String json = "{\"name\": \"홍길동\", \"age\": 28, \"city\": \"서울\"}";
        Person person = mapper.readValue(json, Person.class);

        System.out.println("이름: " + person.getName());
        System.out.println("나이: " + person.getAge());
        System.out.println("도시: " + person.getCity());
    }
}

class Person {
    private String name;
    private int age;
    private String city;

    // Getters and Setters
    // ...
}

위의 예제에서 Data Binding API를 사용하여 JSON 문자열을 Person 객체로 변환하고 있습니다. JSON 데이터가 정해진 구조를 가질 경우 적합하며, 데이터 필드 간 타입 안정성을 제공합니다.

Tree Model API

Tree Model API는 JsonNode를 통해 JSON 데이터를 트리 구조로 표현하여 동적으로 데이터를 다루는 방식입니다. 트리 구조의 각 노드가 JSON 필드를 나타내며, 필드 추가, 삭제, 수정이 자유롭습니다. JSON 데이터가 정해진 구조를 따르지 않거나 동적으로 생성되는 경우에 적합합니다.

장점

• 유연한 구조로 JSON 데이터의 필드를 동적으로 조작할 수 있습니다.
• JSON의 특정 필드만 선택적으로 읽거나 수정하는 데 유리합니다.
• JSON 구조가 복잡한 경우 객체 매핑을 필요로 하지 않아 JSON 데이터를 빠르게 처리할 수 있습니다.

단점

• JSON 데이터를 다루는 과정에서 타입 안정성이 부족할 수 있습니다.
• Java 객체로 매핑하는 방식에 비해 코드 가독성이 낮아질 수 있습니다.

Tree Model을 통한 JSON 데이터 처리 :

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.node.ObjectNode;

public class TreeModelExample {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();

        // JSON 데이터를 JsonNode로 변환
        String json = "{\"name\": \"김철수\", \"age\": 30, \"city\": \"부산\"}";
        JsonNode rootNode = mapper.readTree(json);

        // 필드 접근 및 값 읽기
        String name = rootNode.get("name").asText();
        int age = rootNode.get("age").asInt();

        System.out.println("이름: " + name);
        System.out.println("나이: " + age);

        // 필드 동적 추가
        ((ObjectNode) rootNode).put("country", "대한민국");

        // 최종 JSON 출력
        System.out.println("Updated JSON: " + rootNode.toString());
    }
}

Tree Model API는 JSON 데이터를 객체로 변환하지 않고도 트리 노드를 통해 직접 데이터를 다룰 수 있어 유연성이 높습니다.

상황별 API 선택 기준

1. 데이터 구조가 정해진 경우

데이터 구조가 사전에 정의되고 변동이 거의 없으며, Java 객체에 직접 매핑하여 데이터를 다루는 경우에는 Data Binding API를 사용하는 것이 좋습니다. 데이터의 안정성과 객체지향적인 코드 작성이 중요할 때 효과적입니다.

2. JSON 데이터가 동적이고 구조가 자주 바뀌는 경우

JSON 데이터가 동적 구조를 가지거나 특정 필드를 추가/삭제하는 작업이 필요한 경우 Tree Model API를 사용하는 것이 유리합니다. Tree Model API는 JSON의 트리 구조를 통해 데이터를 자유롭게 수정할 수 있어 유연성이 높습니다.

3. 특정 필드만 선택적으로 다뤄야 하는 경우

Tree Model API는 특정 필드만 읽거나 수정하는 데 적합합니다. 예를 들어 JSON의 모든 필드가 필요하지 않고, 일부 필드만 수정하거나 필드 값을 읽어야 하는 경우 Tree Model API를 사용하면 성능 효율이 높습니다.

효율적인 JSON 데이터 처리 전략

• 정적인 데이터 구조: Java 클래스와 Data Binding API를 활용하여 JSON 데이터를 안정적으로 처리할 수 있습니다. 객체를 통해 데이터에 접근할 수 있으므로, JSON 데이터의 일관성과 타입 안전성을 확보할 수 있습니다.
• 유동적인 데이터 구조: JSON 데이터가 자주 변경되는 경우 Tree Model API를 사용하여 노드별로 데이터를 다루고 필요한 필드만 선택적으로 수정합니다. 특히 대규모 JSON 데이터를 다룰 때 성능을 고려하여 특정 필드만 빠르게 처리할 수 있습니다.
• 혼합 사용: 상황에 따라 두 API를 함께 사용하는 것도 가능합니다. 일부 고정된 JSON 필드는 Data Binding API를 사용하고, 나머지 필드는 Tree Model API를 통해 다루어 효율성과 유연성을 모두 확보할 수 있습니다.

참고 사이트

• Jackson 공식 가이드: https://github.com/FasterXML/jackson
• Data Binding 및 Tree Model 문서: https://github.com/FasterXML/jackson-databind