org.jdom

Class Namespace


public final class Namespace
extends java.lang.Object

An XML namespace representation, as well as a factory for creating XML namespace objects. Namespaces are not Serializable, however objects that use namespaces have special logic to handle serialization manually. These classes call the getNamespace() method on deserialization to ensure there is one unique Namespace object for any unique prefix/uri pair.

Version:
$Revision: 1.41 $, $Date: 2004/02/27 11:32:57 $

Authors:
Brett McLaughlin
Elliotte Rusty Harold
Jason Hunter
Wesley Biggs

Field Summary

static Namespace
NO_NAMESPACE
Define a Namespace for when not in a namespace
static Namespace
XML_NAMESPACE
Define a Namespace for the standard xml prefix.

Method Summary

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.

Field Details

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
Define a Namespace for the standard xml prefix.

Method Details

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.

Parameters:
ob - Object to compare to this Namespace.

Returns:
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.

Parameters:
uri - String URI of new Namespace.

Returns:
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.

Parameters:
prefix - String prefix to map to Namespace.
uri - String URI of new Namespace.

Returns:
Namespace - ready to use namespace.


getPrefix

public String getPrefix()
This returns the prefix mapped to this Namespace.

Returns:
String - prefix for this Namespace.


getURI

public String getURI()
This returns the namespace URI for this Namespace.

Returns:
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.

Returns:
int - hash code for this Namespace.


toString

public String toString()
This returns a String representation of this Namespace, suitable for use in debugging.

Returns:
String - information about this instance.


Copyright B) 2004 Jason Hunter, Brett McLaughlin. All Rights Reserved.