Syöte

Tulos

Mikä on XML-muotoilija?

Jos olet koskaan liittänyt SOAP-vastauksen tai avannut pom.xml-tiedoston ja nähnyt yhden valtavan lukukelvottoman rivin, tunnet ongelman. XML:ää käytetään asetustiedostoihin, SOAP-rajapintoihin, RSS-syötteisiin ja muotoihin kuten Office Open XML. W3C:n XML-määrittely pitää syntaksin minimaalisena — loistava koneille, kamala ihmisille. Tämä muotoilija lisää asianmukaisen sisennyksen ja rivinvaihdot, jotta tagien hierarkia näkyy yhdellä silmäyksellä. Se käyttää selaimen DOMParser API:a, joten mikään data ei poistu laitteeltasi.

Työkalu jäsentää XML:si selaimen sisäänrakennetulla DOMParserilla ja muotoilee sen yhtenäisellä sisennöksellä. Tulos näkyy tulospaneelissa. Mitään ei lähetetä palvelimelle, joten voit käyttää sitä turvallisesti tuotantodatan, API-vastausten tai arkaluontoisten asetusten kanssa. Käytä Tiivistä pakataksesi tuloksen tai XML JSONiksi muuntaaksesi toiseen muotoon.

Esimerkkejä XML-muotoilusta

Tiivistetty XML on vaikea lukea; muotoilu paljastaa rakenteen. Esimerkkejä teleyhteyteen liittyen:

Esimerkki 1: Tilaajatietue

Tiivistetty syöte:

Syöte

Muotoiltu tulos:

Tulos

Esimerkki 2: Puhelutietueet

Tiivistetty syöte:

Syöte

Muotoiltu tulos:

Tulos

Napsauta yllä olevaa Esimerkki-painiketta ladataksesi tilaajadatan editoriin.

Miten työkalua käytetään

1

Liitä tai lataa

Kopioi XML ja liitä se vasempaan editoriin. Voit myös napsauttaa Lataa ja avata .xml-tiedoston tietokoneeltasi. Esimerkki-painike lataa testidataa.

2

Tarkista tulos

Oikea paneeli näyttää muotoillun XML:n oikealla sisennöksellä. Kelvollinen XML muotoillaan uudelleen; virheellinen XML näyttää virheen. Käytä Tiivistä poistaaksesi kaiken tyhjän tilan ja saadaksesi yhden rivin version. Arvojen poimimiseen suurista XML-tiedostoista XPath -työkalu sopii hyvin tämän rinnalle.

3

Kopioi, lataa tai tiivistä

Käytä Kopioi kopioidaksesi tuloksen leikepöydälle, Lataa tiedostona tallentaaksesi tiedostona tai Tiivistä poistaaksesi kaiken tyhjän tilan. Validointiin ennen tai jälkeen muotoilun käytä XML-tarkistinta.

Miten muotoilija toimii

Työkalu käyttää selaimen DOMParseria jäsentääkseen XML:n DOM-puuksi. Se serialisoi puun takaisin sisennyksellä tagien välillä. W3C:n XML-määrittely pitää tagien välistä tyhjää tilaa usein merkityksettömänä, joten rakenne ja sisältö säilyvät — vain muotoilu muuttuu.

XML tukee toisin kuin JSON kommentteja. Jos dokumentissa on <!-- kommentteja -->, ne säilytetään. Skeemavalidointiin (XSD) käytä erillistä skeematarkistinta; tämä työkalu tarkistaa vain oikean muotoisuuden. W3C XML Schema määrittelee XSD:n.

Missä XML-muotoilusta on hyötyä

Kehittäjät tarvitsevat usein muotoilijaa API-vastauksia lukiessaan. Lähetät pyynnön Postmanilla tai curlilla, ja SOAP- tai REST-vastaus tulee yhtenä tiiviinä rivinä. Liittämällä sen tähän näet sisäkkäiset elementit ja attribuutit heti. Arvojen poimimiseen käytä XPath -työkalua.

Asetustiedostot kuten pom.xml, web.config tai AndroidManifest.xml sisältävät usein sisäkkäisiä rakenteita. Muotoilu täällä antaa yhtenäisen asettelun pull requesteille tai katsauksille. Tekoälyavustimet kuten Microsoft Copilot voivat auttaa XML-skeemojen tai mallien luonnissa, jotka voit muotoilla täällä ennen käyttöä. Jos tarvitset JSONia moderneille API:lle, käytä XML JSONiksi.

RSS- ja Atom-syötteet ovat XML:ää. Jos syötteen validointi epäonnistuu tai lukija ei tue syötettä, muotoilu auttaa löytämään virheen. Aja ensin XML-tarkistin -työkalun läpi, niin ongelmat löytyvät ennen muita.

Usein kysyttyä

Onko XML-datani yksityinen tätä työkalua käyttäessä?

Kyllä, täysin. Muotoilu tapahtuu selaimessasi sisäänrakennetun DOMParserin avulla. Mitään ei lähetetä palvelimelle. Avaa selaimesi Verkko-välilehti vahvistaaksesi.

Entä XML-nimiavaruudet ja etuliitteet?

Nimiavaruusdeklaraatiot ja etuliitteet säilyvät kokonaan. Muotoilija säätää vain tyhjää tilaa, ei koskaan rakennetta. Katso W3C:n XML Namespaces -määrittely.

Miten muunnan XML:n JSONiksi?

Käytä XML JSONiksi -muunninta. Se käsittelee automaattisesti attribuutit, sisäkkäiset elementit ja toistuvat solmut.

Miksi XML näyttää virheen muotoilun jälkeen?

Muotoilija vaatii hyvin muodostettua XML:ää. Yleisiä ongelmia: sulkemattomat tagit, puuttuvat lainausmerkit attribuuteissa, escapoimattomat merkit kuten &. Kokeile XML-tarkistinta yksityiskohtaisia virheraporteja varten.

Voinko muotoilla XHTML:ää, SVG:tä tai muita XML-muotoja?

Kyllä. XHTML, SVG, WSDL ja kaikki muut kelvolliset XML-muodot muotoillaan oikein. Työkalu noudattaa W3C:n XML-määrittelyä.

Liittyvät työkalut

Tarkempaa XML:stä: W3C:n XML-määrittely koko syntaksista. MDN:n DOMParser-oppaat kertovat XML:n jäsentämisestä selaimessa. JSONista: json.org. XPath-kyselyistä: XPath 3.1. Katso myös W3C XML ja Postman.