org.jdom2.xpath.util

类 AbstractXPathCompiled<T>

java.lang.Object

org.jdom2.xpath.util.AbstractXPathCompiled<T>

类型参数:

T - The generic type of the returned values.

所有已实现的接口:

java.lang.Cloneable, XPathExpression<T>

public abstract class AbstractXPathCompiled<T>
extends java.lang.Object
implements XPathExpression<T>

A mostly-implemented XPathExpression that only needs two methods to be implemented in order to satisfy the complete API. Subclasses of this MUST correctly override the clone() method which in turn should call super.clone();

作者:

Rolf Lear

构造器概要

构造器

构造器和说明
AbstractXPathCompiled(java.lang.String query, Filter<T> filter, java.util.Map<java.lang.String,java.lang.Object> variables, Namespace[] namespaces) Construct an XPathExpression.

方法概要

限定符和类型	方法和说明
XPathExpression<T>	clone() Subclasses of this AbstractXPathCompile class must call super.clone() in their clone methods!
XPathDiagnostic<T>	diagnose(java.lang.Object context, boolean firstonly) Evaluate the XPath query against the supplied context, but return additional data which may be useful for diagnosing problems with XPath queries.
java.util.List<T>	evaluate(java.lang.Object context) Process the compiled XPathExpression against the specified context.
T	evaluateFirst(java.lang.Object context) Return the first value in the XPath query result set type-cast to the return type of this XPathExpression.
java.lang.String	getExpression() Get the XPath expression
Filter<T>	getFilter() Get the Filter<T> used to coerce the raw XPath results in to the correct Generic type.
Namespace	getNamespace(java.lang.String prefix) Get the Namespace associated with a given prefix.
Namespace[]	getNamespaces() Get the Namespaces that were used to compile this XPathExpression.
java.lang.Object	getVariable(java.lang.String qname) Get the variable value associated to the given variable qname.
java.lang.Object	getVariable(java.lang.String name, Namespace uri) Get the variable value associated to the given variable name.
java.lang.Object	setVariable(java.lang.String name, Namespace uri, java.lang.Object value) Change the defined value for a variable to some new value.
java.lang.Object	setVariable(java.lang.String qname, java.lang.Object value) Change the defined value for a variable to some new value.
java.lang.String	toString()

从类继承的方法 java.lang.Object

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

构造器详细资料

AbstractXPathCompiled

public AbstractXPathCompiled(java.lang.String query,
                             Filter<T> filter,
                             java.util.Map<java.lang.String,java.lang.Object> variables,
                             Namespace[] namespaces)

Construct an XPathExpression.

参数:

query - The XPath query

filter - The coercion filter.

variables - A map of variables.

namespaces - The namespaces referenced from the query.

另请参阅:

for conditions which throw {@link NullPointerException} or {@link IllegalArgumentException}.

方法详细资料

clone

public XPathExpression<T> clone()

Subclasses of this AbstractXPathCompile class must call super.clone() in their clone methods!

This would be a sample clone method from a subclass:

                public XPathExpression<T> clone() {
                         @SuppressWarnings("unchecked")
                        final MyXPathCompiled<T> ret = (MyXPathCompiled<T>)super.clone();
                        // change any fields that need to be cloned.
                        ....
                        return ret;
                }
 

Here's the documentation from XPathExpression.clone() Create a new instance of this XPathExpression that duplicates this instance.

The 'cloned' instance will have the same XPath query, namespace declarations, and variables. Changing a value associated with a variable on the cloned instance will not change this instance's values, and it is safe to run the evaluate methods on the cloned copy at the same time as this copy.

指定者:

clone 在接口中 XPathExpression<T>

覆盖:

clone 在类中 java.lang.Object

返回:

a new XPathExpression instance that shares the same core details as this.

getExpression

public final java.lang.String getExpression()

从接口复制的说明: XPathExpression

Get the XPath expression

指定者:

getExpression 在接口中 XPathExpression<T>

返回:

the string representation of the XPath expression

getNamespace

public final Namespace getNamespace(java.lang.String prefix)

从接口复制的说明: XPathExpression

Get the Namespace associated with a given prefix.

指定者:

getNamespace 在接口中 XPathExpression<T>

参数:

prefix - The prefix to select the Namespace URI for.

返回:

the URI of the specified Namespace prefix

getNamespaces

public Namespace[] getNamespaces()

从接口复制的说明: XPathExpression

Get the Namespaces that were used to compile this XPathExpression.

指定者:

getNamespaces 在接口中 XPathExpression<T>

返回:

a potentially empty array of Namespaces (never null).

getVariable

public final java.lang.Object getVariable(java.lang.String name,
                                          Namespace uri)

从接口复制的说明: XPathExpression

