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

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 вернёт "GetLastTradePrice"
• getPrefix вернёт "WOMBAT"

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

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

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

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

element.addChildElement(name);

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

Методы

getLocalName

String getLocalName()

Получает локальную часть имени XML, которую представляет этот объект Name.

Возвращает:

строку, содержащую локальное имя

getQualifiedName

String getQualifiedName()

Получает квалифицированное имя пространства имён XML, которое представляет этот объект Name.

Возвращает:

квалифицированное имя пространства имён в виде строки

getPrefix

String getPrefix()

Возвращает префикс, указанный при инициализации объекта Name. Этот префикс связан с пространством имён имени XML, которое представляет этот объект Name.

Возвращает:

префикс в виде строки

getURI

String getURI()

Возвращает URI пространства имён для имени XML, которое представляет этот объект Name.

Возвращает:

URI в виде строки