ObjectMapper

📖 ObjectMapper?

ObjectMapper는 일반적으로 메모리 내 개체와 데이터베이스, XML, JSON 문서에 저장된 데이터간에 서로 다른 형식 또는 표현 간 데이터를 변환하기 위해 사용됩니다. ObjectMapper는 서로 다른방식으로 표현된 데이터를 변환하는 프로세스입니다. 사용중인 애플리케이션에 편리한 형식으로 데이터를 조작하고 교환할 수 있습니다.

🤔 사용해야 하는 이유는?

개채 매핑 기능을 제공하는 라이브러리는 언어별로 많습니다. Java에서는 Jackson이 대표적으로 개체 매핑 기능을 제공하는 라이브러리입니다. 데이터를 개체로 또는 개체에서 변환하기 위한 간단하고 직관적인 API를 제공하여 개발자가 응용 프로그램에서 데이터 작업을 더 쉽게 수행할 수 있도록 합니다.

😮 사용되는 사례

서로 다른 형식의 데이터를 교환하는 것에는 대부분 사용이 됩니다. 매핑 기능 뿐만이 아니라 데이터를 조작 할 수도 있어 유용합니다.

👨‍💻 구현

라이브러리

// https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind
implementation group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.14.2'

Dto

@JsonNaming(PropertyNamingStrategies.SnakeCaseStrategy.class)
class Car {
    private String name;
    private String carNumber;
    @JsonProperty("TYPE")
    private String type;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getcarNumber() {
        return carNumber;
    }

    public void setcarNumber(String carNumber) {
        this.carNumber = carNumber;
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    @Override
    public String toString() {
        return "Car{" +
                "name='" + name + '\'' +
                ", carNumber='" + carNumber + '\'' +
                ", type='" + type + '\'' +
                '}';
    }
}


public class User {
    private String name;
    private int age;
    private List<Car> cars;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    public List<Car> getCars() {
        return cars;
    }

    public void setCars(List<Car> cars) {
        this.cars = cars;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", cars=" + cars +
                '}';
    }
}

Main

public class Main {
    public static void main(String[] args) throws JsonProcessingException {
        ObjectMapper objectMapper = new ObjectMapper();

        User user = new User();
        user.setName("Chan");
        user.setAge(27);


        Car car1 = new Car();
        car1.setName("K3");
        car1.setcarNumber("11나 1111");
        car1.setType("sedan");

        Car car2 = new Car();
        car2.setName("Q5");
        car2.setcarNumber("22나 2222");
        car2.setType("SUV");

        List<Car> carList = Arrays.asList(car1, car2);
        user.setCars(carList);

        String json = objectMapper.writeValueAsString(user);
        System.out.println(json);
        System.out.println("-------------");
        
        JsonNode jsonNode = objectMapper.readTree(json);
        String _name = jsonNode.get("name").asText();
        int _age = jsonNode.get("age").asInt();

        System.out.println("name : " + _name);
        System.out.println("age : " + _age);

        JsonNode cars = jsonNode.get("cars");
        ArrayNode arrayNode = (ArrayNode) cars;

        List<Car> _cars = objectMapper.convertValue(arrayNode, new TypeReference<List<Car>>() {
        });
        System.out.println(_cars);

        System.out.println("-------------");
        ObjectNode objectNode = (ObjectNode) jsonNode;
        objectNode.put("name", "KIM");

        System.out.println(objectNode.toPrettyString());
    }
}

첫번째 출력은 ObjectMapper의 writeValueAsString메서드를 활용하여 json형태로 출력하였습니다.

두번째 출력은 JsonNode를 활용하여 기존에 만든 json를 JsonNode 형태로 만들어 각각의 key값으로 value를 출력하였습니다.

세번째 출력은 기존에 만든 jsonNode를 ObjectNode로 매핑하여 값을 변경하고 출력하였습니다.

✅ 요약

• ObjectMapper는 서로 다른 데이터를 알맞게 변환해주어 관리할 수 있게 한다.
• 매핑뿐만 아니라 데이터 수정도 가능하다.