javax.xml.parsers
public abstract class SAXParserFactory extends Object
An implementation of the SAXParserFactory
class is
NOT guaranteed to be thread safe. It is up to the user application
to make sure about the use of the SAXParserFactory
from
more than one thread. Alternatively the application can have one instance
of the SAXParserFactory
per thread.
An application can use the same instance of the factory to obtain one or
more instances of the SAXParser
provided the instance
of the factory isn't being used in more than one thread at a time.
The static newInstance
method returns a new concrete
implementation of this class.
Since: JAXP 1.0
Version: 1.0
Constructor Summary | |
---|---|
protected | SAXParserFactory() |
Method Summary | |
---|---|
abstract boolean | getFeature(String name)
Returns the particular property requested for in the underlying
implementation of org.xml.sax.XMLReader.
|
boolean | isNamespaceAware()
Indicates whether or not the factory is configured to produce
parsers which are namespace aware.
|
boolean | isValidating()
Indicates whether or not the factory is configured to produce
parsers which validate the XML content during parse.
|
static SAXParserFactory | newInstance()
Obtain a new instance of a SAXParserFactory . |
abstract SAXParser | newSAXParser()
Creates a new instance of a SAXParser using the currently
configured factory parameters.
|
abstract void | setFeature(String name, boolean value)
Sets the particular feature in the underlying implementation of
org.xml.sax.XMLReader.
|
void | setNamespaceAware(boolean awareness)
Specifies that the parser produced by this code will
provide support for XML namespaces. |
void | setValidating(boolean validating)
Specifies that the parser produced by this code will
validate documents as they are parsed. |
Parameters: name The name of the property to be retrieved.
Returns: Value of the requested property.
Throws: SAXNotRecognizedException When the underlying XMLReader does not recognize the property name. SAXNotSupportedException When the underlying XMLReader recognizes the property name but doesn't support the property.
See Also: XMLReader
Returns: true if the factory is configured to produce parsers which are namespace aware; false otherwise.
Returns: true if the factory is configured to produce parsers which validate the XML content during parse; false otherwise.
SAXParserFactory
. This
static method creates a new factory instance
This method uses the following ordered lookup procedure to determine
the SAXParserFactory
implementation class to
load:
javax.xml.parsers.SAXParserFactory
system
property.
java.util.Properties
format and contains the fully qualified name of the
implementation class with the key being the system property defined
above.
META-INF/services/javax.xml.parsers.SAXParserFactory
in jars available to the runtime.
SAXParserFactory
instance.
SAXParserFactory
it can use the factory to
configure and obtain parser instances.
Returns: A new instance of a SAXParserFactory.
Throws: FactoryConfigurationError if the implementation is not available or cannot be instantiated.
Returns: A new instance of a SAXParser.
Throws: ParserConfigurationException if a parser cannot be created which satisfies the requested configuration.
Parameters: name The name of the feature to be set. value The value of the feature to be set.
Throws: SAXNotRecognizedException When the underlying XMLReader does not recognize the property name. SAXNotSupportedException When the underlying XMLReader recognizes the property name but doesn't support the property.
See Also: XMLReader
false
.
Parameters: awareness true if the parser produced by this code will provide support for XML namespaces; false otherwise.
false
.
Parameters: validating true if the parser produced by this code will validate documents as they are parsed; false otherwise.