JSON to XML 변환기

JSON-to-XML 변환이란 무엇이며 어떻게 작동하나요?

// Convert JSON to XML in Node.js using fast-xml-parser
import { XMLBuilder } from 'fast-xml-parser';

const data = {
  catalog: {
    product: {
      '@_id': 'P01',
      '@_category': 'electronics',
      name: 'Wireless Headphones',
      price: {
        '@_currency': 'USD',
        '#text': '79.99'
      }
    }
  }
};

const builder = new XMLBuilder({
  attributeNamePrefix: '@_',   // @_ keys become XML attributes
  textNodeName: '#text',       // #text key becomes element text content
  ignoreAttributes: false,     // process @_ attribute keys
  format: true,                // pretty-print with indentation
  indentBy: '  ',              // 2-space indent
});

const xml = builder.build(data);
console.log(xml);
// <catalog>
//   <product id="P01" category="electronics">
//     <name>Wireless Headphones</name>
//     <price currency="USD">79.99</price>
//   </product>
// </catalog>

주요 기능

예시

{"user":{"id":42,"name":"Alice Kim","email":"alice@example.com","role":"admin","address":{"city":"Seoul","country":"KR"}}}

[{"id":1,"name":"Widget A","price":9.99},{"id":2,"name":"Widget B","price":14.99},{"id":3,"name":"Widget C","price":4.49}]

{"catalog":{"product":{"@_id":"P01","@_category":"electronics","name":"Wireless Headphones","price":{"@_currency":"USD","#text":"79.99"}}}}

사용 방법

1. 1

   JSON 붙여넣기

   위 입력 필드에 JSON 데이터를 입력하거나 붙여넣으세요. '예시 불러오기'를 클릭하여 샘플을 사용해 볼 수도 있습니다 — API 응답 객체, 배열 페이로드, @_ 속성과 #text를 사용하는 객체.

2. 2

   실시간 XML 출력 확인

   XML이 즉시 출력 패널에 표시됩니다. 단일 키 객체는 해당 키를 루트로 사용하고, 다중 키 객체는 로 감싸지며, @_ 접두사가 붙은 키는 속성이 되고, 배열은 반복 자식 요소가 됩니다. 필요에 따라 들여쓰기(2칸 또는 4칸)를 조정하세요.

3. 3

   복사 또는 다운로드

   복사를 클릭하여 XML을 클립보드에 저장하거나 다운로드를 클릭하여 .xml 파일로 저장하세요. 결과를 유효성 검사하거나 재포맷하려면 XML 포맷터에 붙여넣으세요.

일반적인 변환 함정

// Input: { "status": 200, "data": { "id": 1 } }
// Output: <root><status>200</status><data><id>1</id></data></root>
// Root is <root> — may not match your schema

// Wrap in a named key to control the root element
// Input: { "response": { "status": 200, "data": { "id": 1 } } }
// Output: <response><status>200</status><data><id>1</id></data></response>

// Input: [{ "id": 1 }, { "id": 2 }]
// Output: <root><item><id>1</id></item><item><id>2</id></item></root>
// Tag names are generic

// Wrap in a named key for meaningful tag names
// Input: { "products": [{ "id": 1 }, { "id": 2 }] }
// Output: <root><products><id>1</id></products><products><id>2</id></products></root>
// Each array element reuses the key name "products" as its tag

// Input: { "tag": { "id": "42", "name": "Alice" } }
// Output: <tag><id>42</id><name>Alice</name></tag>  ← id is a child element

// Use @_ prefix for attributes
// Input: { "tag": { "@_id": "42", "name": "Alice" } }
// Output: <tag id="42"><name>Alice</name></tag>  ← id is an attribute

// Input: { "price": { "@_currency": "USD", "value": "29.99" } }
// Output: <price currency="USD"><value>29.99</value></price>
// Text is a child element, not text content

// Use #text for element text content
// Input: { "price": { "@_currency": "USD", "#text": "29.99" } }
// Output: <price currency="USD">29.99</price>  ← text content

// JSON key starts with digit — invalid XML element name
// Input: { "1stItem": "value" }
// Output: <1stItem>value</1stItem>  ← invalid XML

// Use a valid XML element name
// Input: { "firstItem": "value" }
// Output: <firstItem>value</firstItem>  ← valid XML

// JSON: { "query": "name = 'Alice' & role = 'admin'" }
// Converter outputs: <query>name = 'Alice' &amp; role = 'admin'</query>
// If double-processed: &amp;amp; — consumer is re-escaping

// Converter output is correct — consume it as XML, not as a raw string
// <query>name = 'Alice' &amp; role = 'admin'</query>
// XML parser decodes to: name = 'Alice' & role = 'admin'

주요 사용 사례

SOAP 및 레거시 XML 웹 서비스 호출

애플리케이션에서 JSON 페이로드를 빌드하고 XML로 변환한 다음 SOAP 엔드포인트에 POST하세요. 이렇게 하면 XML 문자열을 수동으로 작성하지 않아도 되며 레거시 서비스에 직렬화가 필요한 순간까지 네이티브 JSON 구조로 데이터를 처리할 수 있습니다.

XML 설정 파일 생성

Spring, Maven, Ant, Tomcat, Android는 모두 XML 설정 형식을 사용합니다. 설정 데이터를 JSON으로 생성하거나 변환하여 — diff와 버전 관리가 더 쉬움 — 배포를 위해 XML로 변환하세요.

