net.sf.saxon.pattern

Class NodeTestPattern

java.lang.Object

net.sf.saxon.expr.Expression

net.sf.saxon.expr.PseudoExpression

net.sf.saxon.pattern.Pattern

net.sf.saxon.pattern.NodeTestPattern

All Implemented Interfaces:

ExportAgent, Locatable, IdentityComparable

public class NodeTestPattern
extends Pattern

A NodeTestPattern is a pattern that consists simply of a NodeTest

Author:

Michael H. Kay

Field Summary

Fields inherited from class net.sf.saxon.expr.Expression

EFFECTIVE_BOOLEAN_VALUE, EVALUATE_METHOD, ITEM_FEED_METHOD, ITERATE_METHOD, MAX_COST, MAX_SEQUENCE_LENGTH, MAX_STRING_LENGTH, PROCESS_METHOD, staticProperties, UNBOUNDED_LOWER, UNBOUNDED_UPPER, UPDATE_METHOD, WATCH_METHOD

Constructor Summary

Constructors

Constructor and Description
NodeTestPattern(NodeTest test) Create an NodeTestPattern that matches all items of a given type

Method Summary

Modifier and Type	Method and Description
int	computeHashCode() Hashcode supporting equals()
Pattern	convertToTypedPattern(java.lang.String val) Convert the pattern to a typed pattern, in which an element name is treated as schema-element(N)
Pattern	copy(RebindingMap rebindings) Copy a pattern.
boolean	equals(java.lang.Object other) Determine whether this pattern is the same as another pattern
void	export(ExpressionPresenter presenter) Diagnostic print of expression structure.
int	getFingerprint() Determine the name fingerprint of nodes to which this pattern applies.
NodeTest	getItemType() Get a NodeTest that all the nodes matching this pattern must satisfy
NodeTest	getNodeTest()
UType	getUType() Get a UType indicating which kinds of items this Pattern can match.
boolean	matches(Item<?> item, XPathContext context) Determine whether this Pattern matches the given Node.
java.lang.String	toShortString() Produce a short string identifying the expression for use in error messages
java.lang.String	toString() Display the pattern for diagnostics

Methods inherited from class net.sf.saxon.pattern.Pattern

allocateSlots, bindCurrent, effectiveBooleanValue, getDefaultPriority, getDependencies, getHostLanguage, handleDynamicError, isLiftable, isMotionless, isRecoverable, make, matchesBeneathAnchor, matchesCurrentGroup, optimize, patternContainsVariable, replaceCurrent, selectNodes, setOriginalText, setPriority, setRecoverable, simplify, typeCheck

Methods inherited from class net.sf.saxon.expr.PseudoExpression

computeCardinality, evaluateAsString, evaluateItem, getImplementationMethod, iterate, process

Methods inherited from class net.sf.saxon.expr.Expression

addToPathMap, adoptChildExpression, allowExtractingCommonSubexpressions, checkedOperands, checkForUpdatingSubexpressions, checkPermittedContents, computeDependencies, computeSpecialProperties, computeStaticProperties, dynamicError, evaluatePendingUpdates, explain, getCardinality, getConfiguration, getConstructType, getCost, getEvaluationMethod, getExpressionName, getExtraProperty, getIntegerBounds, getInterpretedExpression, getIntrinsicDependencies, getLocalRetainedStaticContext, getLocation, getNetCost, getObjectName, getPackageData, getParentExpression, getProperties, getProperty, getRetainedStaticContext, getScopingExpression, getSlotsUsed, getSpecialProperties, getStaticBaseURI, getStaticBaseURIString, getStaticType, getStaticUType, getStreamerName, hasCompatibleStaticContext, hashCode, hasSpecialProperty, hasVariableBinding, identityHashCode, implementsStaticTypeCheck, isCallOn, isEqual, isIdentical, isInstruction, isMultiThreaded, isStaticPropertiesKnown, isSubtreeExpression, isUpdatingExpression, isVacuousExpression, markTailFunctionCalls, operandList, operands, operandSparseList, optimizeChildren, prepareForStreaming, resetLocalStaticProperties, restoreParentPointers, setEvaluationMethod, setExtraProperty, setFiltered, setFlattened, setLocation, setParentExpression, setRetainedStaticContext, setRetainedStaticContextLocally, setRetainedStaticContextThoroughly, setStaticProperty, simplifyChildren, staticTypeCheck, suppressValidation, toPattern, typeCheckChildren, typeError, unordered, verifyParentPointers

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

NodeTestPattern

public NodeTestPattern(NodeTest test)

Create an NodeTestPattern that matches all items of a given type

Parameters:

test - the type that the items must satisfy for the pattern to match

Method Detail

matches

public boolean matches(Item<?> item,
                       XPathContext context)

Determine whether this Pattern matches the given Node. This is the main external interface for matching patterns: it sets current() to the node being tested

Specified by:

matches in class Pattern

Parameters:

item - The item to be tested against the Pattern

context - The context in which the match is to take place.

Returns:

true if the item matches the Pattern, false otherwise

getItemType

public NodeTest getItemType()

Get a NodeTest that all the nodes matching this pattern must satisfy

Specified by:

getItemType in class Pattern

Returns:

an ItemType, as specific as possible, which all the matching items satisfy

getUType

public UType getUType()

Get a UType indicating which kinds of items this Pattern can match.

Specified by:

getUType in class Pattern

Returns:

a UType indicating all the primitive types of item that the pattern can match.

getFingerprint

public int getFingerprint()

Determine the name fingerprint of nodes to which this pattern applies. Used for optimisation.

Overrides:

getFingerprint in class Pattern

Returns:

A fingerprint that the nodes must match, or -1 if it can match multiple fingerprints

toString

public java.lang.String toString()

Display the pattern for diagnostics

Overrides:

toString in class Pattern

Returns:

a representation of the expression as a string

toShortString

public java.lang.String toShortString()

Description copied from class: Expression

Produce a short string identifying the expression for use in error messages

Overrides:

toShortString in class Pattern

Returns:

a short string, sufficient to identify the expression

equals

public boolean equals(java.lang.Object other)

Determine whether this pattern is the same as another pattern

Overrides:

equals in class Expression

Parameters:

other - the other object

Returns:

true if the other operand is an expression and if it can be determined that the two expressions are equivalent, in the sense that they will always return the same result.

computeHashCode

public int computeHashCode()

Hashcode supporting equals()

Overrides:

computeHashCode in class Expression

Returns:

a computed hash code

convertToTypedPattern

public Pattern convertToTypedPattern(java.lang.String val)
                              throws XPathException

Convert the pattern to a typed pattern, in which an element name is treated as schema-element(N)

Overrides:

convertToTypedPattern in class Pattern

Parameters:

val - either "strict" or "lax" depending on the value of xsl:mode/@typed

Returns:

either the original pattern unchanged, or a new pattern as the result of the conversion

Throws:

XPathException - if the pattern cannot be converted

export

public void export(ExpressionPresenter presenter)
            throws XPathException

Description copied from class: Expression

Diagnostic print of expression structure. The abstract expression tree is written to the supplied output destination.

Specified by:

export in interface ExportAgent

Specified by:

export in class Pattern

Parameters:

presenter - the expression presenter used to display the structure

Throws:

XPathException - if the export fails, for example if an expression is found that won't work in the target environment.

copy

public Pattern copy(RebindingMap rebindings)

Copy a pattern. This makes a deep copy.

Specified by:

copy in class Pattern

Parameters:

rebindings - variables that need to be re-bound

Returns:

the copy of the original pattern

getNodeTest

public NodeTest getNodeTest()