nu.xom
public final class Namespace extends Node
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.)
Version: 1.1b3
Field Summary | |
---|---|
static String | XML_NAMESPACE
Namespace URI specified for xml prefix |
Constructor Summary | |
---|---|
Namespace(String prefix, String URI, Element parent) Create a new namespace node. |
Method Summary | |
---|---|
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 |
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
|
String | toXML() Returns a string containing the actual XML form of the namespace declaration represented by this object. |
xml
prefixCreate a new namespace node.
Parameters: prefix the prefix for the namespace; may be the empty string or a non-colonized name URI the namespace URI parent the element that possesses this namespace node
Throws: MalformedURIException if URI
is
not an RFC 3986 URI reference IllegalNameException if
NamespaceConflictException if
xmlns
.
xml
, and the URI is not
http://www.w3.org/XML/1998/namespace
.xml
, and the URI is
http://www.w3.org/XML/1998/namespace
.
Returns a copy of this namespace which has the same prefix and URI, but no parent.
Returns: a copy of this Namespace
that is not part of a document
Removes this namespace node from its parent.
See Also: detach
Throws IndexOutOfBoundsException
because
namespaces do not have children.
Parameters: position the index of the child node to return
Returns: never returns because document type declarations do not have children. Always throws an exception.
Throws: IndexOutOfBoundsException because document type declarations do not have children
Returns 0 because namespaces do not have children.
Returns: zero
Returns the namespace prefix, or the empty string if this node is the default namespace.
Returns: the namespace prefix
Returns the namespace URI.
Returns: the namespace URI
Returns a string form of the
Namespace
suitable for debugging
and diagnosis. It deliberately does not return
an actual XML namespace declaration.
Returns: a string representation of this object
Returns a string containing the actual XML
form of the namespace declaration represented
by this object. For example,
xmlns:pre="http://www.example.org/"
.
Returns: a String
containing
an XML namespace declaration