The following is an example of a namespace declaration in an element.
<wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
("xmlns" stands for "XML namespace".)
The following
shows what the methods in the Name
interface will return.
getQualifiedName
will return "prefix:LocalName" = "WOMBAT:GetLastTradePrice"getURI
will return "http://www.wombat.org/trader"getLocalName
will return "GetLastTracePrice"getPrefix
will return "WOMBAT"
XML namespaces are used to disambiguate SOAP identifiers from application-specific identifiers.
Name
objects are created using the method
SOAPEnvelope.createName
, which has two versions.
One method creates Name
objects with
a local name, a namespace prefix, and a namespace URI.
and the second creates Name
objects with just a local name.
The following line of
code, in which se is a SOAPEnvelope
object, creates a new
Name
object with all three.
Name name = se.createName("GetLastTradePrice", "WOMBAT",
"http://www.wombat.org/trader");
Name
object
can be used. The variable element is a SOAPElement
object.
This code creates a new SOAPElement
object with the given name and
adds it to element.
element.addChildElement(name);
The Name
interface may be deprecated in a future release of SAAJ
in favor of javax.xml.namespace.QName
- Since:
- 1.6
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionGets the local name part of the XML name that thisName
object represents.Returns the prefix that was specified when thisName
object was initialized.Gets the namespace-qualified name of the XML name that thisName
object represents.getURI()
Returns the URI of the namespace for the XML name that thisName
object represents.
-
Method Details
-
getLocalName
String getLocalName()Gets the local name part of the XML name that thisName
object represents.- Returns:
- a string giving the local name
-
getQualifiedName
String getQualifiedName()Gets the namespace-qualified name of the XML name that thisName
object represents.- Returns:
- the namespace-qualified name as a string
-
getPrefix
String getPrefix()Returns the prefix that was specified when thisName
object was initialized. This prefix is associated with the namespace for the XML name that thisName
object represents.- Returns:
- the prefix as a string
-
getURI
String getURI()Returns the URI of the namespace for the XML name that thisName
object represents.- Returns:
- the URI as a string
-