com.xmlmind.xml.xpointer

Interface SimpleXPointer

All Known Implementing Classes:

ElementXPointer, XPointerXPointer

public interface SimpleXPointer

Interface implemented by all simple xpointers.

Example: (compound) xpointer xpointer(id('boy-blue')/horn[1])element(boy-blue/3) corresponds to two simple xpointers xpointer(id('boy-blue')/horn[1]) and element(boy-blue/3).

Method Summary

Modifier and Type	Method and Description
Node[]	findNodes(Document document, Object context) Searches specified document and returns the range of nodes selected by this xpointer.

Method Detail

findNodes

Node[] findNodes(Document document,
                 Object context)
          throws XPointerException

Searches specified document and returns the range of nodes selected by this xpointer.

Parameters:

document - document to be searched

context - a context object (for example, cached data) which is specific to the scheme of this xpointer. May be null

An implementation cannot count on a context to be available.

Returns:

found range of sibling nodes or null

Throws:

XPointerException - if an error occurs during the search or if no nodes selected by this xpointer are found

Note that an implementation may choose to return null rather than raise an exception.