Package org.xmlunit.diff

Class XPathContext

java.lang.Object

org.xmlunit.diff.XPathContext

All Implemented Interfaces:

Cloneable

public class XPathContext
extends Object
implements Cloneable

Helper class that keeps track of the XPath of matched nodes during comparison.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	XPathContext.DOMNodeInfo	DOM based implementation of XPathContext.NodeInfo.
private static class	XPathContext.Level
static interface	XPathContext.NodeInfo	Representation of a node used by XPathContext.

Field Summary

Fields

Modifier and Type	Field	Description
private static final String	ATTR
private static final String	CLOSE
private static final String	COMMENT
private static final String	EMPTY
private static final String	OPEN
private Deque<XPathContext.Level>	path
private static final String	PI
private static final String	SEP
private static final String	TEXT
private final Map<String,String>	uri2Prefix

Constructor Summary

Constructors

Constructor	Description
XPathContext()	Starts with an empty context.
XPathContext(Map<String,String> prefix2uri)	Starts with an empty context and a given namespace mapping.
XPathContext(Map<String,String> prefix2uri, Node root)	Starts with the context of an optional root node and an optional namespace mapping.
XPathContext(Node root)	Starts with the context of a root node.

Method Summary

Modifier and Type	Method	Description
private static int	add1OrIncrement(String name, Map<String,Integer> map)	Increments the value name maps to or adds 1 as value if name isn't present inside the map.
void	addAttribute(QName attribute)	Adds knowledge about a single attribute of the current node.
void	addAttributes(Iterable<? extends QName> attributes)	Adds knowledge about the current node's attributes.
void	appendChildren(Iterable<? extends XPathContext.NodeInfo> children)	Adds knowledge about the current node's children appending to the knowledge already present.
XPathContext	clone()	Creates a deep copy of this XPathContext.
private String	getName(QName name)
String	getParentXPath()	Stringifies the XPath of the current node's parent.
String	getXPath()	Stringifies the XPath of the current node.
private String	getXPath(Iterator<XPathContext.Level> dIterator)
private static Map<String,String>	invert(Map<String,String> m)
void	navigateToAttribute(QName attribute)	Moves from the current node to the given attribute.
void	navigateToChild(int index)	Moves from the current node to the given child node.
void	navigateToParent()	Moves back to the parent.
void	setChildren(Iterable<? extends XPathContext.NodeInfo> children)	Adds knowledge about the current node's children replacing existing knowledge.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

path

private Deque<XPathContext.Level> path

uri2Prefix

private final Map<String,String> uri2Prefix

COMMENT

private static final String COMMENT

See Also:

• Constant Field Values

PI

private static final String PI

See Also:

• Constant Field Values

TEXT

private static final String TEXT

See Also:

• Constant Field Values

OPEN

private static final String OPEN

See Also:

• Constant Field Values

CLOSE

private static final String CLOSE

See Also:

• Constant Field Values

SEP

private static final String SEP

See Also:

• Constant Field Values

ATTR

private static final String ATTR

See Also:

• Constant Field Values

EMPTY

private static final String EMPTY

See Also:

• Constant Field Values

Constructor Details

XPathContext

public XPathContext()

Starts with an empty context.

XPathContext

public XPathContext(Node root)

Starts with the context of a root node.

XPathContext

public XPathContext(Map<String,String> prefix2uri)

Starts with an empty context and a given namespace mapping.

Parameters:

prefix2uri - maps from prefix to namespace URI.

XPathContext

public XPathContext(Map<String,String> prefix2uri,
 Node root)

Starts with the context of an optional root node and an optional namespace mapping.

Parameters:

prefix2uri - maps from prefix to namespace URI.

root - optional root node that determines the initial XPath

Method Details

navigateToChild

public void navigateToChild(int index)

Moves from the current node to the given child node.

navigateToAttribute

public void navigateToAttribute(QName attribute)

Moves from the current node to the given attribute.

navigateToParent

public void navigateToParent()

Moves back to the parent.

addAttributes

public void addAttributes(Iterable<? extends QName> attributes)

Adds knowledge about the current node's attributes.

addAttribute

public void addAttribute(QName attribute)

Adds knowledge about a single attribute of the current node.

setChildren

public void setChildren(Iterable<? extends XPathContext.NodeInfo> children)

Adds knowledge about the current node's children replacing existing knowledge.

appendChildren

public void appendChildren(Iterable<? extends XPathContext.NodeInfo> children)

Adds knowledge about the current node's children appending to the knowledge already present.

getXPath

public String getXPath()

Stringifies the XPath of the current node.

getParentXPath

public String getParentXPath()

Stringifies the XPath of the current node's parent.

clone

public XPathContext clone()

Creates a deep copy of this XPathContext.

Overrides:

clone in class Object

getXPath

private String getXPath(Iterator<XPathContext.Level> dIterator)

getName

private String getName(QName name)

add1OrIncrement

private static int add1OrIncrement(String name,
 Map<String,Integer> map)

Increments the value name maps to or adds 1 as value if name isn't present inside the map.

Returns:

the new mapping for name

invert

private static Map<String,String> invert(Map<String,String> m)