Форматировщик XML
Отформатируйте XML с понятными отступами, сохранив элементы, атрибуты, текст, комментарии и экранированные значения.
Сделайте структуру XML читаемой
Компактный XML удобен для передачи, но труден для проверки. Элемент, атрибут, закрывающий тег или экранированный символ сложно найти, если всё находится в одной строке. Этот formatter показывает читаемую раскладку, чтобы просмотреть структуру перед использованием в build, request или configuration.
Форматирование меняет представление, а не задуманные XML-данные. Имена элементов, значения атрибутов, text node, комментарии и entity reference должны сохраняться, пока добавляются единые отступы и переносы строк. Читаемый результат не является проверкой schema.
При знакомстве с инструментом используйте небольшой representative sample. Храните source document, formatted copy и последующие результаты validation отдельно, чтобы отличать XML syntax, schema, encoding и application rules.
Если документ содержит secret или personal data, создайте redacted copy до вставки. Formatting не анонимизирует значения и не доказывает, что передача в другой service разрешена.
Форматирование не равно validation
XML — вложенный markup format с элементами, атрибутами, текстом, комментариями, декларациями и character reference. Элементам нужны совпадающие opening и closing tag, атрибуты относятся к opening tag, а reserved character вроде ampersand нужно экранировать, если это данные.
Formatter читает достаточно structure, чтобы расположить node и whitespace. Он не доказывает соответствие XSD, DTD, namespace policy, application contract или business rule. Эти проверки оставляйте в workflow, который ими управляет.
Whitespace может быть данными в некоторых XML-контекстах, включая mixed content и text node. Перед изменением документа для whitespace-sensitive consumer сравните output с его требованиями и сохраните original source.
Как форматировать XML
- Вставьте полный XML document или documented fragment в source field. Удалите посторонний текст и wrapper программного языка из test copy.
- Запустите formatter и проверьте nesting, attributes, comments и text values. Formatting failure не доказывает конкретное parser message.
- Сравните formatted document с original. Имена элементов, значения атрибутов, entity reference, namespace declaration и text data должны остаться без изменений.
- После formatting запустите XML parser, schema validator или application test, требуемый project. Formatting сам по себе не доказывает validity или compatibility.
- Для production data удалите secret и personal information из sample. Сохраните исходный файл для controlled diff и rollback.
Метод форматирования
- Прочитать XML structure
Инструмент читает markup как вложенный XML content и определяет границы элементов, атрибутов, текста, комментариев и деклараций, которые можно расположить.
- Применить indentation
Formatter добавляет переносы строк и indentation, чтобы показать отношения parent-child. Этот whitespace относится к presentation, а не к новой schema rule.
- Сохранить технические значения
Attribute text, entity reference, namespace prefix и comment content должны оставаться связанными с source sample. Если важны точные bytes, проверьте diff.
Публичная страница документирует XML input для formatting. Точное parser recovery, whitespace policy и error wording требуют теста на реальном engine.
Читать formatted result
Успешный результат — читаемое расположение переданного XML. Сравните tree, values, attributes, comments и declarations с source.
Failure означает, что documented path не обработал input. Без matching runtime evidence не делайте вывод о точном parser rule или error location.
Если document позже не проходит XSD или application check, исследуйте отдельный contract. Formatting не добавляет required elements, namespaces или types.
Типичные ошибки
Если принять indentation за schema validation, можно не заметить отсутствующие required elements или invalid attributes.
Замена escaped entities видимыми символами может изменить XML data или сделать document invalid.
Сортировка attributes или children ради внешнего вида может изменить ожидаемый порядок consumer или mixed content.
Копирование fragment без нужной namespace declaration делает test непохожим на production document.
Ограничения
Документированная возможность — XML formatting. Она не доказывает XSD или DTD validation, transformation, canonicalization, security analysis или application compatibility.
Проверяйте с target consumer mixed content, чувствительный к whitespace, namespaces, большие documents и parser-specific recovery.
Не вставляйте confidential production documents без разрешения policy. Formatted copy может содержать те же sensitive values.
Examples
Форматировать простой element
Можно ли сделать компактный element читаемым?
Отправьте compact XML.
Child elements появляются на отдельных строках с отступом под note.
Сохранить attributes
Как проверить element с attribute?
Отправьте element и осмотрите opening tag.
Attribute id остаётся у user, а child name получает отступ.
Сохранить escaped text
Останется ли entity внутри текста?
Отформатируйте document и сравните text node.
Entity reference остаётся частью текстового представления.
Форматировать повторяющихся детей
Можно ли ясно разделить repeated elements?
Отправьте parent с двумя item children.
Каждый повторяющийся child стоит в своей строке, поэтому порядок виден.
Сохранить comment
Что происходит с XML comment?
Отформатируйте configuration sample.
Comment остаётся в document между parent и mode element.
Сохранить declaration
Как обрабатывается XML declaration?
Отправьте declaration вместе с root element.
Declaration остаётся в начале, а root content получает отступ ниже.
Frequently asked questions
Проверяет ли formatting XML schema?
Нет. Он организует XML structure. Для schema check используйте требуемый XSD, DTD или application validator.
Меняет ли formatting значения элементов?
Он должен сохранять values и structure, добавляя presentation whitespace. Сравните с original, если важен точный текст.
Сохраняются ли comments?
В примерах comments остаются content в formatted view. Проверьте поведение на своём input до использования в pipeline.
Можно ли форматировать XML fragment?
Используйте полный document или documented fragment shape. Fragment может зависеть от отсутствующего namespace или root.
Делает ли formatting XML меньше?
Нет. Для читаемости обычно добавляется whitespace. Для compact output используйте отдельный minifier или transport process.
Что делать с escaped ampersand?
Оставляйте reference вроде & как XML data. Не заменяйте её raw ampersand, если context перестаёт быть valid XML.
Исправляет ли formatting malformed XML?
Не предполагайте automatic repair. Исправьте source осознанно и запустите parser и schema checks приложения.
Что делать после formatting?
Проверьте diff, выполните parser или schema checks и протестируйте formatted copy с настоящим consumer, если важны whitespace или namespaces.