WHAGO

직렬화 업그레이드 검토

SerdeProof

Java 개발팀이 실제 DTO·매퍼 설정·페이로드 코퍼스를 두 직렬화 빌드에서 실행해 입력 수용, JSON 차이와 생산자·소비자 조합을 비교합니다.

v0.1.1 다운로드 (새 탭에서 열림)

사용 대상과 범위

Java 직렬화 라이브러리 업그레이드를 검토하는 개발팀

통과는 해당 코퍼스에서 예상 밖 차이가 없었다는 뜻입니다. 업무 의미의 동등성을 증명하지 않습니다. 어댑터는 사용자 권한의 신뢰된 로컬 코드로 실행됩니다. 양쪽 버전에서 모두 거절한 입력은 미검증입니다. CI에서 미검증도 실패로 처리하려면 --fail-on-untested를 사용합니다.

지원 범위와 사용 안내 ↗

현재 제공

버전
v0.1.1 · 2026.10.12
대상
Java 직렬화 라이브러리 업그레이드를 검토하는 개발팀
실행
JDK 17+ · 로컬 JVM · CI
데이터
로컬 코퍼스 · JSON/JUnit 보고서
제공
Java 17 라이브러리 · CLI

사용 흐름

  1. 01

    같은 DTO와 매퍼를 기준·후보 의존성 버전으로 각각 빌드하고 매니페스트에 경로를 지정합니다.

  2. 02

    분리된 JVM에서 코퍼스와 네 가지 생산자·소비자 조합을 실행합니다.

  3. 03

    JSON·JUnit 결과를 검토하고 승인할 변경의 이유와 만료일을 명시해 CI 기준으로 사용합니다.

빌드 없는 릴리스 실습

JDK 17 이상에서 serdeproof-0.1.1.zip과 SHA256SUMS를 받고 확인한 뒤 전체 압축을 풉니다. 추출한 serdeproof-0.1.1 폴더에서 아래 명령을 실행하세요. 예제의 차이 발견은 종료 코드 1, 불완전한 실험은 2입니다. Maven 설치나 계정은 필요하지 않으며 lib/의 모든 JAR을 함께 유지해야 합니다. 자체 DTO 통합은 사용 안내를 따르세요. Maven Central에는 게시되지 않았습니다.

java -jar lib/serdeproof-cli-0.1.1.jar run --manifest examples/release-demo.json --json reports/first.json --junit reports/first.xml --as-of 2026-10-08

직접 확인하기

공개 ZIP의 예제는 17개 fixture에서 예상 밖 차이 12개, 미검증 5개, 기반 실행 오류 0개를 출력하고 의도적으로 종료 코드 1을 반환합니다. 이 수치는 합성 예제 결과이며 실제 서비스의 호환성 판정은 자체 코퍼스로 해야 합니다.

빌드 없는 Jackson 실습 ↗(새 탭에서 열림)

링크