초보자도 쉽게 따라 할 수 있는 XML을 JSON으로 변환하는 방법

배고픈코알라·2025년 2월 14일

XML을 JSON으로 변환하는 것은 웹 개발과 데이터 교환에서 흔한 작업입니다. XML과 JSON은 비슷한 목적을 가지고 있지만, 구조가 다르기 때문에 다양한 시스템과 애플리케이션과의 호환성을 위해 변환이 필요할 수 있습니다.

이 가이드에서는 Apidog 같은 도구와 프로그래밍 언어를 사용하여 XML을 JSON으로 변환하는 단계별 과정을 살펴보겠습니다.

Apidog은 XML 및 JSON 형식을 지원하는 강력한 API 문서 도구로, 개발자에게 편리한 문서 관리 솔루션을 제공합니다. 유연한 기능은 문서 작성, 공유 및 API 상호 작용을 단순화하여 데이터 구조 변환이 빈번한 IT 종사자에게 적합합니다. 초보자든 경험이 많은 개발자든 간에 Apidog은 작업 효율성을 향상시키고 프로젝트의 고품질 배포를 보장합니다.

apidog

XML과 JSON이란 무엇인가?

XML(Extensible Markup Language)은 자체 설명 구조를 가진 데이터를 정의하는 데 사용되는 마크업 언어입니다. XML은 사람이 읽을 수 있는 태그를 사용하여 데이터를 조직하고 전송합니다. 구성 파일, 전자 데이터 교환(EDI) 등 다양한 상황에서 널리 사용됩니다.

JSON(JavaScript Object Notation)은 경량 데이터 교환 형식입니다. 인간이 읽고 쓰기 쉽고, 기계가 구문 분석하고 생성하기에도 쉽습니다. JSON은 키-값 쌍으로 데이터를 조직하며, 서버와 웹 애플리케이션 간의 데이터 전송에 흔히 사용됩니다.

두 가지의 주요 차이점은 다음과 같습니다:

XML은 주로 파일 전송에 사용되는 데이터 전송 및 저장에 초점을 맞추고 있습니다. JSON은 데이터 교환을 강조하며, 네트워크 전송에 널리 사용됩니다.
XML은 순수 텍스트 형식으로, 인간과 기계 모두 구문 분석할 수 있습니다. JSON 또한 순수 텍스트 형식이지만 더 가볍고 간결합니다.
XML은 엄격한 계층 구조를 가지고 있는 반면, JSON의 구조는 상대적으로 더 유연합니다.
XML은 기본적으로 여러 데이터 유형을 지원하지만, JSON은 숫자, 문자열, 부울과 같은 기본 유형만 지원합니다.

XML 데이터 구조 이해하기

변환 과정을 시작하기 전에, XML의 기본 구조에 대한 이해가 필요합니다. XML은 데이터를 저장하고 운반하기 위해 설계된 마크업 언어로, 트리 구조로 데이터를 나타냅니다. 요소, 속성 및 텍스트 콘텐츠가 기본 빌딩 블록입니다.

요소: 요소는 XML 문서의 기본 빌딩 블록이며, <element>와 같은 각도 괄호로 둘러싸인 태그로 표시됩니다. 요소는 다른 요소, 속성 및 텍스트 콘텐츠를 포함할 수 있습니다.
속성: 속성은 요소에 대한 추가 정보를 제공합니다. 요소의 시작 태그 내에 정의되며, 이름과 값 쌍으로 나누어져 있습니다. 예를 들어, <element attribute="value">와 같이 사용됩니다.
텍스트 콘텐츠: 텍스트 콘텐츠는 요소 내에 저장된 실제 데이터로, 요소의 열기 및 닫기 태그 사이의 콘텐츠입니다. 예를 들어 <element>이것은 텍스트 콘텐츠 입니다</element>와 같다.
루트 요소: 모든 XML 문서는 하나의 루트 요소를 가져야 하며, 다른 모든 요소를 포함합니다.
계층 구조: XML 문서들은 요소가 다른 요소 안에 중첩되어 트리 구조를 형성하며, 복잡한 데이터 관계를 나타낼 수 있습니다.
태그: XML은 요소를 정의하기 위해 여는 태그와 닫는 태그를 사용합니다. 여는 태그는 <element>이고, 닫는 태그는 </element>입니다. 요소는 올바르게 중첩되고 닫혀야 합니다.

다음은 책 카탈로그를 나타내는 XML 문서의 예입니다:

<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <book id="1">
    <title>앵무새 죽이기</title>
    <author>하퍼 리</author>
    <year>1960</year>
  </book>
  <book id="2">
    <title>오만과 편견</title>
    <author>제인 오스틴</author>
    <year>1813</year>
  </book>
</catalog>

이 예에서 루트 요소는 <catalog>이며, 두 개의 <book> 요소를 포함하고 있습니다. 각 <book> 요소는 고유한 id 속성을 가지고 있으며, <title>, <author>, <year>와 같은 자식 요소를 포함하고 있습니다.

XML의 계층 구조와 복잡한 데이터 관계를 나타내는 능력은 데이터 교환, 구성 파일 및 문서 마크업과 같은 다양한 애플리케이션에 적합합니다.

Python에서 XML을 JSON으로 변환하는 방법

이번에는 Python 내장 모듈을 사용하여 XML을 JSON으로 변환하는 방법을 단계별로 보여드리겠습니다.

1.필요한 모듈 가져오기

먼저, 필요한 모듈을 가져와야 합니다. 이 작업을 위해 xml.etree.ElementTree 모듈을 사용하여 XML 데이터를 구문 분석하고 json 모듈을 사용하여 구문 분석된 데이터를 JSON으로 변환할 것입니다.

import xml.etree.ElementTree as ET
import json

2. XML 데이터 구문 분석하기

그 다음, ElementTree 모듈을 사용하여 XML 데이터를 구문 분석해야 합니다. 파일에서 XML 데이터를 읽거나 문자열로 제공할 수 있습니다.

파일로부터:

tree = ET.parse('path/to/your/file.xml')
root = tree.getroot()

문자열로부터:

xml_string = """
<root>
    <child1>값 1</child1>
    <child2>값 2</child2>
</root>
"""
root = ET.fromstring(xml_string)

3. 구문 분석된 XML을 Python 사전으로 변환하기

ElementTree 모듈을 사용하여 구문 분석된 XML 데이터를 Python 사전으로 변환할 수 있는 편리한 방법을 제공합니다.

xml_dict = {root.tag: {child.tag: child.text for child in root}}

이 코드는 루트 태그를 키로 하고, 자식 태그를 키로 하며 해당하는 텍스트 값을 갖는 사전으로 구성된 또 다른 사전이 값으로 포함된 사전을 생성합니다.

4. 사전을 JSON으로 변환하기

마지막으로, json.dumps() 함수를 사용하여 사전을 JSON 문자열로 변환할 수 있습니다.

json_data = json.dumps(xml_dict)
print(json_data)

이렇게 하면 JSON 데이터가 출력됩니다:

{"root": {"child1": "값 1", "child2": "값 2"}}

전체 코드는 다음과 같습니다:

import xml.etree.ElementTree as ET
import json

# XML 데이터 구문 분석
xml_string = """
<root>
    <child1>값 1</child1>
    <child2>값 2</child2>
</root>
"""
root = ET.fromstring(xml_string)

# 구문 분석된 XML을 Python 사전으로 변환
xml_dict = {root.tag: {child.tag: child.text for child in root}}

# 사전을 JSON으로 변환
json_data = json.dumps(xml_dict)
print(json_data)