org.jdom
Class Namespace
public final class Namespace
extends java.lang.Object
Namespace
defines both a factory for
creating XML namespaces, and a namespace itself. This class
represents an XML namespace in Java.
Elements and Attributes containing Namespaces
can be serialized;
however the Namespace class itself does not implement
java.io.Serializable
. This works because the Element and
Attribute classes handle serialization of their Namespaces manually.
The classes use the getNamespace() method on deserialization to ensure
there may be only one unique Namespace object for any unique
prefix/uri pair, something needed for efficiency reasons.
Version:
- Brett McLaughlin
- Elliotte Rusty Harold
- Wesley Biggs
boolean | equals(Object ob) -
This tests for equality - Two
Namespaces
are equal if and only if their URIs are byte-for-byte equals.
|
static Namespace | getNamespace(String uri) -
This will retrieve (if in existence) or create (if not) a
Namespace for the supplied URI, and make it usable
as a default namespace, as no prefix is supplied.
|
static Namespace | getNamespace(String prefix, String uri) -
This will retrieve (if in existence) or create (if not) a
Namespace for the supplied prefix and URI.
|
String | getPrefix() -
This returns the prefix mapped to this
Namespace .
|
String | getURI() -
This returns the namespace URI for this
Namespace .
|
int | hashCode() -
This returns a probably unique hash code for the
Namespace .
|
String | toString() -
This returns a
String representation of this
Namespace , suitable for use in debugging.
|
NO_NAMESPACE
public static final Namespace NO_NAMESPACE
Define a Namespace
for when not in a namespace
XML_NAMESPACE
public static final Namespace XML_NAMESPACE
equals
public boolean equals(Object ob)
This tests for equality - Two Namespaces
are equal if and only if their URIs are byte-for-byte equals.
ob
- Object
to compare to this Namespace
.
boolean
- whether the supplied object is equal to
this Namespace
.
getNamespace
public static Namespace getNamespace(String uri)
This will retrieve (if in existence) or create (if not) a
Namespace
for the supplied URI, and make it usable
as a default namespace, as no prefix is supplied.
uri
- String
URI of new Namespace
.
Namespace
- ready to use namespace.
getNamespace
public static Namespace getNamespace(String prefix,
String uri)
This will retrieve (if in existence) or create (if not) a
Namespace
for the supplied prefix and URI.
prefix
- String
prefix to map to
Namespace
.uri
- String
URI of new Namespace
.
Namespace
- ready to use namespace.
getPrefix
public String getPrefix()
This returns the prefix mapped to this Namespace
.
String
- prefix for this Namespace
.
getURI
public String getURI()
This returns the namespace URI for this Namespace
.
String
- URI for this Namespace
.
hashCode
public int hashCode()
This returns a probably unique hash code for the Namespace
.
If two namespaces have the same URI, they are equal and have the same
hash code, even if they have different prefixes.
int
- hash code for this Namespace
.
toString
public String toString()
This returns a String
representation of this
Namespace
, suitable for use in debugging.
String
- information about this instance.
Copyright B) 2002 Jason Hunter, Brett McLaughlin. All Rights Reserved.