net.sf.mmm.util.xml.impl.stax

Interface XPointerStreamBuilder

public interface XPointerStreamBuilder

This is the interface used to create an XMLStreamReader facade that adapts a given XMLStreamReader only selecting the contents identified by a given XPointer expression.

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

Method Summary

Modifier and Type	Method and Description
XMLStreamReader	createStreamReader(XMLStreamReader xmlReader, String xpointerExpression, NamespaceContext namespaceContext) This method creates a XMLStreamReader facade that adapts the given xmlReader so only the contents pointed by the given xpointerExpression are visible.

Method Detail

createStreamReader

XMLStreamReader createStreamReader(XMLStreamReader xmlReader,
                                   String xpointerExpression,
                                   NamespaceContext namespaceContext)
                            throws XmlException

This method creates a XMLStreamReader facade that adapts the given xmlReader so only the contents pointed by the given xpointerExpression are visible.

Parameters:

xmlReader - is the original reader to adapt.

xpointerExpression - is the XPointer expression.

namespaceContext - is the namespace-context to inherit from when parsing the XPointer expression.

Returns:

the requested XMLStreamReader facade.

Throws:

XmlException - if the given xpointerExpression is illegal or NOT supported.