javax.xml.parsers
Class SAXParserFactory

java.lang.Object
  extended by javax.xml.parsers.SAXParserFactory

public abstract class SAXParserFactory
extends Object

Factory for obtaining SAX parsers. Instances of this class are not guaranteed to be thread safe.


Constructor Summary
protected SAXParserFactory()
           
 
Method Summary
abstract  boolean getFeature(String name)
          Returns the specified feature for SAX2 parsers obtained from this factory.
 Schema getSchema()
          Returns the schema.
 boolean isNamespaceAware()
          Indicates whether parsers obtained from this factory will be XML Namespace aware.
 boolean isValidating()
          Indicates whether parsers obtained from this factory will validate their input.
 boolean isXIncludeAware()
          Indicates whether parsers obtained from this factory will be XInclude aware.
static SAXParserFactory newInstance()
          Creates a new factory instance.
abstract  SAXParser newSAXParser()
          Creates a new parser instance using the currently specified factory configuration.
abstract  void setFeature(String name, boolean value)
          Sets the specified feature for SAX2 parsers obtained from this factory.
 void setNamespaceAware(boolean awareness)
          Sets whether parsers obtained from this factory will be XML Namespace aware.
 void setSchema(Schema schema)
          Sets the schema.
 void setValidating(boolean validating)
          Sets whether parsers obtained from this factory will validate their input.
 void setXIncludeAware(boolean state)
          Sets whether parsers obtained from this factory will be XInclude aware.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAXParserFactory

protected SAXParserFactory()
Method Detail

newInstance

public static SAXParserFactory newInstance()
                                    throws FactoryConfigurationError
Creates a new factory instance. The implementation class to load is the first found in the following locations:
  1. the javax.xml.parsers.SAXParserFactory system property
  2. the above named property value in the $JAVA_HOME/lib/jaxp.properties file
  3. the class name specified in the META-INF/services/javax.xml.parsers.SAXParserFactory system resource
  4. the default factory class

Throws:
FactoryConfigurationError

newSAXParser

public abstract SAXParser newSAXParser()
                                throws ParserConfigurationException,
                                       SAXException
Creates a new parser instance using the currently specified factory configuration.

Throws:
ParserConfigurationException - if the specified configuration is not supported
SAXException

setNamespaceAware

public void setNamespaceAware(boolean awareness)
Sets whether parsers obtained from this factory will be XML Namespace aware.


setValidating

public void setValidating(boolean validating)
Sets whether parsers obtained from this factory will validate their input.


isNamespaceAware

public boolean isNamespaceAware()
Indicates whether parsers obtained from this factory will be XML Namespace aware.


isValidating

public boolean isValidating()
Indicates whether parsers obtained from this factory will validate their input.


setFeature

public abstract void setFeature(String name,
                                boolean value)
                         throws ParserConfigurationException,
                                SAXNotRecognizedException,
                                SAXNotSupportedException
Sets the specified feature for SAX2 parsers obtained from this factory.

Parameters:
name - the feature name
value - the featurevalue
Throws:
ParserConfigurationException
SAXNotRecognizedException
SAXNotSupportedException

getFeature

public abstract boolean getFeature(String name)
                            throws ParserConfigurationException,
                                   SAXNotRecognizedException,
                                   SAXNotSupportedException
Returns the specified feature for SAX2 parsers obtained from this factory.

Parameters:
name - the feature name
Throws:
ParserConfigurationException
SAXNotRecognizedException
SAXNotSupportedException

getSchema

public Schema getSchema()
Returns the schema.

Since:
1.3
See Also:
setSchema(javax.xml.validation.Schema)

setSchema

public void setSchema(Schema schema)
Sets the schema.

Since:
1.3
See Also:
getSchema()

isXIncludeAware

public boolean isXIncludeAware()
Indicates whether parsers obtained from this factory will be XInclude aware.

Since:
1.3

setXIncludeAware

public void setXIncludeAware(boolean state)
Sets whether parsers obtained from this factory will be XInclude aware.

Since:
1.3