Java ProtoJSON extension: short name 대신 승인한 qualified key 확인하기
extension의 완전한 정체성과 짧은 표시 이름을 구별해야 한다. 소비자가 해석할 qualified JSON key를 승인한 뒤 출력한다.
짧은 이름보다 완전한 정체성
extension의 완전한 정체성과 짧은 표시 이름을 구별해야 한다. 소비자가 해석할 qualified JSON key를 승인한 뒤 출력한다. Truthound 표를 만들기 전에 raw JSON key와 중복 여부를 남겨야 한다. 일반 map으로 파싱해 마지막 key만 남긴 뒤에는 원래 충돌을 되찾지 못할 수 있다. [1, 2, 3]
옵션과 기본값의 다른 범위
Protobuf #27499는 Java JSON serializer의 extension short name 출력과 35.0의 opt-in printingFullyQualifiedExtensionNames를 설명한다. 기본값 변경은 breaking change이며 자동 활성화된 수정으로 말하지 않는다. 기본 출력을 바로 바꾸는 것이 호환성 변경이라는 점도 보고의 일부다. 옵션이 생겼다는 사실을 모든 설치에 자동 활성화됐다는 설명으로 바꾸지 않는다. [1]
raw key를 먼저 보존하기
같은 short name을 가진 두 extension으로 raw JSON 키와 소비자 parse를 대조하고, 정체성이 사라진 출력을 전달하지 않는다. extension registry와 serializer 판본을 고정하고 같은 short name 두 개를 대조군으로 사용한다. raw key를 보존한 뒤 실제 consumer parse도 별도로 시험한다. [1, 3]
[foo.bar]의 승인 기준
설명용 extension은 foo.bar이고 승인 ProtoJSON key는 [foo.bar]다. bar는 일반 필드나 다른 extension과 충돌할 수 있어 실패다. 일반 dict parse 전에 raw key를 보존한다. [foo.bar]는 이 표현 조건을 충족하고 bar는 실패다. 단일 key 성공만으로 전체 메시지나 duplicate key 부재가 검증되지는 않는다. [1, 3]
extension별 표의 검사
Truthound Core Python SDK 3.3.2의 ColumnPairValidator로 required_extension_key와 serialized_extension_key를 relationship="=="로 비교한다. 운영자가 raw JSON에서 extension별 비결측 key 표를 준비해야 한다. SDK는 serializer 기본 옵션이나 registry를 바꾸지 않으며 전체 JSON parser를 대신하지 않는다. [1, 2, 3]
key 전환의 소비자 비용
지원 판본에서 printingFullyQualifiedExtensionNames()를 명시하고 소비자와 교차 parse를 시험한다. extension이 없는 메시지는 같은 충돌 경로가 아니다. 옵션 전환은 key에 의존하는 소비자의 migration과 함께 계획하고 default가 조용히 바뀐 것으로 기대하지 않는다. [1, 3]
적용 조건
extension registry와 serializer 버전을 확인하고 raw JSON의 중복 키를 일반 map 변환 전에 검사한다.
대안
지원 판본에서 printingFullyQualifiedExtensionNames()를 명시하고 실제 소비자와 교차 parse를 시험한다.
한계
Truthound는 Java serializer 기본 옵션이나 extension registry를 고치지 않는다. key 한 개가 맞아도 전체 JSON parse 성공을 보증하지 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