Get the variable value associated to the given variable name.

指定者:

getVariable 在接口中 XPathExpression<T>

参数:

name - the variable localname to retrieve the value for.

uri - the Namespace in which the variable name was declared.

返回:

the value associated to a Variable name.

getVariable

public java.lang.Object getVariable(java.lang.String qname)

从接口复制的说明: XPathExpression

Get the variable value associated to the given variable qname.

qname must consist of an optional namespace prefix and colon, followed by a mandatory variable localname. If the prefix is not specified, then the Namespace is assumed to be the Namespace.NO_NAMESPACE. If the prefix is specified, it must match with one of the declared Namespaces for this XPathExpression

指定者:

getVariable 在接口中 XPathExpression<T>

参数:

qname - the variable qname to retrieve the value for.

返回:

the value associated to a Variable name.

setVariable

public java.lang.Object setVariable(java.lang.String name,
                                    Namespace uri,
                                    java.lang.Object value)

从接口复制的说明: XPathExpression

Change the defined value for a variable to some new value. You may not use this method to add new variables to the compiled XPath, you can only change existing variable values.

The value of the variable may be null. Some XPath libraries support a null value, and if the library that this expression is for does not support a null value it should be translated to something meaningful for that library, typically the empty string.

指定者:

setVariable 在接口中 XPathExpression<T>

参数:

name - The variable localname to change.

uri - the Namespace in which the variable name is declared.

value - The new value to set.

返回:

The value of the variable prior to this change.

setVariable

public java.lang.Object setVariable(java.lang.String qname,
                                    java.lang.Object value)

从接口复制的说明: XPathExpression

Change the defined value for a variable to some new value. You may not use this method to add new variables to the compiled XPath, you can only change existing variable values.

The value of the variable may be null. Some XPath libraries support a null value, and if the library that this expression is for does not support a null value it should be translated to something meaningful for that library, typically the empty string.

qname must consist of an optional namespace prefix and colon, followed by a mandatory variable localname. If the prefix is not specified, then the Namespace is assumed to be the Namespace.NO_NAMESPACE. If the prefix is specified, it must match with one of the declared Namespaces for this XPathExpression

指定者:

setVariable 在接口中 XPathExpression<T>

参数:

qname - The variable qname to change.

value - The new value to set.

返回:

The value of the variable prior to this change.

getFilter

public final Filter<T> getFilter()

从接口复制的说明: XPathExpression

Get the Filter<T> used to coerce the raw XPath results in to the correct Generic type.

指定者:

getFilter 在接口中 XPathExpression<T>

返回:

the Filter<T> used to coerce the raw XPath results in to the correct Generic type.

evaluate

public java.util.List<T> evaluate(java.lang.Object context)

从接口复制的说明: XPathExpression

Process the compiled XPathExpression against the specified context.

In the JDOM2 XPath API the results of the raw XPath query are processed by the attached Filter<T> instance to coerce the results in to the correct generic type for this XPathExpression. The Filter process may cause some XPath results to be removed from the final results. You may instead want to call the XPathExpression.diagnose(Object, boolean) method to have access to both the raw XPath results as well as the filtered and generically typed results.

指定者:

evaluate 在接口中 XPathExpression<T>

参数:

context - The context against which to process the query.

返回:

a list of the XPath results.

evaluateFirst

public T evaluateFirst(java.lang.Object context)

从接口复制的说明: XPathExpression

Return the first value in the XPath query result set type-cast to the return type of this XPathExpression.

The concept of the 'first' result is applied before any JDOM Filter is applied. Thus, if the underlying XPath query has some results, the first result is sent through the filter. If it matches it is returned, if it does not match, then null is returned (even if some subsequent result underlying XPath result would pass the filter).

This allows the XPath implementation to optimise the evaluateFirst method by potentially using 'short-circuit' conditions in the evaluation.

指定者:

evaluateFirst 在接口中 XPathExpression<T>

参数:

context - The context against which to evaluate the expression. This will typically be a Document, Element, or some other JDOM object.

返回:

The first XPath result (if there is any) coerced to the generic type of this XPathExpression, or null if it cannot be coerced.

diagnose

public XPathDiagnostic<T> diagnose(java.lang.Object context,
                                   boolean firstonly)

从接口复制的说明: XPathExpression

Evaluate the XPath query against the supplied context, but return additional data which may be useful for diagnosing problems with XPath queries.

指定者:

diagnose 在接口中 XPathExpression<T>

参数:

context - The context against which to run the query.

firstonly - Indicate whether the XPath expression can be terminated after the first successful result value.

返回:

an XPathDiagnostic instance.

toString

public java.lang.String toString()

覆盖:

toString 在类中 java.lang.Object