ProtoJSON 객체 재사용: merge와 전체 교체를 다른 시연으로 보기
파서의 merge 계약과 화면의 전체 교체 의도를 먼저 구별해야 한다. 새 입력에 없는 필드가 이전 출력 객체에서 남는 경우에는 객체 수명과 초기화 경로를 확인해야 한다.
이전 입력이 남는 이유
파서의 merge 계약과 화면의 전체 교체 의도를 먼저 구별해야 한다. 새 입력에 없는 필드가 이전 출력 객체에서 남는 경우에는 객체 수명과 초기화 경로를 확인해야 한다. Truthound로 확인할 값도 화면에 보이는 문자열 하나보다 필드 presence를 먼저 포함해야 한다. 교체 화면에서 남은 이전 note는 새 사용자가 제공한 값처럼 보일 수 있다. [1, 2, 3]
동작 변경이 아닌 문서 요청
Protobuf #30822는 JsonStringToMessage가 출력 message에 merge하는 기존 동작을 API 문서에 명확히 하자는 요청이다. 후속 댓글은 문서 PR로 이어졌으며 덮어쓰기 의미로 바뀐 수정이라고 설명하지 않는다. 모호한 이름을 분명히 하자는 요청에서 API의 기존 merge 의미를 덮어쓰기 결함으로 바꿔 설명하지 않는다. 문서 PR 언급과 실제 문서 배포도 구별한다. [1]
객체 수명을 대조군으로 만들기
새 객체와 재사용 객체에 같은 두 번째 JSON을 읽는 대조 시험을 만들고, 전체 교체 화면에서는 누락 필드가 이전 사용자 값으로 남지 않는 경로를 선택한다. 같은 parser 옵션과 같은 입력을 사용하고 객체 생성·초기화 여부만 바꾼다. 출력 presence와 기본값 표시를 분리해 빈 화면이 필드 삭제 증거가 되는 오해를 피한다. [1, 3]
빨간색만 보낸 두 번째 호출
설명용 첫 입력은 color=blue와 note=old, 두 번째 입력은 color=red만 제공한다. 화면 계약이 전체 교체라면 두 번째 결과에서 note의 기대 존재 여부는 0이다. note 존재 플래그 0이면 전체 교체 조건을 충족한다. old가 남아 1이면 merge를 교체로 잘못 사용한 결과여서 실패다. 반대로 patch 의도라면 기존 note가 남는 것이 정당하므로 기대값을 달리 정해야 한다. [1, 3]
실제 presence를 준비한 검사
Truthound Core Python SDK 3.3.2의 ColumnPairValidator로 replacement_old_field_present와 old_optional_field_present를 relationship="=="로 비교한다. 두 값은 운영자가 추출한 비결측 0 또는 1이며, parser 호출 성공만으로 추정하지 않는다. SDK는 Protobuf의 객체를 초기화하거나 merge 동작을 바꾸지 않는다. [1, 2, 3]
전체 교체와 patch의 선택
전체 교체라면 새 message 객체나 명시적 초기화 후 parse를 시험한다. patch는 merge를 유지하되 생략·명시적 NULL·기본값의 의미를 API 판본에 맞춰 정한다. 없는 JSON 필드가 언제나 삭제 요청이라고 일반화하지 않고, 화면의 저장 완료 표시는 선택한 의도의 검사를 통과한 뒤 내린다. [1, 3]
적용 조건
실제 API 판본의 merge 계약과 애플리케이션의 교체·패치 의도를 구분하고 presence를 추출한다.
대안
전체 교체라면 새 message 객체 또는 명시적 초기화 후 parse를 시험하고 패치라면 merge를 유지한다.
한계
Truthound는 Protobuf parser의 동작을 바꾸지 않으며 JSON에 없는 필드가 항상 삭제 의도라고 판단하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
