org.jdom
public final class Namespace extends 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: $Revision: 1.32 $, $Date: 2002/03/12 07:57:06 $
Field Summary | |
---|---|
static Namespace | NO_NAMESPACE Define a Namespace for when not in a namespace |
static Namespace | XML_NAMESPACE |
Method Summary | |
---|---|
boolean | equals(Object ob)
This tests for equality - Two |
static Namespace | getNamespace(String prefix, String uri)
This will retrieve (if in existence) or create (if not) a
|
static Namespace | getNamespace(String uri)
This will retrieve (if in existence) or create (if not) a
|
String | getPrefix()
This returns the prefix mapped to this |
String | getURI()
This returns the namespace URI for this |
int | hashCode()
This returns a probably unique hash code for the |
String | toString()
This returns a |
Namespace
for when not in a namespace
This tests for equality - Two Namespaces
are equal if and only if their URIs are byte-for-byte equals.
Parameters: ob Object
to compare to this Namespace
.
Returns: boolean
- whether the supplied object is equal to
this Namespace
.
This will retrieve (if in existence) or create (if not) a
Namespace
for the supplied prefix and URI.
Parameters: prefix String
prefix to map to
Namespace
. uri String
URI of new Namespace
.
Returns: Namespace
- ready to use namespace.
Throws: IllegalNameException if the given prefix and uri make up an illegal namespace name.
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.
Parameters: uri String
URI of new Namespace
.
Returns: Namespace
- ready to use namespace.
This returns the prefix mapped to this Namespace
.
Returns: String
- prefix for this Namespace
.
This returns the namespace URI for this Namespace
.
Returns: String
- URI for this Namespace
.
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.
Returns: int
- hash code for this Namespace
.
This returns a String
representation of this
Namespace
, suitable for use in debugging.
Returns: String
- information about this instance.