ツール説明
XML フォーマッターについて
XML フォーマッターは、圧縮された XML や機械生成の XML を、読みやすくインデントされた形に整形します。
API レスポンス、設定ファイル、SOAP メッセージを貼り付けて、整形する・1 行に圧縮する・折りたたみ可能なツリーで見る、が選べます。
XML Formatter の使い方
- XML を貼り付けるか、.xml ファイルをアップロードします。
- Format でスペース 2・スペース 4・タブのいずれかのインデントに整形し、Compress で余分な whitespace を削ります。
- ツリー表示に切り替えて branch を折りたたみます。well-formed でない場合はエラー表示を確認します。
よくある利用場面
- logs や network タブからコピーした 1 行の XML レスポンスを読む。
- 深くネストした SOAP メッセージや RSS フィードを、閉じタグを手で数えずに確認する。
- 設定ファイルを commit する前に、タグの不一致がある行と列を特定する。
XML の syntax、namespace、整形では直せないこと
整形が変えるのは node 間の whitespace だけです。データを書き換えることはなく、不正な document を正しくすることもできません。
- すべての element には対応する閉じタグが必要で、タグ名は大文字小文字を区別します： <Book> と <book> は別の element です。
- 属性の値は引用符で囲む必要があり、meta: のような名前空間プレフィックスは xmlns 属性で宣言します。
- CDATA セクション内のテキストはそのまま保持されるため、マークアップのように見える内容も再インデントされません。
XML フォーマッターのよくある質問
- XML beautifier と XML pretty printer は同じものですか？
- はい。beautify、pretty print、形式はどれも同じ操作を指します： データを変えずに改行と indentation を加えることです。
- 整形するとデータは変わりますか？
- いいえ。変わるのは node 間の whitespace だけです。element の順序、attributes、CDATA の内容はそのまま保たれます。
- XML はサーバーにアップロードされますか？
- いいえ。parsing、整形、検証はすべてブラウザー内でローカルに実行され、wetool.site へは何も送信されません。
XML フォーマッターと XML Schema による検証
このツールは document が well-formed かどうか、つまりタグが対応し、引用符が閉じ、ネストが正しいかを確認します。XSD や DTD との照合は行わないため、well-formed でも schema 違反の可能性は残ります。
折りたたみツリーとして XML を読む
XML viewer はテキストではなく構造を見せます。知らない document を理解するにはツリー表示が最速です。関係ない branch を折りたためるからです。
- 各 element はタグ名と attributes を持つ node として表示され、document 全体の形を一目で把握できます。
- branch を折りたたむと subtree 全体が隠れるため、<book> や <item> のような繰り返しレコードを比較しやすくなります。
- 兄弟要素の順序は記述どおりに保持され、同名の element がまとめられることはありません。
XML を検証してエラーを読む
XML validator は、document が well-formed でなくなった最初の位置を、ジャンプできる行と列付きで報告します。
- タグ不一致のエラーは、見つかった閉じタグと、対応する開始タグが宣言された行の両方を示します。
- 引用符のない attribute 値と、紛れ込んだ < や & の文字が、parse 失敗の二大原因です。
- 行番号と列番号は parser 自身が計算するため、Chrome、Firefox、Safari で同じ値になります。