01
루트는 항상 추가됩니다
키가 하나인 객체도 해당 키를 새 루트로 올리지 않습니다. 입력 전체를 지정한 루트로 감쌉니다. 배열 항목 이름은 모든 배열 깊이에서 사용되므로 수신 형식과 비교하세요.
JSON 도구
JSON XML 변환수신 시스템의 구조에 맞춰 변환
속성, 본문, 빈 배열, null이 포함된 예제로 실제 출력 규칙을 확인하세요.
JSON XML 변환
JSON XML 변환은 REST 응답을 XML 기반 시스템과 연결할 때 필요합니다. 단순히 괄호를 태그로 바꾸는 것만으로는 SOAP 메시지의 계약이나 업무 필드 요구 사항을 충족하지 못합니다.
이 도구는 선택한 루트 요소로 모든 입력을 감싸며, 배열과 특수 필드의 규칙을 드러냅니다. 수신 측과 구조를 합의한 다음 데이터를 보내는 작업에 적합합니다.
JSON XML 변환에서 구조를 확인하는 이유
빈 배열도 요소로 남기기
JSON XML 변환은 배열 이름을 컨테이너로 유지하고 각 항목을 item 요소로 만듭니다. 빈 배열은 빈 컨테이너로 남으며, 중첩 배열도 해당 계층을 유지합니다. 항목이 없다고 필드 전체를 지우지 않습니다.
속성과 텍스트를 구별하기
기본 규칙에서 @id는 속성이 되고 #text는 요소의 본문이 됩니다. 두 가지는 함께 사용할 수 있지만 본문과 자식 요소의 혼합은 거부합니다. 일반 객체로 임의의 혼합 콘텐츠 순서를 정할 수 없기 때문입니다.
설정할 때 놓치기 쉬운 사항
02
특수 키부터 확인하세요
속성 접두사는 @, 본문 키는 #text가 기본값이며 바꿀 수 있습니다. 매핑을 끄면 모든 키를 요소 이름으로 검사합니다. 남아 있는 특수 키가 잘못된 이름이면 오류로 알려 줍니다.
03
여러 설정은 수동으로 조정하세요
자동 변환은 변경 후 350밀리초를 기다립니다. 끄면 변환 버튼이나 Ctrl/Cmd+Enter를 사용합니다. 편집 즉시 내보내기가 비활성화되며 미리보기는 50개씩, 처음 500개 노드까지 표시됩니다.
확인 가능한 문서 생성
이름과 기본 네임스페이스
루트와 배열 항목 이름은 유효한 XML 1.0 로컬 이름이어야 합니다. 기본 네임스페이스 URI는 루트에서 선언하여 요소에 적용합니다. 접두사 없는 속성에는 적용되지 않습니다.
null을 명시적으로 표시
기본값은 xsi:nil="true"이며 xsi 선언을 자동으로 추가합니다. 거부 모드는 첫 null에서 멈춥니다. 빈 문자열, 빈 객체, 빈 배열은 존재하는 빈 요소로 유지합니다.
숫자와 제어 가능한 공백
9007199254740993, -0, 1e999 같은 숫자 토큰을 부동소수점으로 바꾸지 않습니다. 속성의 탭과 줄바꿈은 문자 참조로 기록하므로 XML 정규화 후에도 값이 유지됩니다.
출력 후 독립 검사
XML 1.0 구문과 네임스페이스를 파싱하고 요소 이름, 속성 값, 본문을 비교합니다. 들여쓰기는 2칸, 4칸, 없음 중에서 선택하고 UTF-8 선언도 켜거나 끌 수 있습니다.
지원 범위와 손실 가능성
- JSON 유형은 모두 복원되지 않습니다
- 숫자와 불리언은 유형 정보 없는 텍스트가 됩니다. 빈 배열, 빈 객체, 빈 문자열은 같은 빈 요소가 될 수 있습니다. 노드 보존은 모호하지 않은 역변환을 의미하지 않습니다.
- 잘못된 이름은 수정하지 않습니다
- 빈 키, 공백, 숫자로 시작하는 이름 등은 JSON Pointer와 함께 오류로 표시합니다. 밑줄 치환, 키 정렬, 주석 허용, 중복 키의 마지막 값만 유지하는 처리는 하지 않습니다.
- 속성과 본문은 스칼라만
- null이 아닌 문자열, 숫자, 불리언만 가능합니다. 객체나 배열, null은 거부합니다. 본문 키와 자식 요소는 본문이 빈 문자열이어도 함께 쓸 수 없습니다.
- 접두사와 업무 검증의 범위
- 기본 네임스페이스와 @xml:lang만 지원합니다. xml:space 등 다른 콜론 이름, xmlns 선언, xsi 덮어쓰기는 거부합니다. XML/XMLNS 예약 URI를 기본값으로 쓰거나 XSD·DTD·SOAP 계약을 검증하지 않습니다.
- 한 번에 처리하는 텍스트의 상한
- 입력 500,000자, 깊이 100, 노드 50,000개, 출력 2,000,000자까지 처리합니다. 금지된 XML 문자와 짝 없는 서로게이트는 오류입니다. URL 로드, 파일 가져오기, 일괄 압축, CDATA 생성은 없습니다.
JSON XML 변환 질문
JSON 배열은 XML로 어떻게 변환되나요?
배열 이름의 컨테이너 안에 설정한 항목 요소를 반복합니다. 빈 배열도 컨테이너는 남습니다. JSON → XML 변환기에서 배열 포장 방식이 수신 시스템과 맞는지 먼저 확인하세요.
REST API와 SOAP API를 연동할 때 활용할 수 있나요?
JSON을 XML로 변환하는 데이터 준비 단계에 사용할 수 있습니다. 그러나 SOAP Envelope나 업무 스키마를 자동 생성하지 않으므로 수신 API가 요구하는 구조와 별도로 비교해야 합니다.
양방향 변환이 모두 되나요?
이 페이지는 JSON에서 XML 방향만 처리합니다. 역방향은 별도 도구의 작업이며, XML 자체에 JSON 유형 정보가 없는 경우 원래 유형을 확정할 수 없습니다.
JSON의 어떤 키가 속성이 되나요?
기본 매핑에서 @로 시작하는 필드가 속성이 됩니다. @id는 id 속성이며, 일반 스칼라 필드를 자동으로 속성으로 추론하지 않습니다. 접두사를 바꾸었다면 입력의 특수 필드도 함께 확인하세요.
변환에 실패하는 주된 원인은 무엇인가요?
구문 오류, 중복 키, 잘못된 XML 이름, 금지 문자, 스칼라가 아닌 속성 값 등이 원인입니다. JSON XML 변환기 오류의 경로와 행·열을 보고 해당 부분을 고친 뒤 다시 실행하세요.
문서 매핑에서 예상과 다른 점이 있나요?