nu.xom
Class Namespace
public final class Namespace
Represents a namespace in scope. It is used by XOM's
XPath implementation for the namespace axis. However, it is not
really part of the XOM data model. Namespace objects are only
created as needed when evaluating XPath. While a namespace node has
a parent element (which may be null), that element does not know
about these namespace nodes and cannot remove them. (This is an
inconsistency in the XPath data model, and is shared with attributes
which also have parents but are not children.)
static String | XML_NAMESPACE - Namespace URI specified for
xml prefix
|
Namespace(String prefix, String URI, Element parent) -
Create a new namespace node.
|
Node | copy() -
Returns a copy of this namespace which has
the same prefix and URI, but no parent.
|
void | detach() -
Removes this namespace node from its parent.
|
Node | getChild(int position) -
Throws
IndexOutOfBoundsException because
namespaces do not have children.
|
int | getChildCount() -
Returns 0 because namespaces do not have
children.
|
String | getPrefix() -
Returns the namespace prefix, or the empty string if this node
is the default namespace.
|
String | getValue() -
Returns the namespace URI.
|
String | toString() -
Returns a string form of the
Namespace suitable for debugging
and diagnosis.
|
String | toXML() -
Returns a string containing the actual XML
form of the namespace declaration represented
by this object.
|
copy , detach , equals , getBaseURI , getChild , getChildCount , getDocument , getParent , getValue , hashCode , query , query , toXML |
XML_NAMESPACE
public static final String XML_NAMESPACE
Namespace URI specified for xml
prefix
Namespace
public Namespace(String prefix,
String URI,
Element parent)
Create a new namespace node.
prefix
- the prefix for the namespace; may be the empty
string or a non-colonized nameURI
- the namespace URIparent
- the element that possesses this namespace node
copy
public Node copy()
Returns a copy of this namespace which has
the same prefix and URI, but no parent.
- copy in interface Node
- a copy of this
Namespace
that is not part of a document
detach
public void detach()
Removes this namespace node from its parent.
- detach in interface Node
getChild
public Node getChild(int position)
Throws IndexOutOfBoundsException
because
namespaces do not have children.
- getChild in interface Node
position
- the index of the child node to return
- never returns because document type declarations do not
have children. Always throws an exception.
getChildCount
public int getChildCount()
Returns 0 because namespaces do not have
children.
- getChildCount in interface Node
getPrefix
public String getPrefix()
Returns the namespace prefix, or the empty string if this node
is the default namespace.
getValue
public String getValue()
Returns the namespace URI.
- getValue in interface Node
toString
public String toString()
Returns a string form of the
Namespace
suitable for debugging
and diagnosis. It deliberately does not return
an actual XML namespace declaration.
- a string representation of this object
toXML
public String toXML()
Returns a string containing the actual XML
form of the namespace declaration represented
by this object. For example,
xmlns:pre="http://www.example.org/"
.
- toXML in interface Node
- a
String
containing
an XML namespace declaration
Copyright 2002-2005 Elliotte Rusty Harold
elharo@metalab.unc.edu