Пакет javax.xml.soap

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

См.: Описание

Сводка интерфейса

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

Сводка класса

Класс	Описание
AttachmentPart	Единственное присоединение к a 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 фабрика для того, чтобы создать различные объекты, которые существуют в дереве XML SOAP.
SOAPMessage	Корневой class для всех сообщений SOAP.
SOAPPart	Контейнер для специфичной для SOAP части a SOAPMessage объект.

Сводка исключения

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

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

Обеспечивает API для создания и создания сообщений SOAP. Этот пакет определяется в SOAP с Присоединяемым API для ^JavaTM (SAAJ) 1.3 спецификации.

API в javax.xml.soap пакет позволяет Вам делать следующее:

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

--> -->

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

Что это означает, на практике то, что приложение, которое начинает использовать API SAAJ на дереве после управления этим использующий API ДОМА, должно предположить, что дерево было преобразовано во все дерево SAAJ и что любые ссылки на объекты в пределах дерева, которые были получены, используя API ДОМА, больше не действительны. Переключению от API SAAJ до API ДОМА не позволяют вызвать недопустимые ссылки, и ни один не использует API SAAJ исключительно. Это только переключается от использования API ДОМА на определенном дереве SAAJ к использованию API SAAJ, который вызывает риск недопустимых ссылок.