javax.xml.soap

Имя интерфейса

public interface Name

Представление имени XML. Этот интерфейс обеспечивает методы для того, чтобы они получили локальные и полностью определенные имена пространства имен и также для того, чтобы они получили префикс, связанный с пространством имен для имени. Также возможно получить URI пространства имен.

Следующее является примером объявления пространства имен в элементе.

   <wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
 

("xmlns" обозначает "пространство имен XML".) Следующие шоу, что методы в Name интерфейс возвратится.

• getQualifiedName возвратит "prefix:LocalName" = "WOMBAT:GetLastTradePrice"
• getURI возвратится "http://www.wombat.org/trader"
• getLocalName возвратит "GetLastTracePrice"
• getPrefix возвратит "ВОМБАТ"

Пространства имен XML используются, чтобы снять неоднозначность идентификаторов SOAP от специализированных идентификаторов.

Name объекты создаются, используя метод SOAPEnvelope.createName, у которого есть две версии. Один метод создает Name объекты с локальным именем, префиксом пространства имен, и URI пространства имен. и второе создает Name объекты с только локальным именем. Следующая строка кода, в котором se является a SOAPEnvelope возразите, создает новое Name объект со всеми тремя.

     Name name = se.createName("GetLastTradePrice", "WOMBAT",
                                "http://www.wombat.org/trader");
 

Следующая строка кода дает пример как a Name объект может использоваться. Переменный элемент является a SOAPElement объект. Этот код создает новое SOAPElement объект с именем и добавляет это к элементу.

     element.addChildElement(name);
 

Name интерфейс может быть осужден в будущем выпуске SAAJ в пользу javax.xml.namespace.QName

See Also:

SOAPEnvelope.createName, SOAPFactory.createName

Method Summary

Modifier and Type	Method and Description
Строка	getLocalName() Gets the local name part of the XML name that this Name object represents.
Строка	getPrefix() Returns the prefix that was specified when this Name object was initialized.
Строка	getQualifiedName() Gets the namespace-qualified name of the XML name that this Name object represents.
Строка	getURI() Returns the URI of the namespace for the XML name that this Name object represents.

Method Detail

getLocalName

String getLocalName()

Gets the local name part of the XML name that this Name object represents.

Returns:

a string giving the local name

getQualifiedName

String getQualifiedName()

Gets the namespace-qualified name of the XML name that this Name object represents.

Returns:

the namespace-qualified name as a string

getPrefix

String getPrefix()

Returns the prefix that was specified when this Name object was initialized. This prefix is associated with the namespace for the XML name that this Name object represents.

Returns:

the prefix as a string

getURI

String getURI()

Returns the URI of the namespace for the XML name that this Name object represents.

Returns:

the URI as a string