net.sf.saxon.pattern

Class NodeTestPattern

java.lang.Object

net.sf.saxon.pattern.Pattern

net.sf.saxon.pattern.NodeTestPattern

All Implemented Interfaces:

SourceLocator, Container, PatternFinder

public class NodeTestPattern
extends Pattern

A NodeTestPattern is a pattern that consists simply of a NodeTest

Author:

Michael H. Kay

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
Pattern	convertToTypedPattern(String val) Convert the pattern to a typed pattern, in which an element name is treated as schema-element(N)
boolean	equals(Object other) Determine whether this pattern is the same as another pattern
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
int	getNodeKind() Determine the types of nodes to which this pattern applies.
int	getNodeKindMask() Get a mask indicating which kinds of nodes this NodeTest can match.
int	hashCode() Hashcode supporting equals()
boolean	matches(Item item, XPathContext context) Determine whether this Pattern matches the given Node.
String	toString() Display the pattern for diagnostics

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

allocateSlots, analyze, bindCurrent, getColumnNumber, getConfiguration, getContainerGranularity, getDefaultPriority, getDependencies, getHostLanguage, getLineNumber, getLocationProvider, getPackageData, getPublicId, getSystemId, isMotionless, iterateSubExpressions, make, matchesBeneathAnchor, promote, replaceCurrent, replaceSubExpression, selectNodes, setLineNumber, setOriginalText, setPackageData, setPriority, setSystemId, simplify

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 NodeInfo representing the Element or other node to be tested against the Pattern

context - The context in which the match is to take place. Only relevant if the pattern uses variables, or contains calls on functions such as document() or key(). Not used (and can be set to null) in the case of patterns that are NodeTests

Returns:

true if the node 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

getNodeKind

public int getNodeKind()

Determine the types of nodes to which this pattern applies. Used for optimisation. For patterns that match nodes of several types, return Type.NODE. For patterns that do not match nodes, return -1.

Overrides:

getNodeKind in class Pattern

Returns:

the type of node matched by this pattern. e.g. Type.ELEMENT or Type.TEXT

getNodeKindMask

public int getNodeKindMask()

Get a mask indicating which kinds of nodes this NodeTest can match. This is a combination of bits: 1<

Overrides:

getNodeKindMask in class Pattern

Returns:

a combination of bits: 1<

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 String toString()

Display the pattern for diagnostics

Overrides:

toString in class Pattern

equals

public boolean equals(Object other)

Determine whether this pattern is the same as another pattern

Overrides:

equals in class Object

Parameters:

other - the other object

hashCode

public int hashCode()

Hashcode supporting equals()

Overrides:

hashCode in class Object

convertToTypedPattern

public Pattern convertToTypedPattern(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