XML 이 내 오후를 거의 망칠 뻔한 첫 번째 시간은 지불 게이트웨이의 SOAP 응답이었습니다. 한 줄. 11 천 자. 개행 문자가없고 들여 쓰기가 없으며 내 터미널이 읽을 수없는 벽돌로 감싼 앵글 브래킷의 깨지지 않은 벽. 어딘가에 서명 불일치를 일으키는 단일 잘못된 요소가 있었고 눈으로 그것을 찾기로되어있었습니다. 나는 그 이후로 많은 것을 구축했습니다 - WordPress 플러그인,Laravel APIs, [Toolz.dev] 뒤에있는 React 툴링 (/ - 그리고 좋은 XML 포맷터는 마감 기한이있는 태그 벽을 응시하는 순간까지 감사하지 않는 조용한 유틸리티 중 하나라고 말할 수 있습니다.
이 가이드는 내가 그날 오후에 가지고 있었으면 좋겠다. 그것은 XML 포맷터가 실제로 무엇을하는지,왜 아름답게하고 축소하는 것이 동전의 양면인지,포맷을 안전하게 만드는 공백 규칙,거의 모든 "why won't this parse" moment.free 와 함께 브라우저에서 따라갈 수 있습니다 XML 포맷터 - 전적으로 컴퓨터에서 실행되므로 결제 페이로드도 노트북에서 절대 떨어지지 않습니다.
TL;DR: XML 포맷터는 문서를 다시 작성's 하찮은 공백 - 공간 사이 태그 - 의미를 건드리지 않고. Beautify 는 계층 구조를 읽을 수 있도록 줄 바꿈과 들여쓰기를 추가합니다; minify 는 파일이 가능한 한 작도록 모든 것을 제거합니다. 좋은 포맷터는 주석,CDATA, XML 선언 및 속성 순서를 보존하고,그 과정에서 잘 구성된 (태그 일치,닫힌 요소,종료된 섹션) 유효성을 검사합니다 아닙니다 문서를 DTD 또는 XSD 스키마와 비교하여 확인하십시오. 이는 다른 작업입니다.
XML 포맷터는 실제로 무엇을합니까?
공백은 포맷이 흥미로워지는 곳입니다 XML 1.0 파서가 요소 내부의 모든 문자를 애플리케이션에 전달해야 합니다. 이것이 바로 포맷터가 터치하는 것이 안전한 것이 무엇인지 알아야 하는 이유입니다. XML 포맷터는 핵심에서 문서를 요소,텍스트, 주석,CDATA 섹션,처리 지침 등 노드 트리로 구문 분석한 다음 일관된 간격으로 해당 트리를 다시 직렬화합니다. 그 왕복은 전체 트릭입니다. 도구는 블라인드 찾기 및 교체를 수행하기보다는 구조를 이해하기 때문에 깊이 중첩된 항목을 들여쓰기할 수 있습니다 <order><items><item> 올바르게 연결하고 각 형제자매를 자신의 줄에 배치하고 그 안에 텍스트가 있음을 알아두십시오 <price>44.95</price> 세 개로 확장하기보다는 태그와 동일한 라인을 유지해야 합니다.
이것이 중요한 이유는 XML 사양에 묻혀있는 규칙으로 귀결됩니다: 요소 사이의 공백의 대부분은 중요하지 않은. 파서가 읽을 때 <a>\n <b/>\n</a>, 주변의 개행과 공간 <b/> 인간을 위해 존재하며 데이터를 가지고 다니지 않습니다. 포맷터는 그 공백을 자유롭게 추가,제거 또는 변경할 수 있습니다. 절대 만져서는 안 되는 것은 중요한 공백 - 텍스트 노드 내부의 문자는 다음과 같습니다 <note>Call me at 9am</note>또는 CDATA 블록 안에 있는 모든 것 - 해당 콘텐츠는 실제 데이터이기 때문입니다. 모든 형식 결정은 다음과 같습니다 XML 포맷터 해당 라인을 존중함으로써 흐름을 만듭니다.
그래서 아름답게하는 것은 화장용 보풀이 아닙니다. 그 11 천 자 SOAP 벽돌을 다시 들여 쓰면 요소 계층 구조가 보이고 갑자기 잘못 배치되었습니다 <Amount> 노드 세 레벨이 너무 깊다는 것은 명백합니다. 포맷은 가독성 도구만큼이나 디버깅 도구입니다.
왜 XML을 아름답게 하는 대신 축소하겠습니까?
Beautify 와 minify 는 반대 방향으로 가리키는 동일한 엔진입니다. Beautify 는 인간을 위해 공백을 추가합니다; minify 는 기계를 위해 그것을 제거합니다. 크기 또는 수송이 중요할 때 minify 를 위해 도달합니다: 이동할 수 있는 app 뭉치 안쪽에 발송하는 윤곽 파일을 긴축하거나,느린 연결을 넘어서기 전에 요구 몸을 트리밍하거나,문서를 정상화해서 들여쓰기 소음이 방해가 되지 않고 2 개의 버전이 바이트를 위해 바이트 비교될 수 있도록.
절약은 진짜 그러나 드물게 극적입니다. XML's 장황은 그것의 공백이 아니라 그것의 반복한 꼬리표 이름에서 삽니다,그래서 축소하는 것은 전형적으로 원본이 얼마나 무겁게 들여쓰기되었는지에 따라서 5 개에서 이십 퍼센트 사이 어딘가에 손질하는 가치가 있습니다,그러나 당신이 심각한 압축을 필요로 하는 경우에,철사에 gzip 는 멀리 더 많은 것을 합니다 - 축소하고 그 후에 gzipping 는 많은 APIs 사용 벨트 그리고 버팀대 접근입니다.
제가 도구를 가리킬 방법을 결정할 때 사용하는 정신 모델은 다음과 같습니다:
| 상황 | 아름답게 하다 | 축소하다 |
|---|---|---|
| 눈으로 응답을 읽거나 디버깅합니다 | 예 | 아니요 |
| 구성 파일을 버전 제어에 커밋합니다 | 예(깨끗한 차이) | 아니요 |
| 앱 번들 내부 또는 네트워크를 통해 XML을 배송합니다 | 아니요 | 예 |
| 데이터베이스 열에 많은 작은 문서를 저장합니다 | 아니요 | 예 |
| 바이트별 차이에 대한 문서를 준비합니다 | 어느 쪽이든, 일관되게 | 어느 쪽이든, 일관되게 |
| XML을 다른 개발자에게 건네주는 것 | 예 | 아니요 |
핵심 규율은 일관성입니다. 두 문서를 diff하는 경우 실행하십시오 둘 다 먼저 동일한 옵션을 사용하여 동일한 모드를 통해 - 그렇지 않으면 콘텐츠가 아닌 들여쓰기 스타일을 비교하는 것입니다.
포맷을 하면 데이터가 변경되지 않는 방법은 무엇입니까?
이것은 모든 포맷터가 과거의 길을 벌어야하는 불안입니다: & quot;이 도구가 내 XML을 다시 작성하면 조용히 무언가를 깨지 않았다는 것을 어떻게 알 수 있습니까?& quot; 정직한 대답은 잘 구축 된 포맷터는 태그 사이의 공백 만 변경하고 엄격하게 혼자 네 가지를 남겨 둡니다.
첫 번째는 텍스트 내용니다.요소 안의 문자는 그대로 복사됩니다.그것에는 entities - a literal 이 포함됩니다 & 스테이 &, 결코 유용하게 디코딩되지 않습니다 & (잘못된 XML을 생성함) 또는 이중 인코딩됩니다 &amp;. 그만큼 XML 포맷터 텍스트를 불투명하게 처리하며, 이는 정확히 원하는 것입니다.
두번째는 CDATA 섹션. ᅡ <![CDATA[ ... ]]> 블록은 정확하게 존재하므로 JavaScript의 일부, HTML 덩어리, 문자열 등 이스케이프되지 않은 원시 콘텐츠를 삭제할 수 있습니다 < 그리고 & - 빠져나가지 않고 XML 문서로. 포맷터는 그 내용을 찾은 그대로 내보내며,탈출하지 않고,블록 내부에 다시 들여쓰기를 하지 않습니다.
세 번째는 의견과 선언. 댓글 (<!-- ... -->), 그만큼 <?xml version="1.0"?> 선언,그리고 모든 처리 명령은 보존되고 현명하게 배치됩니다. 더 간결한 파일을 원할 때 주석을 제거하도록 선택할 수 있지만,그것은 도구가 뒤에서하는 것이 아니라 귀하의 결정입니다.
네 번째는 속성 순서 및 인용. 기본적으로 포맷터는 여러분이 작성한 순서대로,사용한 따옴표 스타일로 속성을 유지합니다. 왜냐하면 XML 사양은 속성 순서를 중요하지 않은 것으로 취급하고 휘젓을 이유가 없기 때문입니다. 여러분이 하다 더 깨끗한 차이를 위해 또는 동일한 속성을 다른 순서로 전달하는 두 요소를 비교하기 위해 표준 순서를 원합니다. "sort attributes" 옵션을 사용하면 알파벳 순서로 정렬됩니다.
이 모든 것이 자바스크립트에서 클라이언트측을 실행하기 때문에,개인정보 배당도 있습니다: 연결 문자열,내부 식별자,또는 고객 기록으로 가득 찬 문서는 자신의 머신에서 포맷되고 결코 업로드되지 않습니다. 만약 당신이 작업 데이터를 다른 사람들로부터 보호하는 것에 관심이 있다면's 서버 - 그리고 당신은 그래야 합니다 - 그 모델은 이해할 가치가 있으며,나는 그것에 대해 더 많이 썼습니다 온라인 도구에 대한 데이터 개인 정보 보호 가이드.
포맷터가 포착하는 XML 오류는 무엇입니까?
포맷터가 무엇이든 예쁜 인쇄를 하기 전에 문서를 구문 분석해야 하며,구문 분석은 유용한 유효성 검사가 이루어지는 곳입니다. This is 잘 형성됨 확인 - 모든 XML 문서가 준수해야 하는 구조적 규칙 - 내 경험상 세 가지 실수가 실패의 압도적인 대부분을 차지합니다.
지금까지 가장 일반적인 것은 a입니다 베어 앰퍼샌드. XML이 예약됩니다 & 엔터티를 시작하려면 원시입니다 & 텍스트에서 - 다음과 같은 URL을 통해 몰래 들어오는 종류입니다 ?a=1&b=2 또는 "Marks & amp; Spencer"와 같은 회사 이름 - 파서가 엔터티 이름을 기대하게 한 다음 찾을 수 없을 때 초크합니다. 수정 사항은 작성하는 것입니다 &그리고 좋은 오류 메시지는 당신이 맹인을 사냥하지 않도록 라인을 가리킬 것입니다.
두 번째는 a 일치하지 않거나 닫히지 않은 태그. 오픈 a <div> 그리고 그것을 닫으십시오 </section>또는 a를 엽니다 <span> 그리고 절대 아예 닫지 않고,문서는 더 이상 잘 형성되지 않습니다. 포맷터는 구문 분석할 때 open-element 스택을 추적하므로,정확히 어떤 태그가 닫혀 있을 것으로 예상하고 어떤 태그를 실제로 찾았는지 알려줄 수 있습니다. 그 단일 메시지 - "expected </book> 하지만 발견 </author> 14 행에서" - 일반적으로 몇 초 안에 문제를 해결하기에 충분합니다.
세 번째는 an입니다 종료되지 않은 섹션: 로 댓글이 열렸습니다 <!-- 그것은 결코 도달하지 못합니다 -->또는 도달하지 못하는 CDATA 블록입니다 ]]>. 이것들은 손수 편집할 때 쉽게 만들고 조금 너무 많이 삭제합니다. 다시 포맷터는 폭주 섹션이 시작된 줄을보고합니다.
포맷터가 하는 일 아닙니다 do is check your document against a schema. Well-formedness askes "이 구조적으로 유효한 XML 인가요?" 유효성은 "의 규칙을 따르는 XML 을 묻습니다 내 특별한 문서 유형 - 올바른 요소,올바른 순서,올바른 데이터 유형과 함께 - DTD 또는 XSD?" 에 의해 정의 된대로; 그것들은 별도의 레이어입니다. 문서는 완벽하게 잘 형성 될 수 있으며 의도 된 목적에 대해서는 여전히 말도 안됩니다. 스키마 유효성 검사는 스키마를 필요로하며,그것은 다른 도구입니다. 포맷터는 파서 충돌을 중지시키는 첫 번째 레이어를 보장합니다.
편집기에서 XML을 포맷하거나 파이프라인을 빌드하려면 어떻게 해야 합니까?
브라우저 도구는 일회성 문서의 가장 빠른 경로이지만 작업에 적합한 것을 선택할 수 있도록 대안을 아는 것이 좋습니다.
대부분의 편집기는 기본적으로 XML 을 포맷합니다. VS Code 에서 내장 된 "Format Document" 명령 (Shift+Alt+F) 은 XML 을 처리하고 Red Hat's XML 언어 서버와 같은 확장 프로그램은 스키마 인식 형식을 맨 위에 추가합니다. IntelliJ 와 그 형제는 Ctrl+Alt+L 로 다시 포맷합니다. 이는 파일이 이미 앞에 열려있을 때 이상적입니다.
명령줄에서, xmllint --format file.xml (대부분의 Unix 시스템에서 제공되는 libxml2의 일부)를 아름답게 합니다 xmllint --noblanks file.xml 축소된 출력에 가까워집니다. Node 프로젝트에서 라이브러리는 다음과 같습니다 xml-formatter 또는 prettier XML 플러그인 슬롯을 빌드 단계로. Python 개발자가 도달합니다 xml.dom.minidom.parseString(s).toprettyxml(), 기존 공백 주위에 빈 줄을 추가하는 것으로 악명이 높습니다.
그렇다면 왜 사용합니까 XML 포맷터 전혀? 내가 다시 오는 세 가지 이유. 그것은 더 설치,구성, 아니 프로젝트가 필요 없습니다 - 당신은 붙여 넣기 및 이동합니다. 그것은 XML 이 장난감 예제가 아닌 실제 페이로드 때 중요 기계에 데이터를 유지합니다. 그리고 그것은 자연스럽게 이웃 도구와 쌍: XML 이 깨끗하고 유효하면,와 JSON 로 변환 XML 에서 JSON 변환기 한 번의 클릭으로 역방향으로 이동합니다 JSON에서 XML로 같은 규칙을 사용합니다. 하루가 대부분 JSON 인 경우,the JSON 포맷터 해당 형식과 동일하며 전체 가족이 목록에 포함되어 있습니다 웹 개발자 툴킷.
XML을 언제 포맷하고 변환해야 합니까?
내가 이것에 더 새로운 사람들로부터 얻는 질문: JSON 이 읽기 쉽다면 왜 단지 변환하는 대신 XML 을 포맷합니까? 대답은 포맷하고 변환하면 다른 문제를 해결한다는 것입니다.
필요할 때 포맷하십시오 유지하다 XML - SOAP 엔드포인트가 요구하기 때문에, RSS 또는 Atom 피드가 정의상 XML이기 때문에, 구성 파일, Android 레이아웃 또는 Maven 때문에 pom.xml 단순히 XML 이고 항상 그럴 것입니다. 포맷하면 XML 로 남겨두면서 XML 을 읽을 수 있거나 컴팩트하게 만들 수 있습니다. 다운스트림은 변경될 필요가 없습니다.
변환하고 싶을 때 다른 형식으로 데이터를 작업합니다 - 값을 JavaScript 프런트 엔드로 가져오거나,JSON 을 말하는 시스템에 피드를 로드하거나,여러 소스를 하나의 모양으로 정규화합니다. 변환은 형식을 변경하며,그것으로 충실도 중 일부를 변경합니다: XML 속성,혼합 콘텐츠 및 요소 순서는 깨끗한 JSON 등가물을 갖지 않으므로 변환기는 의도적 인 선택 (속성은 접두사 키가되고,반복 된 태그는 배열이 됨) 을 수행하므로 의존하기 전에 이해해야합니다.
내 경험 법칙: 항상 먼저 포맷하십시오. 깨끗하고 검증 된 문서는 다음 단계가 편집,다리기 또는 변환인지 추론하기가 더 쉽습니다. 포맷은 저렴하고 안전하며 무손실 작업입니다; 변환은 구조가 건전하다는 것을 알게되면 손실되는 것입니다. 사이트 맵은 변환하는 것보다 포맷하는 XML 의 좋은 예입니다 - 하나를 구축하는 경우 전용 사이트맵 생성기 유효하고 잘 구성된 출력을 직접 생성합니다.
자주 묻는 질문
온라인에서 XML을 포맷하려면 어떻게 해야 합니까?
XML을 입력 패널에 붙여넣고 Beautify를 선택하고 들여쓰기 너비를 선택하고 서식을 클릭합니다. 이 도구는 문서를 구문 분석하고 다시 들여쓰기를 하고 결과를 복사하거나 다운로드할 수 있습니다. 모든 처리가 브라우저에서 발생합니다. 아무것도 업로드되지 않습니다.
XML을 아름답게 하는 것과 축소하는 것의 차이점은 무엇입니까?
Beautifying 은 줄 바꿈과 들여쓰기를 추가하므로 요소 계층 구조를 쉽게 읽을 수 있으며 이는 편집 및 디버깅에 이상적입니다. Minifying 은 태그 사이의 모든 공백을 제거하여 가능한 가장 작은 파일을 생성하며 이는 저장 또는 네트워크를 통해 전송하는 데 이상적입니다. 둘 다 document's 의미를 보존합니다; 중요하지 않은 공백만 변경됩니다.
서식을 사용하면 내 XML의 의미가 변경됩니까?
...이 아닌 . 태그 사이의 공백만 변경됩니다. 요소, 속성, 텍스트 콘텐츠, 주석 및 cdata는 변경되지 않습니다. 텍스트 노드와 cData 내의 공백이 유지되기 때문에, 형식이 잘 지정된 문서는 서식 지정 전후에 동일하게 작동합니다.
주석과 CDATA 섹션이 보존됩니까?
예. 주석,CDATA 섹션,XML 선언 및 처리 명령은 모두 유지됩니다. 주석은 함께 있는 요소와 함께 들여쓰기되며 CDATA 콘텐츠는 이스케이프 없이 그대로 방출됩니다. 더 간결한 출력을 원하는 경우 주석을 제거하도록 선택할 수도 있습니다.
이 도구가 내 XML을 검증할 수 있습니까?
네. 서식을 지정하기 전에 문서가 완전히 구문 분석되고 닫히지 않은 요소, 시작 태그와 일치하지 않는 닫는 태그 또는 종료되지 않은 주석 또는 CData 섹션과 같은 구조적 문제가 줄 번호로 보고되어 신속하게 수정할 수 있습니다. DTD 또는 XSD 스키마에 대한 유효성이 아닌 잘 형성된 것을 확인합니다.
내 XML이 포맷하지 못하는 이유는 무엇입니까?
거의 모든 실패는 잘 형성된 오류입니다. 가장 일반적인 것은 텍스트의 맨 앰퍼샌드 (엔티티로 작성해야 하거나 파서가 엔티티의 시작으로 읽음), 닫는 요소와 일치하지 않는 닫는 태그,열리지만 결코 닫히지 않는 요소,오류 메시지가 바로 그 줄로 이동할 수 있도록 가리킵니다.
민감한 데이터가 포함된 XML을 포맷하는 것이 안전합니까?
네. 파서는 브라우저에서 자바스크립트에서 완전히 실행됩니다. 네트워크 요청이 데이터를 전달하지 않으며, 기록하거나 저장하는 것도 없으며, 오프라인에서 도구가 로드되면 오프라인으로 작동합니다. XML을 보유하고 있는 API 키, 연결 문자열 또는 고객 레코드는 컴퓨터를 떠나지 않습니다.
포맷된 XML을 나중에 JSON으로 변환할 수 있나요?
네. XML이 깨끗하고 유효하면 XML-to JSON 변환기는 해당 JSON을 사용하여 프리픽스 키에 속성을 매핑하고 배열에 반복 태그를 매핑합니다. 먼저 포맷하면 구조가 명확해지므로 변환하기 전에 매핑하는 방법을 이해하는 데 도움이 됩니다.
작성자 Liton - Toolz.dev, WP Adminify 및 Laravel 및 React 프로젝트의 긴 목록 작성자 여기에 언급 된 모든 도구는 [Toolz.dev](/에서 브라우저에서 무료로 완전히 실행됩니다.
