<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.6.0_18) on Sun Jun 12 19:55:30 JST 2011 -->
<TITLE>
XPathFactory (JAXP 1.4, DOM3, SAX2.0.2(sax2r3), StAX 1.0, SAC 1.3)
</TITLE>
<META NAME="date" CONTENT="2011-06-12">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="XPathFactory (JAXP 1.4, DOM3, SAX2.0.2(sax2r3), StAX 1.0, SAC 1.3)";
}
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<HR>
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/xpath/XPathExpressionException.html" title="class in javax.xml.xpath"><B>PREV CLASS</B></A>
<A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?javax/xml/xpath/XPathFactory.html" target="_top"><B>FRAMES</B></A>
<A HREF="XPathFactory.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
javax.xml.xpath</FONT>
<BR>
Class XPathFactory</H2>
<PRE>
java.lang.Object
<IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>javax.xml.xpath.XPathFactory</B>
</PRE>
<HR>
<DL>
<DT><PRE>public abstract class <B>XPathFactory</B><DT>extends java.lang.Object</DL>
</PRE>
<P>
<p>An <code>XPathFactory</code> instance can be used to create
<A HREF="../../../javax/xml/xpath/XPath.html" title="interface in javax.xml.xpath"><CODE>XPath</CODE></A> objects.</p>
<p>See <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String)"><CODE>newInstance(String uri)</CODE></A> for lookup mechanism.</p>
<P>
<P>
<DL>
<DT><B>Since:</B></DT>
<DD>1.5</DD>
<DT><B>Version:</B></DT>
<DD>$Revision: 888889 $, $Date: 2009-12-09 19:43:18 +0200 (Wed, 09 Dec 2009) $</DD>
<DT><B>Author:</B></DT>
<DD><a href="mailto:Norman.Walsh@Sun.com">Norman Walsh</a>, <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a></DD>
</DL>
<HR>
<P>
<!-- =========== FIELD SUMMARY =========== -->
<A NAME="field_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Field Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_OBJECT_MODEL_URI">DEFAULT_OBJECT_MODEL_URI</A></B></CODE>
<BR>
Default Object Model URI.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_PROPERTY_NAME">DEFAULT_PROPERTY_NAME</A></B></CODE>
<BR>
The default property name according to the JAXP spec.</TD>
</TR>
</TABLE>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<A NAME="constructor_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Constructor Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>protected </CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#XPathFactory()">XPathFactory</A></B>()</CODE>
<BR>
Protected constructor as <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance()"><CODE>newInstance()</CODE></A>, <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String)"><CODE>newInstance(String uri)</CODE></A>
or <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String, java.lang.String, java.lang.ClassLoader)"><CODE>newInstance(String uri, String factoryClassName, ClassLoader classLoader)</CODE></A>
should be used to create a new instance of an <code>XPathFactory</code>.</TD>
</TR>
</TABLE>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>Method Summary</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#getFeature(java.lang.String)">getFeature</A></B>(java.lang.String name)</CODE>
<BR>
Get the state of the named feature.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#isObjectModelSupported(java.lang.String)">isObjectModelSupported</A></B>(java.lang.String objectModel)</CODE>
<BR>
Is specified object model supported by this <code>XPathFactory</code>?</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance()">newInstance</A></B>()</CODE>
<BR>
Get a new <code>XPathFactory</code> instance using the default object model,
<A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_OBJECT_MODEL_URI"><CODE>DEFAULT_OBJECT_MODEL_URI</CODE></A>,
the W3C DOM.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String)">newInstance</A></B>(java.lang.String uri)</CODE>
<BR>
Get a new <code>XPathFactory</code> instance using the specified object model.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String, java.lang.String, java.lang.ClassLoader)">newInstance</A></B>(java.lang.String uri,
java.lang.String factoryClassName,
java.lang.ClassLoader classLoader)</CODE>
<BR>
</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract <A HREF="../../../javax/xml/xpath/XPath.html" title="interface in javax.xml.xpath">XPath</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#newXPath()">newXPath</A></B>()</CODE>
<BR>
Return a new <code>XPath</code> using the underlying object
model determined when the <code>XPathFactory</code> was instantiated.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#setFeature(java.lang.String, boolean)">setFeature</A></B>(java.lang.String name,
boolean value)</CODE>
<BR>
Set a feature for this <code>XPathFactory</code> and <code>XPath</code>s created by this factory.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#setXPathFunctionResolver(javax.xml.xpath.XPathFunctionResolver)">setXPathFunctionResolver</A></B>(<A HREF="../../../javax/xml/xpath/XPathFunctionResolver.html" title="interface in javax.xml.xpath">XPathFunctionResolver</A> resolver)</CODE>
<BR>
Establish a default function resolver.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>abstract void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/xml/xpath/XPathFactory.html#setXPathVariableResolver(javax.xml.xpath.XPathVariableResolver)">setXPathVariableResolver</A></B>(<A HREF="../../../javax/xml/xpath/XPathVariableResolver.html" title="interface in javax.xml.xpath">XPathVariableResolver</A> resolver)</CODE>
<BR>
Establish a default variable resolver.</TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
<P>
<!-- ============ FIELD DETAIL =========== -->
<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Field Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="DEFAULT_PROPERTY_NAME"><!-- --></A><H3>
DEFAULT_PROPERTY_NAME</H3>
<PRE>
public static final java.lang.String <B>DEFAULT_PROPERTY_NAME</B></PRE>
<DL>
<DD><p>The default property name according to the JAXP spec.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.xml.xpath.XPathFactory.DEFAULT_PROPERTY_NAME">Constant Field Values</A></DL>
</DL>
<HR>
<A NAME="DEFAULT_OBJECT_MODEL_URI"><!-- --></A><H3>
DEFAULT_OBJECT_MODEL_URI</H3>
<PRE>
public static final java.lang.String <B>DEFAULT_OBJECT_MODEL_URI</B></PRE>
<DL>
<DD><p>Default Object Model URI.</p>
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.xml.xpath.XPathFactory.DEFAULT_OBJECT_MODEL_URI">Constant Field Values</A></DL>
</DL>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="XPathFactory()"><!-- --></A><H3>
XPathFactory</H3>
<PRE>
protected <B>XPathFactory</B>()</PRE>
<DL>
<DD><p>Protected constructor as <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance()"><CODE>newInstance()</CODE></A>, <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String)"><CODE>newInstance(String uri)</CODE></A>
or <A HREF="../../../javax/xml/xpath/XPathFactory.html#newInstance(java.lang.String, java.lang.String, java.lang.ClassLoader)"><CODE>newInstance(String uri, String factoryClassName, ClassLoader classLoader)</CODE></A>
should be used to create a new instance of an <code>XPathFactory</code>.</p>
<P>
</DL>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>
<A NAME="newInstance()"><!-- --></A><H3>
newInstance</H3>
<PRE>
public static final <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A> <B>newInstance</B>()</PRE>
<DL>
<DD><p>Get a new <code>XPathFactory</code> instance using the default object model,
<A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_OBJECT_MODEL_URI"><CODE>DEFAULT_OBJECT_MODEL_URI</CODE></A>,
the W3C DOM.</p>
<p>This method is functionally equivalent to:</p>
<pre>
newInstance(DEFAULT_OBJECT_MODEL_URI)
</pre>
<p>Since the implementation for the W3C DOM is always available, this method will never fail.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>Instance of an <code>XPathFactory</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="newInstance(java.lang.String)"><!-- --></A><H3>
newInstance</H3>
<PRE>
public static final <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A> <B>newInstance</B>(java.lang.String uri)
throws <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></PRE>
<DL>
<DD><p>Get a new <code>XPathFactory</code> instance using the specified object model.</p>
<p>To find a <code>XPathFactory</code> object,
this method looks the following places in the following order where "the class loader" refers to the context class loader:</p>
<ol>
<li>
If the system property <A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_PROPERTY_NAME"><CODE>DEFAULT_PROPERTY_NAME</CODE></A> + ":uri" is present,
where uri is the parameter to this method, then its value is read as a class name.
The method will try to create a new instance of this class by using the class loader,
and returns it if it is successfully created.
</li>
<li>
${java.home}/lib/jaxp.properties is read and the value associated with the key being the system property above is looked for.
If present, the value is processed just like above.
</li>
<li>
The class loader is asked for service provider provider-configuration files matching <code>javax.xml.xpath.XPathFactory</code>
in the resource directory META-INF/services.
See the JAR File Specification for file format and parsing rules.
Each potential service provider is required to implement the method:
<pre>
<A HREF="../../../javax/xml/xpath/XPathFactory.html#isObjectModelSupported(java.lang.String)"><CODE>isObjectModelSupported(String objectModel)</CODE></A>
</pre>
The first service provider found in class loader order that supports the specified object model is returned.
</li>
<li>
Platform default <code>XPathFactory</code> is located in a platform specific way.
There must be a platform default XPathFactory for the W3C DOM, i.e. <A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_OBJECT_MODEL_URI"><CODE>DEFAULT_OBJECT_MODEL_URI</CODE></A>.
</li>
</ol>
<p>If everything fails, an <code>XPathFactoryConfigurationException</code> will be thrown.</p>
<p>Tip for Trouble-shooting:</p>
<p>See <CODE>Properties.load(java.io.InputStream)</CODE> for exactly how a property file is parsed.
In particular, colons ':' need to be escaped in a property file, so make sure the URIs are properly escaped in it.
For example:</p>
<pre>
http\://java.sun.com/jaxp/xpath/dom=org.acme.DomXPathFactory
</pre>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>uri</CODE> - Identifies the underlying object model.
The specification only defines the URI <A HREF="../../../javax/xml/xpath/XPathFactory.html#DEFAULT_OBJECT_MODEL_URI"><CODE>DEFAULT_OBJECT_MODEL_URI</CODE></A>,
<code>http://java.sun.com/jaxp/xpath/dom</code> for the W3C DOM,
the org.w3c.dom package, and implementations are free to introduce other URIs for other object models.
<DT><B>Returns:</B><DD>Instance of an <code>XPathFactory</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></CODE> - If the specified object model is unavailable.
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>uri</code> is <code>null</code>.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If <code>uri.length() == 0</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="newInstance(java.lang.String, java.lang.String, java.lang.ClassLoader)"><!-- --></A><H3>
newInstance</H3>
<PRE>
public static <A HREF="../../../javax/xml/xpath/XPathFactory.html" title="class in javax.xml.xpath">XPathFactory</A> <B>newInstance</B>(java.lang.String uri,
java.lang.String factoryClassName,
java.lang.ClassLoader classLoader)
throws <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></PRE>
<DL>
<DD><DL>
<DT><B>Returns:</B><DD>Instance of an <code>XPathFactory</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></CODE> - If the specified object model is unavailable.
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>uri</code> is <code>null</code>.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If <code>uri.length() == 0</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="isObjectModelSupported(java.lang.String)"><!-- --></A><H3>
isObjectModelSupported</H3>
<PRE>
public abstract boolean <B>isObjectModelSupported</B>(java.lang.String objectModel)</PRE>
<DL>
<DD><p>Is specified object model supported by this <code>XPathFactory</code>?</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>objectModel</CODE> - Specifies the object model which the returned <code>XPathFactory</code> will understand.
<DT><B>Returns:</B><DD><code>true</code> if <code>XPathFactory</code> supports <code>objectModel</code>, else <code>false</code>.
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>objectModel</code> is <code>null</code>.
<DD><CODE>java.lang.IllegalArgumentException</CODE> - If <code>objectModel.length() == 0</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="setFeature(java.lang.String, boolean)"><!-- --></A><H3>
setFeature</H3>
<PRE>
public abstract void <B>setFeature</B>(java.lang.String name,
boolean value)
throws <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></PRE>
<DL>
<DD><p>Set a feature for this <code>XPathFactory</code> and <code>XPath</code>s created by this factory.</p>
<p>
Feature names are fully qualified <CODE>URI</CODE>s.
Implementations may define their own features.
An <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath"><CODE>XPathFactoryConfigurationException</CODE></A> is thrown if this <code>XPathFactory</code> or the <code>XPath</code>s
it creates cannot support the feature.
It is possible for an <code>XPathFactory</code> to expose a feature value but be unable to change its state.
</p>
<p>
All implementations are required to support the <A HREF="../../../javax/xml/XMLConstants.html#FEATURE_SECURE_PROCESSING"><CODE>XMLConstants.FEATURE_SECURE_PROCESSING</CODE></A> feature.
When the feature is <code>true</code>, any reference to an external function is an error.
Under these conditions, the implementation must not call the <A HREF="../../../javax/xml/xpath/XPathFunctionResolver.html" title="interface in javax.xml.xpath"><CODE>XPathFunctionResolver</CODE></A>
and must throw an <A HREF="../../../javax/xml/xpath/XPathFunctionException.html" title="class in javax.xml.xpath"><CODE>XPathFunctionException</CODE></A>.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - Feature name.<DD><CODE>value</CODE> - Is feature state <code>true</code> or <code>false</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></CODE> - if this <code>XPathFactory</code> or the <code>XPath</code>s
it creates cannot support this feature.
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>name</code> is <code>null</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="getFeature(java.lang.String)"><!-- --></A><H3>
getFeature</H3>
<PRE>
public abstract boolean <B>getFeature</B>(java.lang.String name)
throws <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></PRE>
<DL>
<DD><p>Get the state of the named feature.</p>
<p>
Feature names are fully qualified <CODE>URI</CODE>s.
Implementations may define their own features.
An <A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath"><CODE>XPathFactoryConfigurationException</CODE></A> is thrown if this <code>XPathFactory</code> or the <code>XPath</code>s
it creates cannot support the feature.
It is possible for an <code>XPathFactory</code> to expose a feature value but be unable to change its state.
</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - Feature name.
<DT><B>Returns:</B><DD>State of the named feature.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath">XPathFactoryConfigurationException</A></CODE> - if this <code>XPathFactory</code> or the <code>XPath</code>s
it creates cannot support this feature.
<DD><CODE>java.lang.NullPointerException</CODE> - if <code>name</code> is <code>null</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="setXPathVariableResolver(javax.xml.xpath.XPathVariableResolver)"><!-- --></A><H3>
setXPathVariableResolver</H3>
<PRE>
public abstract void <B>setXPathVariableResolver</B>(<A HREF="../../../javax/xml/xpath/XPathVariableResolver.html" title="interface in javax.xml.xpath">XPathVariableResolver</A> resolver)</PRE>
<DL>
<DD><p>Establish a default variable resolver.</p>
<p>Any <code>XPath</code> objects constructed from this factory will use
the specified resolver by default.</p>
<p>A <code>NullPointerException</code> is thrown if <code>resolver</code> is <code>null</code>.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resolver</CODE> - Variable resolver.
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>resolver</code> is <code>null</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="setXPathFunctionResolver(javax.xml.xpath.XPathFunctionResolver)"><!-- --></A><H3>
setXPathFunctionResolver</H3>
<PRE>
public abstract void <B>setXPathFunctionResolver</B>(<A HREF="../../../javax/xml/xpath/XPathFunctionResolver.html" title="interface in javax.xml.xpath">XPathFunctionResolver</A> resolver)</PRE>
<DL>
<DD><p>Establish a default function resolver.</p>
<p>Any <code>XPath</code> objects constructed from this factory will use
the specified resolver by default.</p>
<p>A <code>NullPointerException</code> is thrown if <code>resolver</code> is <code>null</code>.</p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resolver</CODE> - XPath function resolver.
<DT><B>Throws:</B>
<DD><CODE>java.lang.NullPointerException</CODE> - If <code>resolver</code> is <code>null</code>.</DL>
</DD>
</DL>
<HR>
<A NAME="newXPath()"><!-- --></A><H3>
newXPath</H3>
<PRE>
public abstract <A HREF="../../../javax/xml/xpath/XPath.html" title="interface in javax.xml.xpath">XPath</A> <B>newXPath</B>()</PRE>
<DL>
<DD><p>Return a new <code>XPath</code> using the underlying object
model determined when the <code>XPathFactory</code> was instantiated.</p>
<P>
<DD><DL>
<DT><B>Returns:</B><DD>New instance of an <code>XPath</code>.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../javax/xml/xpath/XPathExpressionException.html" title="class in javax.xml.xpath"><B>PREV CLASS</B></A>
<A HREF="../../../javax/xml/xpath/XPathFactoryConfigurationException.html" title="class in javax.xml.xpath"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?javax/xml/xpath/XPathFactory.html" target="_top"><B>FRAMES</B></A>
<A HREF="XPathFactory.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>
distrib
>
Momonga
>
development
>
i686
>
media
>
os
>
by-pkgid
>
8094ac79f986f14af880f5f612391693
>
files
>
390
