[Java] ObjectMapper란? | 직렬화, 역직렬화 | Jackson 라이브러리 | Serialize, Deserialize | Json Parsing

ObjectMapper란?

: JSON 형식을 사용할 때, 응답들을 직렬화하고, 요청들을 역직렬화 할 때 사용하는 기술이다.

다른 서버들과 소통할때 보통 json을 사용한다. 그래서 알아둬야함!

직렬화(Serialize) : Object를 Text형태의 JSON으로도 변환해준다.

역직렬화(Deserialize) : text 형태의 JSON을 Object로 변환해준다.

SpringBoot의 경우, spring-boot-starter-web에 기본적으로 Jackson 라이브러리가 있어서 Object ↔ JSON 간 변환이 자동으로 처리된다.

• Jackson 라이브러리 : 자바에서 고수준의 JSON Parser라고 생각하면 된다
• @RestController에서는, Jackson 라이브러리가 있어서 request, response가 내부적으로 직렬화/ 역직렬화가 된다.

https://github.com/lion0913/community_TDD/commit/16700bee8973228a51cb8eba4e0bf88df884f1f0

1. Object → text 변환

   : 객체를 Json String으로 변환하는 기능

    public class Util {
        public static class json {
            public static String toJsonStr(Object obj, String defaultValue) {
                ObjectMapper om = new ObjectMapper();
                try {
                    return om.writeValueAsString(obj);
                } catch (JsonProcessingException e) {
                    return defaultValue;
                }
            }
        }
    }

   → 내부 클래스를 사용한 이유 ?

   Util에는 들어갈 기능들이 너무 많다. 그래서 폴더처럼 관리해야 하는게 좋다.

   Util.json.toJsonStr : 직관적인 함수명을 통해서 어떤 기능인지 알기 편하다.(json 관련 함수임을 유추 가능)

   예제)

    @Test
        void objectMapperTest() throws JsonProcessingException {
            ArticleDto articleDto = new ArticleDto(1, "제목", "내용");
   
            String jsonStr = Util.json.toJsonStr(articleDto, "");
            System.out.println(jsonStr);
            assertThat(jsonStr).isNotBlank();
            assertThat(jsonStr).isEqualTo("""
                    {"id":1,"title":"제목","body":"내용"}
                    """.trim());
        }

   

2. Json text → object 변환

    public static Object toObj(String jsonStr, Class cls, Object defaultVal) {
        try {
            return om.readValue(jsonStr, cls);
        } catch (JsonMappingException e) {
            return defaultVal;
        } catch (JsonProcessingException e) {
            return defaultVal;
        }
    }

   예제)

    @Test
        void objectMapperTest_jsonStrToObj() {
            //json string으로 만드는 과정
            ArticleDto articleDto = new ArticleDto(1, "제목", "내용");
            String jsonStr = Util.json.toJson(articleDto, "");
   
            ArticleDto articleDtoFromJson = (ArticleDto) Util.json.toObj(jsonStr, ArticleDto.class, null);
   
            assertThat(articleDto).isEqualTo(articleDtoFromJson);
   
        }

• 제네릭까지 적용

  는 제네릭을 사용한다는 의미

  T가 리턴값

  class의 의미 : T타입의 클래스만 파라미터로 받을 수 있다

  https://github.com/lion0913/community_TDD/commit/e098bf69da60a0392bed914d574a7cc18b6973db

    public static <T> T toObj(String jsonStr, Class<T> cls, T defaultVal) {
        try {
            return (T)om.readValue(jsonStr, cls);
        } catch (JsonMappingException e) {
            return defaultVal;
        } catch (JsonProcessingException e) {
            return defaultVal;
        }
    }
  
    //이렇게 하면 ArticleDto로 캐스팅해주지 않아도 된다
    ArticleDto articleDtoFromJson = Util.json.toObj(jsonStr, ArticleDto.class, null);