nu.xom

Class XPathContext

public final class XPathContext extends Object

Provides namespace prefix bindings for use in an XPath expression.

Version: 1.2b1

Author: Elliotte Rusty Harold

Constructor Summary
XPathContext(String prefix, String uri)

Creates a new XPath context that binds the specified prefix to the specified URI.

XPathContext()

Creates a new XPath context that binds the xml prefix to the URI http://www.w3.org/XML/1998/namespace.

Method Summary
voidaddNamespace(String prefix, String uri)

Binds the specified prefix to the specified namespace URI.

Stringlookup(String prefix)
static XPathContextmakeNamespaceContext(Element element)

Creates a new XPath context that contains all the namespace bindings in scope on the element.

Constructor Detail

XPathContext

public XPathContext(String prefix, String uri)

Creates a new XPath context that binds the specified prefix to the specified URI. The xml prefix is also bound to the URI http://www.w3.org/XML/1998/namespace.

Parameters: prefix the prefix to bind uri the namespace URI the prefix is bound to

XPathContext

public XPathContext()

Creates a new XPath context that binds the xml prefix to the URI http://www.w3.org/XML/1998/namespace.

Method Detail

addNamespace

public void addNamespace(String prefix, String uri)

Binds the specified prefix to the specified namespace URI. If the prefix is already bound in this context, the new URI replaces the old URI. Binding a prefix to null removes the declaration. The binding of the xml prefix may not be changed.

Parameters: prefix the prefix to bind uri the namespace URI the prefix is bound to

Throws: NamespaceConflictException if the prefix is xml and the URI is not http://www.w3.org/XML/1998/namespace or the prefix is the empty string NullPointerException if the prefix is null

lookup

public String lookup(String prefix)

makeNamespaceContext

public static XPathContext makeNamespaceContext(Element element)

Creates a new XPath context that contains all the namespace bindings in scope on the element. Changing the prefixes in scope on the element after the context is returned does not change the context.

Parameters: element the element whose namespace bindings are copied

Returns: all the namespace prefix mappings in scope on the element

Copyright 2002-2006 Elliotte Rusty Harold
elharo@metalab.unc.edu