사이트맵 및 RSS 피드 XML 생성

콘텐츠 관리 시스템과 정적 사이트 생성기는 종종 페이지 메타데이터를 JSON으로 저장합니다. 해당 메타데이터를 sitemap.xml 또는 RSS 피드 XML로 변환하여 검색 엔진에 제출하거나 피드 리더에 콘텐츠를 신디케이션하세요.

기업 데이터 통합 (EDI / ERP / CRM)

ERP 시스템(SAP, Oracle), CRM 플랫폼, EDI 네트워크는 일반적으로 XML로 데이터를 교환합니다. 현대 REST API에서 JSON 내보내기를 XML로 변환하여 사용자 정의 XML 직렬화기 없이 이러한 시스템에 공급하세요.

Android 리소스 파일

Android 문자열 리소스, 레이아웃 제약, 매니페스트 항목은 모두 XML입니다. JSON 데이터 소스에서 리소스 파일을 프로그래밍 방식으로 생성하거나 업데이트하고 Android 빌드 시스템에 필요한 XML 형식으로 변환하세요.

SVG 및 벡터 그래픽 생성

SVG는 XML입니다. JSON 데이터로 SVG 구조를 빌드하고 — 경로, 도형, 색상, 변환 — XML로 변환하여 웹, 인쇄, 벡터 편집 도구에 사용할 유효한 SVG 파일을 생성하세요.

기술 세부 정보

RFC 8259 호환 JSON 파싱

JSON 입력은 브라우저의 네이티브 JSON.parse()를 사용하여 파싱되며 RFC 8259를 완전히 준수합니다. 최선의 위치 정보(줄 및 열 번호)를 포함한 정확한 구문 오류 메시지를 제공하며 모든 JSON 데이터 타입(문자열, 숫자, 불리언, null, 배열, 객체)을 처리합니다.

사용자 정의 재귀 JSON-to-XML 직렬화기

파싱 후 사용자 정의 재귀 직렬화기가 JSON 트리를 탐색합니다. @_로 시작하는 객체 키는 부모 요소의 XML 속성으로 출력됩니다. #text 키는 요소의 텍스트 내용으로 출력됩니다. 일반 객체 키는 자식 요소가 됩니다. 배열 값은 반복되는 같은 이름의 형제 요소를 생성합니다. 텍스트 내용과 속성 값의 특수 문자(<, >, &, ", ')는 XML 엔티티 참조로 이스케이프됩니다.

루트 정규화

XML은 정확히 하나의 루트 요소를 요구하므로 직렬화기는 문서 빌드 전에 루트 정규화를 적용합니다: 단일 키 객체는 해당 키를 루트로 사용하고, 다중 키 객체와 최상위 배열은 합성 감싸기를 받습니다. 이로써 입력 형태에 관계없이 출력이 항상 올바른 형식의 XML이 됩니다.

100% 브라우저 기반 — 업로드 없음, 서버 없음

모든 처리가 브라우저의 JavaScript 엔진에서 실행됩니다. 어떤 시점에서도 네트워크를 통해 데이터가 전송되지 않습니다. 200KB보다 큰 입력은 자동으로 실시간 모드에서 수동 모드(명시적인 변환 클릭 필요)로 전환되어 무거운 직렬화 중에 브라우저 응답성을 유지합니다.

모범 사례

단일 키 객체로 루트 요소 제어

의미 있는 XML을 생성하는 가장 깔끔한 방법은 최상위 JSON이 원하는 루트 요소 이름이 키인 단일 키 객체인지 확인하는 것입니다. 다중 키 데이터를 하나의 명명된 키 아래에 감싸면 일반적인 감싸기 대신 의미론적으로 의미 있는 루트가 생성됩니다.

속성이 많은 XML에는 @_와 #text 사용

대상 XML 스키마가 많은 속성을 사용한다면(설정 파일, SVG, SOAP 엔벨로프에서 일반적), 변환 전에 @_ 접두사가 붙은 키와 #text를 사용하도록 JSON을 재구성하세요. 결과 XML이 후처리 없이 대상 스키마와 정확히 일치하게 됩니다.

의미 있는 태그 이름을 위해 배열을 명명된 객체로 감싸기

최상위 배열은 이 고정 리터럴 이름인 일반적인 ... 패턴을 생성합니다. 배열을 명명된 키 아래에 감싸면 — { "products": [...] } — 반복되는 요소(키 이름이 모든 배열 요소에 재사용됨)가 감싸기 아래에 생성됩니다. 이로써 도메인에 의미 있는 태그 이름이 생성되며 스키마로 파싱되거나 유효성 검사될 XML에는 거의 항상 더 나은 선택입니다.

XML 포맷터로 출력 유효성 검사

변환 후 XML 출력을 XML 포맷터에 붙여넣어 형식 일치성을 유효성 검사하고, 들여쓰기를 확인하고, 다운스트림 서비스에 XML을 전송하거나 버전 관리에 커밋하기 전에 구조적 문제를 식별하세요.

변환 전 JSON 키 정리

XML 요소 이름은 문자 또는 밑줄로 시작해야 하며 공백이나 대부분의 특수 문자를 포함할 수 없습니다. JSON 키가 외부 소스(데이터베이스 열 이름, API 필드 이름, 사용자 입력)에서 온 경우 잘못된 형식의 출력을 방지하기 위해 변환 전에 XML 이름 유효성을 감사하세요.

자주 묻는 질문