Miten kommentoin XML:ssä olevan tunnisteiden lohkon pois?
Eli miten voin kommentoida <staticText>
ja kaiken sen sisällä olevan alla olevassa koodissa?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Voisin käyttää <!-- staticText-->
, mutta se'on vain yksittäisille tageille (tietääkseni), kuten //
Javassa ja C:ssä. Haluaisin jotain, joka muistuttaisi enemmän sitä, miten /** comment **/
voidaan käyttää Javassa ja C:ssä, jotta voisin kommentoida pidempiä XML-koodin osia.
Voit käyttää tätä kommenttityyliä useammalla rivillä (joka on olemassa myös HTML:ssä).
<detail>
<band height="20">
<!--
Hello,
I am a multi-line XML comment
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
-->
</band>
</detail>
Jos kysyt, koska sait virheitä <!-- -- -->
-syntaksin kanssa, kyse on todennäköisesti CDATA-osiosta (ja siellä ]]>
-osiosta), joka on sitten kommentin keskellä. Sillä ei pitäisi olla merkitystä, mutta ihanne- ja reaalimaailma voivat joskus olla aika kaukana toisistaan (varsinkin XML:n käsittelyssä).
Yritä muuttaa myös ]]>
:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Toinen asia, joka tulee mieleen: Jos XML:n sisältö sisältää jossain kohtaa kaksi väliviivaa, kommentti loppuu välittömästi siihen:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Se'on melko yleinen sudenkuoppa. Se on perua tavasta, jolla SGML käsittelee kommentteja. (Lue tätä aihetta käsittelevä XML-spesifikaatio))