Как да коментирам блок от тагове в XML?
Т.е. как мога да коментирам <staticText>
и всичко вътре в него в кода по-долу?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Бих могъл да използвам <!-- staticText-->
, но това е само за единични тагове (доколкото знам), като //
в Java и C. Бих искал нещо по-скоро подобно на това как /** comment **/
може да се използва в Java и C, така че да мога да коментирам по-дълги блокове от XML код.
Можете да използвате този стил на коментар на няколко реда (който съществува и в HTML).
<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>
Ако питате, защото имате грешки със синтаксиса <!-- -->
, най-вероятно става дума за секцията CDATA (и там частта ]]>
), която се намира в средата на коментара. Това не би трябвало да има значение, но понякога идеалният и реалният свят могат да се разминават доста (особено когато става въпрос за обработка на XML).
Опитайте се да промените и частта ]]>
:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Друго нещо, което ми идва наум: Ако съдържанието на вашия XML някъде съдържа две тирета, коментарът веднага свършва там:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Това е доста често срещан капан. Той е наследен от начина, по който SGML обработва коментарите. (Прочетете спецификацията на XML по тази тема)
Всъщност можете да използвате формата при многоредови текстове или тагове:
<!--
...
...
...
-->