org.apache.tools.ant.taskdefs.optional
Class XMLValidateTask
public class XMLValidateTask
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.
execute , getDescription , getLocation , getOwningTarget , getRuntimeConfigurableWrapper , getTaskName , getTaskType , getWrapper , handleErrorFlush , handleErrorOutput , handleFlush , handleInput , handleOutput , init , isInvalid , log , log , maybeConfigure , perform , reconfigure , setDescription , setLocation , setOwningTarget , setRuntimeConfigurableWrapper , setTaskName , setTaskType |
INIT_FAILED_MSG
protected static final String INIT_FAILED_MSG
classpath
protected Path classpath
failOnError
protected boolean failOnError
file
protected File file
file to be validated
filesets
protected Vector filesets
sets of file to be validated
lenient
protected boolean lenient
readerClassName
protected String readerClassName
warn
protected boolean warn
xmlReader
protected XMLReader xmlReader
the parser is viewed as a SAX2 XMLReader. If a SAX1 parser is specified,
it's wrapped in an adapter that make it behave as a XMLReader.
a more 'standard' way of doing this would be to use the JAXP1.1 SAXParser
interface.
addConfiguredXMLCatalog
public void addConfiguredXMLCatalog(XMLCatalog catalog)
add an XMLCatalog as a nested element; optional.
catalog
- XMLCatalog to use
addFileset
public void addFileset(FileSet set)
specify a set of file to be checked
set
- the fileset to check
createAttribute
public XMLValidateTask.Attribute createAttribute()
Add an attribute nested element. This is used for setting arbitrary
features of the SAX parser.
Valid attributes
include
- attribute created
- ant1.6
createDTD
public DTDLocation createDTD()
Create a DTD location record; optional.
This stores the location of a DTD. The DTD is identified
by its public Id.
- created DTD location
getEntityResolver
protected EntityResolver getEntityResolver()
accessor to the xmlCatalog used in the task
- xmlCatalog reference
init
public void init()
throws BuildException
Called by the project to let the task initialize properly.
- init in interface Task
BuildException
- if something goes wrong with the build
setClassName
public void setClassName(String className)
Specify the class name of the SAX parser to be used. (optional)
className
- should be an implementation of SAX2
org.xml.sax.XMLReader
or SAX2 org.xml.sax.Parser
.
if className is an implementation of
org.xml.sax.Parser
, setLenient(boolean)
,
will be ignored.
if not set, the default will be used.
org.xml.sax.XMLReader
, org.xml.sax.Parser
setClasspath
public void setClasspath(Path classpath)
Specify the classpath to be searched to load the parser (optional)
classpath
- the classpath to load the parser
setClasspathRef
public void setClasspathRef(Reference r)
Where to find the parser class; optional.
r
- reference to a classpath defined elsewhere
setClasspath(Path)
setFailOnError
public void setFailOnError(boolean fail)
Specify how parser error are to be handled.
Optional, default is
true
.
If set to
true
(default), throw a buildException if the
parser yields an error.
fail
- if set to false
do not fail on error
setFile
public void setFile(File file)
specify the file to be checked; optional.
file
- the file to be checked
setLenient
public void setLenient(boolean bool)
Specify whether the parser should be validating. Default
is
true
.
If set to false, the validation will fail only if the parsed document
is not well formed XML.
this option is ignored if the specified class
with
setClassName(String)
is not a SAX2 XMLReader.
bool
- if set to false
only fail on malformed XML
setWarn
public void setWarn(boolean bool)
Specify how parser error are to be handled.
If set to
true (default), log a warn message for each SAX warn event.
bool
- if set to false
do not send warnings
Copyright B) 2000-2005 Apache Software Foundation. All Rights Reserved.