Пакет javax.xml.soap

Предоставляет API для создания и построения сообщений SOAP.

Интерфейс	Описание
Detail	Контейнер для `DetailEntry` объектов.
DetailEntry	Содержимое для объекта `Detail`, предоставляющее детали для объекта `SOAPFault`.
Name	Представление имени XML.
Node	Представление узла (элемента) в документе XML.
SOAPBody	Объект, представляющий содержимое элемента тела SOAP в сообщении SOAP.
SOAPBodyElement	Объект `SOAPBodyElement` представляет содержимое в объекте `SOAPBody`.
SOAPConstants	Определение констант, относящихся к протоколу SOAP.
SOAPElement	Объект, представляющий элемент сообщения SOAP, разрешённый, но не специально предписанный спецификацией SOAP.
SOAPEnvelope	Контейнер для разделов SOAPHeader и SOAPBody объекта `SOAPPart`.
SOAPFault	Элемент в объекте `SOAPBody`, содержащий информацию об ошибке и/или состоянии.
SOAPFaultElement	Представление содержимого в объекте `SOAPFault`.
SOAPHeader	Представление элемента заголовка SOAP.
SOAPHeaderElement	Объект, представляющий содержимое в части заголовка SOAP конверта.
Text	Представление узла, значение которого является текстом.

Класс	Описание
AttachmentPart	Один вложение к объекту `SOAPMessage`.
MessageFactory	Фабрика для создания объектов `SOAPMessage`.
MimeHeader	Объект, хранящий имя заголовка MIME и его значение.
MimeHeaders	Контейнер для объектов `MimeHeader`, представляющих заголовки MIME, присутствующие в части MIME сообщения.
SAAJMetaFactory	Точка входа для реализации классов фабрик, определенных в API SAAJ.
SAAJResult	Выступает в качестве держателя результатов преобразования JAXP или маршализации JAXB в виде дерева SAAJ.
SOAPConnection	Точка-точка подключения, которую клиент может использовать для отправки сообщений напрямую удаленной стороне (например, представленной URL).
SOAPConnectionFactory	Фабрика для создания объектов `SOAPConnection`.
SOAPElementFactory	Устарело - Используйте `javax.xml.soap.SOAPFactory` для создания SOAPElements.
SOAPFactory	`SOAPFactory` является фабрикой для создания различных объектов, существующих в дереве SOAP XML.
SOAPMessage	Основной класс для всех сообщений SOAP.
SOAPPart	Контейнер для части, специфичной для SOAP, объекта `SOAPMessage`.

Исключение	Описание
SOAPException	Исключение, сигнализирующее о возникновении исключения SOAP.

Описание пакета javax.xml.soap

Предоставляет API для создания и построения сообщений SOAP. Данный пакет определён в спецификации SOAP с API вложений для Java^TM (SAAJ) 1.3.

API в пакете javax.xml.soap позволяет выполнять следующие действия:

установить подключение точка-точка к указанной конечной точке
создать сообщение SOAP
создать фрагмент XML
добавить содержимое в заголовок сообщения SOAP
добавить содержимое в тело сообщения SOAP
создать части вложений и добавить содержимое в них
получить доступ к/добавить/изменить части сообщения SOAP
создать/добавить/изменить информацию о SOAP ошибке
извлечь содержимое из сообщения SOAP
отправить сообщение SOAP запрос-ответ

Кроме того, API в пакете javax.xml.soap расширяют свои аналоги в пакете org.w3c.dom. Это означает, что SOAPPart объекта SOAPMessage также является DOM Level 2 Document, и может быть обработан как таковой приложениями, инструментами и библиотеками, использующими DOM (см. http://www.w3.org/DOM/ для получения дополнительной информации). Важно отметить, что, хотя можно использовать DOM API для добавления обычных узлов DOM в дерево SAAJ, API SAAJ по-прежнему требуются для возвращения типов SAAJ при исследовании или манипулировании деревом. Для достижения этой цели API SAAJ (в частности, SOAPElement.getChildElements()) разрешается молча заменять объекты, которые неправильно типизированы относительно требований SAAJ, на эквивалентные объекты требуемого типа. Эти замены никогда не должны изменять логическую структуру дерева, поэтому с точки зрения API DOM дерево останется неизменным. Однако физическое состав дерева изменится, так что ссылки на узлы, которые были заменены, будут ссылаться на узлы, которые больше не являются частью дерева. API SAAJ не разрешают выполнять эти замены, если они не требуются, поэтому замещающие объекты никогда впоследствии не будут молча заменены последующими вызовами API SAAJ.

Практическое значение этого заключается в том, что приложение, которое начинает использовать API SAAJ на дереве после его обработки с помощью API DOM, должно предполагать, что дерево было преобразовано в полное дерево SAAJ, и что любые ссылки на объекты внутри дерева, полученные с помощью API DOM, больше недействительны. Переключение с API SAAJ на API DOM не допускает возникновения недействительных ссылок, как и использование исключительно API SAAJ. Только переход с использования API DOM на конкретное дерево SAAJ к использованию API SAAJ создаёт риск недействительных ссылок.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.