BenQ Mobile

javax.xml.parsers
Class SAXParserFactory

java.lang.Object
  extended byjavax.xml.parsers.SAXParserFactory

public abstract class SAXParserFactory
extends java.lang.Object

Defines a factory API that enables applications to configure and obtain a SAX based parser to parse XML documents.

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()
          Default constructor.
 
Method Summary
abstract  boolean getFeature(java.lang.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(java.lang.String name, boolean value)
          Sets the particular feature in the underlying implementation of org.xml.sax.XMLReader.
 void setNamespaceAware(boolean lnamespaceAware)
          Specifies that the parser produced by this code will provide support for XML namespaces.
 void setValidating(boolean lvalidating)
          Specifies that the parser produced by this code will validate documents as they are parsed.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAXParserFactory

protected SAXParserFactory()
Default constructor.

Method Detail

newInstance

public static SAXParserFactory newInstance()
                                    throws FactoryConfigurationError
Obtain a new instance of a 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: Once an application has obtained a reference to a 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.

newSAXParser

public abstract SAXParser newSAXParser()
                                throws ParserConfigurationException,
                                       org.xml.sax.SAXException
Creates a new instance of a SAXParser using the currently configured factory parameters.

Returns:
A new instance of a SAXParser.
Throws:
ParserConfigurationException - if a parser cannot be created which satisfies the requested configuration.
org.xml.sax.SAXException - if the underlying parser throws an SAXException.

setNamespaceAware

public void setNamespaceAware(boolean lnamespaceAware)
Specifies that the parser produced by this code will provide support for XML namespaces. By default the value of this is set to false.

Parameters:
lnamespaceAware - true if the parser produced by this code will provide support for XML namespaces; false otherwise.

isNamespaceAware

public boolean isNamespaceAware()
Indicates whether or not the factory is configured to produce parsers which are namespace aware.

Returns:
true if the factory is configured to produce parsers which are namespace aware; false otherwise.

setValidating

public void setValidating(boolean lvalidating)
Specifies that the parser produced by this code will validate documents as they are parsed. By default the value of this is set to false.

Parameters:
lvalidating - true if the parser produced by this code will validate documents as they are parsed; false otherwise.

isValidating

public boolean isValidating()
Indicates whether or not the factory is configured to produce parsers which validate the XML content during parse.

Returns:
true if the factory is configured to produce parsers which validate the XML content during parse.

setFeature

public abstract void setFeature(java.lang.String name,
                                boolean value)
                         throws ParserConfigurationException,
                                org.xml.sax.SAXNotRecognizedException,
                                org.xml.sax.SAXNotSupportedException
Sets the particular feature in the underlying implementation of org.xml.sax.XMLReader. A list of the core features and properties can be found at http://www.saxproject.org/?selected=get-set

Parameters:
name - The name of the feature to be set.
value - The value of the feature to be set.
Throws:
org.xml.sax.SAXNotRecognizedException - When the underlying XMLReader does not recognize the property name.
org.xml.sax.SAXNotSupportedException - When the underlying XMLReader recognizes the property name but doesn't support the property.
ParserConfigurationException - thrown if the given feature is not supported.
See Also:
XMLReader.setFeature(java.lang.String, boolean), getFeature(String)

getFeature

public abstract boolean getFeature(java.lang.String name)
                            throws ParserConfigurationException,
                                   org.xml.sax.SAXNotRecognizedException,
                                   org.xml.sax.SAXNotSupportedException
Returns the particular property requested for in the underlying implementation of org.xml.sax.XMLReader.

Parameters:
name - The name of the property to be retrieved.
Returns:
Value of the requested property.
Throws:
org.xml.sax.SAXNotRecognizedException - When the underlying XMLReader does not recognize the property name.
org.xml.sax.SAXNotSupportedException - When the underlying XMLReader recognizes the property name but doesn't support the property.
ParserConfigurationException - if the parser do not satisfy the requested configuration being queried.
See Also:
XMLReader.getProperty(java.lang.String), setFeature(String, boolean)

BenQ Mobile

Copyright © 2006 BenQ Mobile GmbH & Co. OHG or respective copyright owner.
All Rights Reserved.
BenQ Corp. is a trademark licensee of Siemens AG.


For further information about Mobility Toolkit (MTK) visit our Developer Portal.