Package org.jdom
Class Namespace
- java.lang.Object
-
- org.jdom.Namespace
-
- All Implemented Interfaces:
Serializable
public final class Namespace extends Object implements Serializable
An XML namespace representation, as well as a factory for creating XML namespace objects. All methods on Namespace (includinggetNamespace(String)andgetNamespace(String, String)) are thread-safe.See
NamespaceAwarefor additional notes on how Namespaces are 'in-scope' in JDOM content, and how those in-scope Namespaces are accessed.- See Also:
NamespaceAware, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static NamespaceNO_NAMESPACEDefine aNamespacefor when not in a namespacestatic NamespaceXML_NAMESPACEDefine aNamespacefor the standard xml prefix.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanequals(Object ob)This tests for equality - TwoNamespacesare equal if and only if their URIs are byte-for-byte equals.static NamespacegetNamespace(String uri)This will retrieve (if in existence) or create (if not) aNamespacefor the supplied URI, and make it usable as a default namespace, as no prefix is supplied.static NamespacegetNamespace(String prefix, String uri)This will retrieve (if in existence) or create (if not) aNamespacefor the supplied prefix and uri.StringgetPrefix()This returns the prefix mapped to thisNamespace.StringgetURI()This returns the namespace URI for thisNamespace.inthashCode()This returns the hash code for theNamespacethat conforms to the 'equals()' contract.StringtoString()This returns aStringrepresentation of thisNamespace, suitable for use in debugging.
-
-
-
Method Detail
-
getNamespace
public static Namespace getNamespace(String prefix, String uri)
This will retrieve (if in existence) or create (if not) aNamespacefor the supplied prefix and uri. This method is thread-safe.- Parameters:
prefix-Stringprefix to map toNamespace.uri-StringURI of newNamespace.- Returns:
Namespace- ready to use namespace.- Throws:
IllegalNameException- if the given prefix and uri make up an illegal namespace name.- See Also:
Verifier.checkNamespacePrefix(String),Verifier.checkNamespaceURI(String)
-
getNamespace
public static Namespace getNamespace(String uri)
This will retrieve (if in existence) or create (if not) aNamespacefor the supplied URI, and make it usable as a default namespace, as no prefix is supplied. This method is thread-safe.- Parameters:
uri-StringURI of newNamespace.- Returns:
Namespace- ready to use namespace.
-
getPrefix
public String getPrefix()
This returns the prefix mapped to thisNamespace.- Returns:
String- prefix for thisNamespace.
-
getURI
public String getURI()
This returns the namespace URI for thisNamespace.- Returns:
String- URI for thisNamespace.
-
equals
public boolean equals(Object ob)
This tests for equality - TwoNamespacesare equal if and only if their URIs are byte-for-byte equals.
-
toString
public String toString()
This returns aStringrepresentation of thisNamespace, suitable for use in debugging.
-
hashCode
public int hashCode()
This returns the hash code for theNamespacethat conforms to the 'equals()' contract.If two namespaces have the same URI, they are equal and have the same hash code, even if they have different prefixes.
-
-