javax.xml.xpath
Class XPathFactory

java.lang.Object
  extended by javax.xml.xpath.XPathFactory

public abstract class XPathFactory
extends Object

Factory for creating XPath environments.

Since:
1.3

Field Summary
static String DEFAULT_OBJECT_MODEL_URI
          The default object model URI.
static String DEFAULT_PROPERTY_NAME
          The default property name according to the JAXP specification.
 
Constructor Summary
protected XPathFactory()
           
 
Method Summary
abstract  boolean getFeature(String name)
          Returns the state of the named feature.
abstract  boolean isObjectModelSupported(String objectModel)
          Indicates whether the specified object model URI is supported by this factory.
static XPathFactory newInstance()
          Returns a new factory for the default (DOM) object model.
static XPathFactory newInstance(String uri)
          Returns a new factory for the given object model URI.
abstract  XPath newXPath()
          Returns a new XPath evaluation environment.
abstract  void setFeature(String name, boolean value)
          Sets the state of the named feature.
abstract  void setXPathFunctionResolver(XPathFunctionResolver resolver)
          Sets the XPath extension function resolver calback.
abstract  void setXPathVariableResolver(XPathVariableResolver resolver)
          Sets the XPath variable resolver calback.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_PROPERTY_NAME

public static final String DEFAULT_PROPERTY_NAME
The default property name according to the JAXP specification.

See Also:
Constant Field Values

DEFAULT_OBJECT_MODEL_URI

public static final String DEFAULT_OBJECT_MODEL_URI
The default object model URI.

See Also:
Constant Field Values
Constructor Detail

XPathFactory

protected XPathFactory()
Method Detail

newInstance

public static final XPathFactory newInstance()
Returns a new factory for the default (DOM) object model.


newInstance

public static final XPathFactory newInstance(String uri)
                                      throws XPathFactoryConfigurationException
Returns a new factory for the given object model URI. The implementation class to load is the first found in the following locations that advertises support for the given model URI:
  1. the javax.xml.xpath.XPathFactory 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.xpath.XPathFactory system resource
  4. the default factory class

Parameters:
uri - the object model URI
Throws:
XPathFactoryConfigurationException

isObjectModelSupported

public abstract boolean isObjectModelSupported(String objectModel)
Indicates whether the specified object model URI is supported by this factory.


setFeature

public abstract void setFeature(String name,
                                boolean value)
                         throws XPathFactoryConfigurationException
Sets the state of the named feature.

Throws:
XPathFactoryConfigurationException

getFeature

public abstract boolean getFeature(String name)
                            throws XPathFactoryConfigurationException
Returns the state of the named feature.

Throws:
XPathFactoryConfigurationException

setXPathVariableResolver

public abstract void setXPathVariableResolver(XPathVariableResolver resolver)
Sets the XPath variable resolver calback.


setXPathFunctionResolver

public abstract void setXPathFunctionResolver(XPathFunctionResolver resolver)
Sets the XPath extension function resolver calback.


newXPath

public abstract XPath newXPath()
Returns a new XPath evaluation environment.