org.apache.xpath.jaxp
Class XPathFactoryImpl

java.lang.Object
  |
  +--javax.xml.xpath.XPathFactory
        |
        +--org.apache.xpath.jaxp.XPathFactoryImpl

public class XPathFactoryImpl

extends XPathFactory

The XPathFactory builds XPaths.

Fields inherited from class javax.xml.xpath.XPathFactory

DEFAULT_OBJECT_MODEL_URI, DEFAULT_PROPERTY_NAME

Constructor Summary

XPathFactoryImpl()

Method Summary

boolean	getFeature(java.lang.String name) Get the state of the named feature.
boolean	isObjectModelSupported(java.lang.String objectModel) Is specified object model supported by this XPathFactory?
XPath	newXPath() Returns a new XPath object using the underlying object model determined when the factory was instantiated.
void	setFeature(java.lang.String name, boolean value) Set a feature for this XPathFactory and XPaths created by this factory.
void	setXPathFunctionResolver(XPathFunctionResolver resolver) Establish a default function resolver.
void	setXPathVariableResolver(XPathVariableResolver resolver) Establish a default variable resolver.

Methods inherited from class javax.xml.xpath.XPathFactory

newInstance, newInstance

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XPathFactoryImpl

public XPathFactoryImpl()

Method Detail

isObjectModelSupported

public boolean isObjectModelSupported(java.lang.String objectModel)

Is specified object model supported by this XPathFactory?

Parameters:

objectModel - Specifies the object model which the returned XPathFactory will understand.

Returns:

true if XPathFactory supports objectModel, else false.

Throws:

java.lang.NullPointerException - If objectModel is null.

java.lang.IllegalArgumentException - If objectModel.length() == 0.

Overrides:

isObjectModelSupported in class XPathFactory

newXPath

public XPath newXPath()

Returns a new XPath object using the underlying object model determined when the factory was instantiated.

Returns:

New XPath

Overrides:

newXPath in class XPathFactory

setFeature

public void setFeature(java.lang.String name,
                       boolean value)
                throws XPathFactoryConfigurationException

Set a feature for this XPathFactory and XPaths created by this factory.

Feature names are fully qualified java.net.URIs. Implementations may define their own features. An XPathFactoryConfigurationException is thrown if this XPathFactory or the XPaths it creates cannot support the feature. It is possible for an XPathFactory to expose a feature value but be unable to change its state.

See XPathFactory for full documentation of specific features.

Parameters:

name - Feature name.

value - Is feature state true or false.

Throws:

XPathFactoryConfigurationException - if this XPathFactory or the XPaths it creates cannot support this feature.

java.lang.NullPointerException - if name is null.

Overrides:

setFeature in class XPathFactory

getFeature

public boolean getFeature(java.lang.String name)
                   throws XPathFactoryConfigurationException

Get the state of the named feature.

Feature names are fully qualified java.net.URIs. Implementations may define their own features. An XPathFactoryConfigurationException is thrown if this XPathFactory or the XPaths it creates cannot support the feature. It is possible for an XPathFactory to expose a feature value but be unable to change its state.

Parameters:

name - Feature name.

Returns:

State of the named feature.

Throws:

XPathFactoryConfigurationException - if this XPathFactory or the XPaths it creates cannot support this feature.

java.lang.NullPointerException - if name is null.

Overrides:

getFeature in class XPathFactory

setXPathFunctionResolver

public void setXPathFunctionResolver(XPathFunctionResolver resolver)

Establish a default function resolver.

Any XPath objects constructed from this factory will use the specified resolver by default.

A NullPointerException is thrown if resolver is null.

Parameters:

resolver - XPath function resolver.

Throws:

java.lang.NullPointerException - If resolver is null.

Overrides:

setXPathFunctionResolver in class XPathFactory

setXPathVariableResolver

public void setXPathVariableResolver(XPathVariableResolver resolver)

Establish a default variable resolver.

Any XPath objects constructed from this factory will use the specified resolver by default.

A NullPointerException is thrown if resolver is null.

Parameters:

resolver - Variable resolver.

Throws:

java.lang.NullPointerException - If resolver is null.

Overrides:

setXPathVariableResolver in class XPathFactory