CDRN

Formáidigh agus indeantáil XML

  • Deais
  • Doiciméadú
  • API
formáidíonn cód XML ar bhealach struchtúrtha agus inléite, riachtanach chun do mhalartuithe sonraí a léamh

Cén fáth formáid XML?

Is éard atá i bhformáidiú XML (ar a dtugtar formáidiú XML freisin, eangú XML nó prionta deas). doiciméad XML dlúth nó mionghearrtha a atheagrú ina struchtúr eangaithe, inléite líne ar líne. Feabhsaíonn XML dea-fhormáidithe inléiteacht an duine, rud atá riachtanach agus tú ag léamh freagra GALLÚNACH, brabhsáil fotha RSS, nó scrúdaigh a bhfuil i gcomhad cumraíochta.

Go nithiúil, déanaimid ár XML a fhormáidiú ar cheithre phríomhchúis:

  • Dífhabhtaithe: feictear go tapa clib neamhdhúnta, tréith ar iarraidh nó struchtúr neamh-chomhsheasmhach.
  • Comhtháthú láimhe: cóipeáil blúire go glan i gcomhad cumraíochta gan an eangú reatha a bhriseadh.
  • Léirmheas an chóid: cuir dhá leagan de dhoiciméad XML i Git diff i gcomparáid le bheith inléite nuair a bhíonn gach clib ar a líne féin.
  • Cáipéisí agus samplaí: tá i bhfad níos mó oideachais ag baint le XML formáidithe i ndoiciméad teicniúil nó i README.

Cásanna úsáide tipiciúla

Tá XML fós uileláithreach san éiceachóras bogearraí. Seo iad na formáidí ar a bhfuil na forbróirí is minic a úsáideann formáidí XML:

    Freagairtí Gallúnach: Is gnách go sroichtear miontuairiscí
  • a sheolann seirbhísí gréasáin SOAP ar ais.
  • Fothaí RSS agus Atom: chun fotha sindeacáite a iniúchadh nó a iniúchadh.
  • Spring, Maven (pom.xml), Seangán, Ivy cumraíochtaí: comhaid Java agus comhaid spleáchais.
  • code>AndroidManifest.xml agus acmhainní XML eile de chuid tionscadal Android.
  • Comhaid SVG: Is minic a dhéantar grafaic veicteora a easpórtáiltear ó bhogearraí dearaidh a chomhbhrú in aon líne amháin.
  • Easpórtálacha ríomhthráchtála: Fothaí táirgí Google Shopping, onnmhairí Magento, Shopify nó PrestaShop.
  • Cáipéisí OOXML: Is cartlanna ZIP iad comhaid .docx, .xlsx agus .pptx ina bhfuil comhaid XML ar gá iad a iniúchadh go minic.
  • Léarscáileanna XML: cuireadh an sitemap.xml ar fáil d'innill chuardaigh.

Conas a Oibríonn Formáidiú XML

Ní hamháin go gcuireann formáidí XML spásanna go randamach. Feidhmíonn sé dhá chéim:

  1. Parsáil: léitear an doiciméad ansin claochlú ina chrann DOM (Document Object Model). Deimhníonn an chéim seo freisin go bhfuil an XML dea-chruthaithe (clibeanna neadaithe i gceart, tréithe sna comharthaí athfhriotail, eilimint fréimhe amháin).
  2. Indented serialization: The DOM tree is re-emitted as text with line breaks between elements and indentation proportional to the depth in the tree.

Cinntíonn an cur chuige crann seo go bhfanann struchtúr loighciúil an doiciméid go hiomlán comhionann: ní athraítear ach spásanna neamhshuntasacha idir clibeanna. Ailt CDATA, tuairimí agus coimeádtar treoracha próiseála. Trasfhoirmiúcháin níos airde (XSLT) nó feidhmíonn fiosrúcháin (XPath) ar an gcrann DOM céanna seo.

Conas an Formáid XML a úsáid

Tá an nós imeachta simplí d'aon ghnó:

  1. Greamaigh do dhoiciméad XML sa bhosca téacs, nó uaslódáil comhad .xml.
  2. Bailíochtaigh an fhoirm: déantar an doiciméad a anailísiú agus a eangú go huathoibríoch.
  3. Tá an toradh formáidithe le feiceáil sa limistéar aschuir. I gcás earráide parsála, léiríonn teachtaireacht nádúr agus neasshuíomh na faidhbe.
  4. Cóipeáil an toradh leis an gcnaipe tiomnaithe, nó íoslódáil é chun é a chomhtháthú go díreach le do thionscadal.

Dea-Chleachtais eangaithe XML

Roinnt coinbhinsiúin le leanúint chun XML glan buan a tháirgeadh:

  • Eangú: 2 nó 4 spás ag brath ar ghnás d'fhoirne. Fan comhsheasmhach le linn an tionscadail.
  • Briseadh líne: eilimint amháin in aghaidh an líne, rud a fhágann go bhfuil Git difrúil inúsáidte.
  • Rannáin CDATA: coinníonn formáideoir maith bloic ina n-iomláine gan a n-inneachar a athinniú, rud a láimhseáiltear mar ghnáth-théacs.
  • Ionchódú: dearbhaigh i gcónaí an t-ionchódú sa chéad líne le . Is é UTF-8 an caighdeán de facto.
  • Tréithe: Má tá go leor tréithe ag eilimint, fillteann roinnt foirne iad ar mhaithe le hinléiteacht; nó fanann siad ar an líne chéanna leis an gclib tosaigh.
  • Nótaí: Ní mór a choinneáil mar atá ag an traenálaí.

