JSON에서 XML로

예시: 반복 요소

입력:

{ "users": [ { "name": "Alice" }, { "name": "Bob" } ] }

출력:

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <users>
    <name>Alice</name>
  </users>
  <users>
    <name>Bob</name>
  </users>
</root>

예시: 배열 랩퍼

“배열을 <item>으로 감싸기” 전략을 적용한 동일한 입력:

<root>
  <users>
    <item>
      <name>Alice</name>
    </item>
    <item>
      <name>Bob</name>
    </item>
  </users>
</root>

타입 매핑

속성 대 요소

XML은 속성(<user id="1">)과 자식 요소(<user><id>1</id></user>)를 구분합니다. 변환기는 기본적으로 자식 요소를 사용하며, 이는 왕복 변환에서도 손실이 없습니다. 후속 XML에서 속성이 필요한 경우 키 접두사 규칙을 사용하세요.

• JSON 키 @id는 부모 요소에서 XML 속성 id="..."로 변환됩니다.
• JSON 키 #text는 부모 요소의 텍스트 내용이 됩니다.

이러한 규약들은 가장 일반적으로 사용되는 두 JSON-to-XML 표준인 BadgerFish 및 Parker 매핑에서 유래합니다.

이스케이프 규칙

• < -> <
• > -> >
• & -> &
• " -> " (속성 값에서)
• ' -> ' (선택적)
• UTF-8 형식의 바이트는 XML 프로로그에서 선언된 대로 그대로 유지됩니다.

흔한 오류들

• 루트 수준의 JSON 배열. XML은 단일 루트 요소만 필요합니다. 변환기는 배열을 <root>(또는 사용자가 지정한 이름)로 감쌉니다.
• 숫자형 키. JSON {"1": "a"}는 유효하지만, XML 요소 이름은 숫자로 시작할 수 없습니다. 변환기는 숫자 앞에 밑줄을 붙여 _1과 같은 형태로 만들거나, 사용자가 직접 정의한 매핑을 사용할 수 있게 합니다.
• 혼합 배열: [1, "two", { "x": true }]에는 명확한 매핑이 존재하지 않습니다. 일반적으로 이는 JSON을 변환하기 전에 정규화가 필요함을 의미합니다.
• 대형 문서: XML은 설명이 상당히 방대한 특성을 지니며, 10MB 크기의 JSON 파일도 최대 20~30MB에 달할 수 있습니다. 특히 매우 큰 데이터 양의 경우 스트리밍 변환을 고려해야 합니다.