사용자 도구

사이트 도구


java:jackson

차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

차이 보기로 링크

양쪽 이전 판 이전 판
다음 판
이전 판
java:jackson [2020/07/22 17:17]
kwon37xi [Config 설정]
java:jackson [2021/09/11 14:34] (현재)
kwon37xi [Java 16 Record]
줄 1: 줄 1:
 ====== Java Jackson JSON Library ====== ====== Java Jackson JSON Library ======
   * [[java:jackson:jsonfilter|Jackson JsonFilter]]   * [[java:jackson:jsonfilter|Jackson JsonFilter]]
 +  * [[java:jackson:squiggly|Squiggly]]
   * [[http://www.baeldung.com/jackson|Jackson Tutorial]]   * [[http://www.baeldung.com/jackson|Jackson Tutorial]]
   * [[http://www.baeldung.com/jackson-ignore-properties-on-serialization|Jackson Ignore Properties on Marshalling]]   * [[http://www.baeldung.com/jackson-ignore-properties-on-serialization|Jackson Ignore Properties on Marshalling]]
줄 19: 줄 20:
   * Spring 4.1 부터 ''@JsonView'', [[https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/http/converter/json/MappingJacksonValue.html|Spring MappingJacksonViewValue]] 지원   * Spring 4.1 부터 ''@JsonView'', [[https://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/http/converter/json/MappingJacksonValue.html|Spring MappingJacksonViewValue]] 지원
   * [[https://spring.io/blog/2014/12/02/latest-jackson-integration-improvements-in-spring|Latest Jackson integration improvements in Spring]]   * [[https://spring.io/blog/2014/12/02/latest-jackson-integration-improvements-in-spring|Latest Jackson integration improvements in Spring]]
 +  * [[https://www.baeldung.com/jackson-json-view-annotation|Jackson JSON Views | Baeldung]]
 ===== @JsonCreator ===== ===== @JsonCreator =====
   * 해당 클래스 JSON 문자열을 받아서 객체를 생성할 때 변환기를 직접 만들고자 할 때 구현한다.   * 해당 클래스 JSON 문자열을 받아서 객체를 생성할 때 변환기를 직접 만들고자 할 때 구현한다.
줄 87: 줄 88:
  
 ===== setDateFormat 주의 ===== ===== setDateFormat 주의 =====
-  Jackson 2 ''ObjectMapper.setDateFormat()'' 으로 ''SimpleDateFormat''을 할 수 있는데 이 경우 ''SimpleDateFormat''은 Thread Safe 지 못해서 Jackson 이 매번 clone을 해서 재생성해서 날짜를 포맷팅한다. +    * **''simpleDateFormat(), dateFormat()''을 하면 ''ObjectMapper''가 non-thread-safe 게 돼 버린다.*지말고, ''java.util.Date''도 사용하지 말 것.
-  성능 저하 요소가 될 수 있으므로 Java 8 이상에서는 가급적이면 ''LocalDateTime'' 등을 사용하는게 좋겠다.+
  
 ===== Hibernate ===== ===== Hibernate =====
줄 132: 줄 132:
  
  
 +===== @JsonInclude =====
 +  * [[https://www.baeldung.com/jackson-ignore-null-fields|Ignore Null Fields with Jackson | Baeldung]]
 +  * ''@JsonInclude(INclude.NON_NULL)'' : null인경우 아예 렌더링을 하지 않는다.
 +  * [[https://alwayspr.tistory.com/31|[Jackson] JsonInclude 속성에 대해 알아보자.]]
 ===== JsonNodeFactory ===== ===== JsonNodeFactory =====
   * [[https://fasterxml.github.io/jackson-databind/javadoc/2.1.0/com/fasterxml/jackson/databind/node/JsonNodeFactory.html|JsonNodeFactory]]   * [[https://fasterxml.github.io/jackson-databind/javadoc/2.1.0/com/fasterxml/jackson/databind/node/JsonNodeFactory.html|JsonNodeFactory]]
줄 170: 줄 174:
    .registerModule(new JavaTimeModule()); // new module, NOT JSR310Module    .registerModule(new JavaTimeModule()); // new module, NOT JSR310Module
  
-// with 3.0 (or with 2.10 as alternative) 
-ObjectMapper mapper = JsonMapper.builder() // or different mapper for other format 
-   .addModule(new ParameterNamesModule()) 
-   .addModule(new Jdk8Module()) 
-   .addModule(new JavaTimeModule()) 
-   // and possibly other configuration, modules, then: 
-   .build(); 
 </code> </code>
 +  * ''SerializationFeature.WRITE_DATES_AS_TIMESTAMPS: false'' 설정이 있어야만 ''LocalDateTime'' 등을 ''ISO_LOCAL_DATE_TIME'' format 등으로 직렬화한다.
 +
 +===== Jackson 2.10 부터 ObjectMapper 생성 방식 변경됨 =====
 +<code java>
 +JsonMapper objectMapper = JsonMapper.builder()
 +    .addModules(new ParameterNamesModule(), new Jdk8Module(), new JavaTimeModule())
 +    // 모르는 property 를 역직렬화 할 때 오류없이 무시하게 한다.
 +    .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
 +    // 모르는 ENUM 값을 역직렬화 할 때 null로 취급하게 한다.
 +    .configure(DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL, true)
 +    // 시간 관련 객체(LocalDateTime, java.util.Date)를 직렬화 할 때 timestamp 숫자값이 아닌 포맷팅 문자열로 한다.
 +    .configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false)
 +    // 숫자를 문자로 직렬화하기, BigDecimal 보호?
 +    .enable(JsonWriteFeature.WRITE_NUMBERS_AS_STRINGS)
 +    .defaultTimeZone(TimeZone.getDefault())
 +    .defaultLocale(Locale.getDefault())
 +    .build();
 +</code>
 +
 +===== Java 16 Record =====
 +  * [[https://carloschac.in/2021/03/04/jacksonrecords/|💾 Java Records 💿 with Jackson 2.12 | Carlos Chacin]]
 +  * Jackson >= 2.12.0 부터 [[java:16|Java 16]] 레코드 사용가능.
 ===== 참고 ===== ===== 참고 =====
   * [[http://www.baeldung.com/jackson-serialize-dates|Jackson Date]]<code java>   * [[http://www.baeldung.com/jackson-serialize-dates|Jackson Date]]<code java>
줄 194: 줄 213:
   * [[https://cheese10yun.github.io/jackson-annotation/|Jackson 어노테이션 사용법(1) - Yun Blog]]   * [[https://cheese10yun.github.io/jackson-annotation/|Jackson 어노테이션 사용법(1) - Yun Blog]]
   * [[https://dzone.com/articles/jackson-json-and-the-proper-handling-of-unknown-fi|Jackson, JSON and the Proper Handling of Unknown Fields in APIs - DZone Java]]   * [[https://dzone.com/articles/jackson-json-and-the-proper-handling-of-unknown-fi|Jackson, JSON and the Proper Handling of Unknown Fields in APIs - DZone Java]]
 +  * [[https://www.baeldung.com/jackson-ignore-null-fields|Ignore Null Fields with Jackson | Baeldung]]
java/jackson.1595405844.txt.gz · 마지막으로 수정됨: 2020/07/22 17:17 저자 kwon37xi