XML-dokumenttien muotoilu ja tiivistäminen
XML (Extensible Markup Language) on laajasti käytetty standardi tiedon tallentamiseen, siirtämiseen ja konfigurointiin. Jotta XML-dokumentti olisi käyttökelpoinen, sen on oltava rakenteellisesti oikein muodostettu. XML-muotoilija / -validoija tarjoaa kolme päätoimintoa XML-tietojen käsittelyyn: muotoilun, minifoinnin ja validoinnin.
Muotoilu (formatting) ja minifointi (minifying) vaikuttavat suoraan dokumentin luettavuuteen ja tiedostokokoon:
- Muotoile: Tämä toiminto sisentää XML-koodin uudelleen, jolloin tagit ja niiden sisäkkäiset rakenteet ovat helposti hahmotettavissa. Se auttaa kehittäjiä ja ylläpitäjiä saamaan selkeän yleiskuvan dokumentin hierarkiasta.
- Minifoi: Tämä toiminto poistaa rivinvaihdot ja sisennykset solmujen väliltä. Tuloksena on mahdollisimman tiivis XML-esitys, joka säästää tilaa ja vähentää siirrettävän datan määrää.
Työkalu näyttää käsittelyn jälkeen hyödyllisiä tilastotietoja syötteestä, kuten rivien määrän (Riviä), merkkien määrän (Merkkiä) sekä tiedostokoon (Koko). Kun suoritat minifoinnin, työkalu laskee säästetyn tilan suhteellisen osuuden ja ilmoittaa sen muodossa: "XML minifoitu — {pct} % pienempi.". Jos haluat tyhjentää syötealueen kokonaan, työkalu ilmoittaa tilaksi "Tyhjennetty.".
XML-syntaksin säännöt ja muotovalio rakenne
XML-dokumentin on noudatettava tarkkoja syntaksisääntöjä ollakseen muotovalio (well-formed). Toisin kuin esimerkiksi HTML, XML ei salli pieniäkään poikkeamia rakennesäännöistä. Validointitoiminto tarkistaa seuraavat perusvaatimukset:
- Yhtenäinen dokumenttirakenne: Dokumentilla on oltava täsmälleen yksi juurielementti, jonka sisään kaikki muut elementit sijoittuvat.
- Täsmäävät tagit: Jokaisella aloitustagilla on oltava vastaava lopetustagi (esimerkiksi
<solmu>vaatii lopetuksen</solmu>), ja tagien on oltava oikein sisäkkäisiä. XML on myös herkkä kirjainkoolle. - Lainausmerkeissä olevat attribuutit: Kaikkien attribuuttien arvojen on oltava lainausmerkeissä, joko yksinkertaisissa ('value') tai kaksinkertaisissa ("value").
- Sallitut merkinnät: Dokumentti ei saa sisältää kiellettyjä merkkejä tai virheellisiä entiteettiviittauksia.
Kun syötetty koodi täyttää nämä vaatimukset, työkalu antaa ilmoituksen "Kelvollinen XML-rakenne." ja "XML muotoiltu.". On tärkeää huomata, että tämä työkalu tekee ainoastaan muotovalio-tarkistuksen. Se ei validoi XML-koodia ulkoista skeemaa, kuten XSD- (XML Schema Definition) tai DTD-tiedostoa (Document Type Definition), eikä mitään erillistä liiketoimintaskeemaa vasten.
Tyhjän tilan merkitys XML-dokumenteissa
Vaikka muotoilu parantaa luettavuutta lisäämällä sisennyksiä ja rivinvaihtoja, tyhjällä tilalla (whitespace) voi XML-standardissa olla merkitystä. XML-elementit voivat sisältää niin sanottua sekasisältöä (mixed content), jossa samassa elementissä on sekä tekstiä että alielementtejä.
Muotoilu säilyttää aina itse elementit ja attribuutit muuttumattomina, mutta tyhjän tilan muokkaaminen voi vaikuttaa sovelluksiin, jotka käsittelevät tyhjästä tilasta riippuvaista tekstiä. Jos XML-dokumenttisi sisältää tällaista herkkää dataa, on suositeltavaa tarkistaa muotoiltu tulos huolellisesti ennen alkuperäisen lähdetekstin korvaamista, sillä suoritetun operaation tulos ei automaattisesti korvaa alkuperäistä syötettä.
XML-virheiden jäljittäminen ja korjaaminen
Jos XML-dokumentti ei ole muotovalio, työkalu ilmoittaa virheestä tekstillä "Tämä XML ei ole muotovalio.". Virheen paikallistamiseksi työkalu analysoi rakenteen ja ilmoittaa tarkan kohdan muodossa: "Virheellinen XML · rivi {line}, sarake {col}". Lisäksi osiossa "Jäsentimen viesti" näytetään tarkempi kuvaus siitä, mikä sääntörikkomus esti dokumentin lukemisen.
Yleisimpiä virheitä ja niiden korjausstrategioita:
- Puuttuva lopetustagi: Jos työkalu ilmoittaa virheestä tietyn rivin kohdalla, tarkista sitä edeltävät elementit. Usein virhe johtuu siitä, että jokin aiempi elementti on jäänyt sulkematta.
- Väärä sisäkkäisyys: Varmista, että elementit suljetaan käänteisessä järjestyksessä kuin ne avattiin (esimerkiksi
<a><b></a></b>on virheellinen rakenne). - Lainausmerkit attribuuteissa: Tarkista ilmoitetun rivin attribuutit. Jos attribuutin arvo alkaa lainausmerkillä mutta päättyy ilman sitä, jäsennys epäonnistuu.
Jos syötetty XML on pahasti korruptoitunut tai sitä ei voida lainkaan tulkita, työkalu näyttää virheilmoituksen "Tämän XML-koodin käsittely epäonnistui.". Käsittelyssä on myös kokorajoitus: suurin sallittu syötteen koko on 500 000 merkkiä. Jos tämä raja ylittyy, työkalu ilmoittaa: "Tämä XML on liian suuri käsiteltäväksi. Kokeile pienempää dokumenttia.".
Tietosuoja ja selainpohjainen käsittely
Tietoturva ja yksityisyys ovat kriittisiä tekijöitä konfiguraatiotiedostoja ja tiedonsiirtopaketteja käsiteltäessä. XML-muotoilija / -validoija suorittaa kaikki operaatiot – muotoilun, minifoinnin ja validoinnin – suoraan käyttäjän selaimessa.
Mitään syöttämiäsi XML-tietoja ei lähetetä BroBroGo-palvelimelle. Koska käsittely tapahtuu kokonaan paikallisesti omassa laitteessasi, tietosi pysyvät omassa hallinnassasi koko toimituksen ajan.
Usein kysytyt kysymykset
Mitä eroa on muotoilulla ja minifoinnilla?
Muotoilu sisentää XML-koodin uudelleen, jotta tagit ja sisäkkäisyydet ovat helppolukuisia. Minifointi puolestaan poistaa rivinvaihdot ja sisennykset solmujen väliltä, jolloin XML-koodin koko pienenee. Käytä muotoilua muokatessasi ja minifointia silloin, kun tarvitset tiivistä tulostetta.
Mitä validointi tarkistaa?
Se tarkistaa, onko XML muotovalio (well-formed): yhtenäinen dokumenttirakenne, täsmäävät tagit, lainausmerkeissä olevat attribuutit ja sallitut merkinnät. Se ei validoi koodia XSD-, DTD- tai muuta liiketoimintaskeemaa vasten.
Voiko muotoilu muuttaa merkityksellistä tyhjää tilaa?
Se säilyttää elementit ja attribuutit, mutta tyhjä tila voi olla merkityksellistä joissakin XML-dokumenteissa. Jos tiedostosi sisältää sekasisältöä tai tyhjästä tilasta riippuvaista tekstiä, tarkista tulos ennen alkuperäisen korvaamista.
Miksi työkalu ilmoittaa virheestä, vaikka XML-tiedostoni pitäisi olla oikein?
XML-standardi on erittäin tiukka. Pienikin virhe, kuten väärässä järjestyksessä suljetut tagit, puuttuva lainausmerkki attribuutin ympäriltä tai useampi kuin yksi juurielementti, tekee dokumentista virheellisen. Työkalu auttaa sinua paikallistamaan virheen ilmoittamalla tarkan rivin ja sarakkeen numeron.