stevel 2002/09/08 19:50:35 Modified: docs/manual/OptionalTasks xmlvalidate.html Log: Feature support from Nick Pellow, [EMAIL PROTECTED] Revision Changes Path 1.8 +48 -10 jakarta-ant/docs/manual/OptionalTasks/xmlvalidate.html Index: xmlvalidate.html =================================================================== RCS file: /home/cvs/jakarta-ant/docs/manual/OptionalTasks/xmlvalidate.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- xmlvalidate.html 4 Sep 2002 11:05:18 -0000 1.7 +++ xmlvalidate.html 9 Sep 2002 02:50:35 -0000 1.8 @@ -9,14 +9,17 @@ <h2><a name="xmlvalidate">XMLValidate</a></h2> <h3>Description</h3> -<p>This task checks xml files are valid (or only well formed). The +<p>This task checks XML files are valid (or only well formed). The task uses the SAX2 parser implementation provided by JAXP by default -(probably the one that is used by Ant itself), but one can specify any -SAX1/2 parser if needed.</p> - -<p>This task supports the use of nested <a -href="../CoreTypes/xmlcatalog.html">xmlcatalog</a> elements and/or nested -<tt><dtd></tt> elements which are used to resolve DTDs and entities.</p> +(usually the one that is used by Ant itself), but one can specify any +SAX1/2 parser if needed. Ant ships with Xerces, which is also what is built in +to Java 1.4: XML parsers built into the runtime override Ant's choice.</p> + +<p>This task supports the use of nested + <li/><a href="../CoreTypes/xmlcatalog.html"><tt><xmlcatalog></tt></a> elements + <li/><tt><dtd></tt> elements which are used to resolve DTDs and other entities. + <li/><tt><feature></tt> elements which are used to set features. These can be any number of <a href="http://www.saxproject.org/apidoc/org/xml/sax/package-summary.html#package_description";>http://xml.org/sax/features/</a> +</p> <h3>Parameters</h3> <table border="1" cellpadding="2" cellspacing="0"> @@ -62,7 +65,7 @@ <h3><a name="nested">Nested Elements</a></h3> <h4>dtd</h4> -<dtd> is used to specify different locations for DTD resolution. +<dtd> is used to specify different locations for DTD and entity resolution. <table border="1" cellpadding="2" cellspacing="0"> <tr> <td width="12%" valign="top"><b>Attribute</b></td> @@ -84,10 +87,17 @@ <h4>xmlcatalog</h4> <p>The <a href="../CoreTypes/xmlcatalog.html">xmlcatalog</a> element is used to perform Entity resolution.</p> +<h4>feature</h4> +<p>The feature element is used to set SAX Parser features. +A feature essentialy changes the mode of the parser. +There can be an arbitrary amount of features set as defined here: + <a href="http://www.saxproject.org/apidoc/org/xml/sax/package-summary.html#package_description";>http://xml.org/sax/features/</a> + +</p> <h3>Examples</h3> -<blockquote><pre> +<pre> <xmlvalidate file="toto.xml"/> <xmlvalidate failonerror="no" lenient="yes" warn="yes" @@ -95,16 +105,28 @@ classpath="lib/xerces.jar"> <fileset dir="src" includes="style/*.xsl"/> </xmlvalidate> +</pre> +Validate all .xsl files in src/style, but only warn if there is an error, rather than +halt the build. +<pre> <xmlvalidate file="struts-config.xml" warn="false"> <dtd publicId="-//Apache Software Foundation//DTD Struts Configuration 1.0//EN" location="struts-config_1_0.dtd"/> </xmlvalidate> +</pre> + +Validate a struts configuration, using a local copy of the DTD. +<pre> <xmlvalidate failonerror="no"> <fileset dir="${project.dir}" includes="**/*.xml"/> <xmlcatalog refid="mycatalog"/> </xmlvalidate> +</pre> + +Scan all XML files in the project, using a predefined catalog to map URIs to local files. +<pre> <xmlvalidate failonerror="no"> <fileset dir="${project.dir}" includes="**/*.xml"/> @@ -114,7 +136,23 @@ location="com/arielpartners/knowledgebase/dtd/article.dtd"/> </xmlcatalog> </xmlvalidate> -</pre></blockquote> +</pre> + +Scan all XML files in the project, using the catalog defined inline. + +<pre> + +<xmlvalidate failonerror="yes" lenient="no" warn="yes"> + + <fileset dir="xml" includes="**/*.xml"/> + <feature name="http://xml.org/sax/features/validation"; value="true"/> + <feature name="http://apache.org/xml/features/validation/schema"; value="true"/> + +</xmlvalidate> +</pre> + +Validate the XML files using XML Schema validation. + <hr> <p align="center">Copyright © 2001-2002 Apache Software Foundation. All rights
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