Sampla roimh/i ndiaidh

Seo sampla nithiúil de dhlúth XML atá maisithe ag an bhformáidí.

Roimh (líne singil, doléite):

item id="1">valval2

Tar éis (formáidithe le 2 spás):



  val
  val2

Tá an struchtúr loighciúil go docht comhionann: ní athraíonn ach an leagan amach amhairc.

Sampla iomlán

Un document XML plus volumineux après formatage resemble à ceci : 



  
    John Doe
    johndoe@example.com
    

      123 Príomhshráid
      Springfield
      IL
      62704
      SAM
    

    
      555-1234
      555-5678
    
    
      fíor
      dorcha
    
    2024-06-14T09:30:00Z

Ceisteanna coitianta

Cad is XML dea-chruthaithe ann?

Deirtear go bhfuil XML dea-chruthaithe nuair a urramaíonn sé na bunrialacha comhréire: eilimint fréimhe amháin, clibeanna neadaithe agus dúnta i gceart, tréithe i Sleachta, carachtair speisialta éalaigh (&, <, >). Is réamhriachtanas é seo chun an doiciméad a pharsáil. Ní féidir é a mheascadh le XML valid, a thugann meas freisin do scéimre XSD nó DTD.

Cad é an difríocht idir formáidiú (an cló go leor) agus mionú XML?

Cuireann cló breá sosanna líne agus eangú le léamh daonna. Déanann mionnú a mhalairt: baintear gach spás neamhsuntasach chun méid an doiciméid a laghdú, rud atá úsáideach le haghaidh idirthurais líonra (freagraí gallúnach, XML API). Tá an dá dhoiciméad coibhéiseach go séimeantach.

An gcaomhnaítear nótaí tráchta agus rannáin CDATA le linn formáidithe?

Tá. Caomhnaíonn formáidí ceart nótaí tráchta, ailt, agus treoracha próiseála (). Fanann inneachar CDATA slán gan athchlarú, ós rud é go gcaitear leis mar ghnáth-théacs. Seiceáil an toradh má tá tábhacht dhoiciméadach ag baint le do chuid tuairimí.

An dtacaítear le spásanna ainm XML (xmlns)?

Tá. Caomhnaítear dearbhuithe ainmspáis (xmlns:soap="...") agus réimírí gaolmhara () mar atá. Ní athainmníonn an formáidí réimíreanna ná ní aistríonn sé dearbhuithe sa chrann, ag cinntiú go bhfanann semantics an doiciméid mar a chéile. Coinnítear spásanna ainm réamhshocraithe (gan réimír) ag a leibhéal dearbhaithe freisin.

Ar cheart dúinn eangú le spásanna nó le cluaisíní?

Oibríonn an dá rud, ach is iad spásanna an gnáthghnás ceannasach mar go dtaispeánann siad go díreach gach áit (críochfoirt, brabhsálaithe, Git diff). 2 nó 4 spás ag brath ar bhriathar do XML: 2 do dhoiciméid an-neadaithe (SVG, cumraíochtaí Earraigh), 4 do dhoiciméid réidh. Is é an rud is mó fós comhsheasmhacht ar fud an tionscadail.

An athraíonn an formáidí semantics an doiciméid?

Ní choigeartaítear ach na spásanna bána idir na clibeanna. Fanann struchtúr DOM, luachanna aitreabúide, agus ábhar téacsúil na n-eilimintí mar a chéile. Eisceacht amháin: ba cheart ábhar téacsúil lánbhrí (le xml:space="preserve") a choinneáil mar atá, seiceáil an gné seo an bhfuil spásanna brí i do shonraí.

An féidir linn XML a bhailíochtú ag an am céanna agus é á fhormáidiú?

Déanann an formáideoir bailíochtú comhréire (XML dea-chruthaithe) cheana féin toisc go gcaithfidh sé an doiciméad a pharsáil. Chun bailíochtú i gcoinne scéimre XSD nó DTD, teastaíonn uirlis thiomnaithe uait: téann bailíochtú struchtúrach thar raon feidhme formáidí simplí. Tá xmllint --schema nó xerces oiriúnach don chéim bhreise seo.

Sampla iarratais

curl -X POST https://cdrn.fr/api/v1/tools/xml-formatter/execute \
  -H "Content-Type: application/json" \
  -d '{"input":"..."}'

Scéimre ionchuir

Réimse Cineál Riachtanach Réamhshocrú
input text ✓ –

Críochphointí

  • GET https://cdrn.fr/api/v1/tools - liostaíonn na huirlisí go léir atá ar fáil
  • GET https://cdrn.fr/api/v1/tools/xml-formatter - faigh scéimre na huirlise seo
  • POST https://cdrn.fr/api/v1/tools/xml-formatter/execute - rith an uirlis seo le pálasta JSON