javax.xml.soap

Класс SOAPPart

java.lang. Объект

javax.xml.soap. SOAPPart

Все Реализованные Интерфейсы:

Документ, Узел

public abstract class SOAPPart
extends Object
implements Document, Node

Контейнер для специфичной для SOAP части a SOAPMessage объект. Все сообщения обязаны иметь часть SOAP, так когда a SOAPMessage объект создается, у него автоматически будет a SOAPPart объект.

A SOAPPart объект является частью MIME и имеет Идентификатор контента заголовков MIME, Расположение контента, и Тип контента. Поскольку значение Типа контента должно быть "text/xml", a SOAPPart у объекта автоматически есть заголовок MIME Типа контента с его набором значений к "text/xml". Значение должно быть "text/xml", потому что контент в части SOAP сообщения должен быть в формате XML. Контент, который не имеет типа "text/xml", должен быть в AttachmentPart возразите, а не в SOAPPart объект.

Когда сообщение отправляется, у его части SOAP должен быть набор Типа контента заголовка MIME к "text/xml". Или с другой точки зрения у части SOAP любого сообщения, которое получается, должен быть Тип контента заголовка MIME со значением "text/xml".

Клиент может получить доступ SOAPPart объект a SOAPMessage объект, вызывая метод SOAPMessage.getSOAPPart. Следующая строка та, кода, в который message a SOAPMessage возразите, получает часть SOAP сообщения.

   SOAPPart soapPart = message.getSOAPPart();
 

A SOAPPart объект содержит a SOAPEnvelope объект, который поочередно содержит a SOAPBody объект и a SOAPHeader объект. SOAPPart метод getEnvelope может использоваться, чтобы получить SOAPEnvelope объект.

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Сводка конструктора

Конструкторы

Конструктор и Описание
SOAPPart()

Сводка метода

Модификатор и Тип	Метод и Описание
abstract void	addMimeHeader(String name, String value) Создает a MimeHeader объект с указанным именем и значением и добавляет это к этому SOAPPart объект.
abstract Iterator	getAllMimeHeaders() Получает все заголовки для этого SOAPPart возразите как iterator по MimeHeader объекты.
abstract Source	getContent() Возвращает контент SOAPEnvelope как JAXP Source объект.
Строка	getContentId() Получает значение заголовка MIME, именем которого является "Идентификатор контента".
Строка	getContentLocation() Получает значение заголовка MIME, именем которого является "Расположение контента".
abstract SOAPEnvelope	getEnvelope() Добирается SOAPEnvelope объект связался с этим SOAPPart объект.
abstract Iterator	getMatchingMimeHeaders(String[] names) Получает все MimeHeader объекты, которые соответствуют имя в данном массиве.
abstract String[]	getMimeHeader(String name) Получает все значения MimeHeader объект в этом SOAPPart объект, который идентифицируется данным String.
abstract Iterator	getNonMatchingMimeHeaders(String[] names) Получает все MimeHeader объекты, имя которых не соответствует имя в данном массиве.
abstract void	removeAllMimeHeaders() Удаляет весь MimeHeader объекты для этого SOAPEnvelope объект.
abstract void	removeMimeHeader(String header) Удаляет все заголовки MIME, которые соответствуют имя.
abstract void	setContent(Source source) Устанавливает контент SOAPEnvelope объект с данными от данного Source объект.
void	setContentId(String contentId) Устанавливает значение заголовка MIME под названием "Идентификатор контента" к данному String.
void	setContentLocation(String contentLocation) Устанавливает значение заголовка MIME "Расположение контента" к данному String.
abstract void	setMimeHeader(String name, String value) Изменяет первую запись заголовка, которая соответствует данное имя заголовка так, чтобы его значение было данным значением, добавляя новый заголовок с именем и значением, если никакой существующий заголовок не является соответствием.

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, наследованные от интерфейса org.w3c.dom. Документ

adoptNode, createAttribute, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createElement, createElementNS, createEntityReference, createProcessingInstruction, createTextNode, getDoctype, getDocumentElement, getDocumentURI, getDomConfig, getElementById, getElementsByTagName, getElementsByTagNameNS, getImplementation, getInputEncoding, getStrictErrorChecking, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, normalizeDocument, renameNode, setDocumentURI, setStrictErrorChecking, setXmlStandalone, setXmlVersion

Методы, наследованные от интерфейса javax.xml.soap. Узел

detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue

Методы, наследованные от интерфейса org.w3c.dom. Узел

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Деталь конструктора

SOAPPart

public SOAPPart()

Деталь метода

getEnvelope

public abstract SOAPEnvelope getEnvelope()
                                  throws SOAPException

Добирается SOAPEnvelope объект связался с этим SOAPPart объект. Как только конверт SOAP получается, он может использоваться, чтобы получить его содержание.

Возвраты:

SOAPEnvelope объект для этого SOAPPart объект

Броски:

SOAPException - если есть ошибка SOAP

getContentId

public String getContentId()

Получает значение заголовка MIME, именем которого является "Идентификатор контента".

Возвраты:

a String предоставление значения заголовка MIME под названием "Идентификатор контента"

См. Также:

setContentId(java.lang.String)

getContentLocation

public String getContentLocation()

Получает значение заголовка MIME, именем которого является "Расположение контента".

Возвраты:

a String предоставление значения заголовка MIME, именем которого является "Расположение контента"

См. Также:

setContentLocation(java.lang.String)

setContentId

public void setContentId(String contentId)

Устанавливает значение заголовка MIME под названием "Идентификатор контента" к данному String.

Параметры:

contentId - a String предоставление значения заголовка MIME "Идентификатор контента"

Броски:

IllegalArgumentException - если есть проблема в установке идентификатора контента

См. Также:

getContentId()

setContentLocation

public void setContentLocation(String contentLocation)

Устанавливает значение заголовка MIME "Расположение контента" к данному String.

Параметры:

contentLocation - a String предоставление значения заголовка MIME "Расположение контента"

Броски:

IllegalArgumentException - если есть проблема в установке расположения контента.

См. Также:

getContentLocation()

removeMimeHeader

public abstract void removeMimeHeader(String header)

Удаляет все заголовки MIME, которые соответствуют имя.

Параметры:

header - a String предоставление имени заголовка (ков) MIME, который будет удален

removeAllMimeHeaders

public abstract void removeAllMimeHeaders()

Удаляет весь MimeHeader объекты для этого SOAPEnvelope объект.

getMimeHeader

public abstract String[] getMimeHeader(String name)

Получает все значения MimeHeader объект в этом SOAPPart объект, который идентифицируется данным String.

Параметры:

name - имя заголовка; пример: "Тип контента"

Возвраты:

a String массив, дающий все значения для указанного заголовка

См. Также:

setMimeHeader(java.lang.String, java.lang.String)

setMimeHeader

public abstract void setMimeHeader(String name,
                                   String value)

Изменяет первую запись заголовка, которая соответствует данное имя заголовка так, чтобы его значение было данным значением, добавляя новый заголовок с именем и значением, если никакой существующий заголовок не является соответствием. Если есть соответствие, этот метод очищает все существующие значения для первого заголовка, который соответствует и устанавливает данное значение вместо этого. Если больше чем у одного заголовка есть имя, этот метод удаляет все соответствующие заголовки после первого.

Отметьте, что заголовки RFC822 могут содержать только символы US-ASCII.

Параметры:

name - a String предоставление заголовка называет, который можно искать

value - a String предоставление значения, которое будет установлено. Этим значением заменят текущую стоимость (ь) первого заголовка, который является соответствием, если есть тот. Если там не будет идти ни в какое сравнение, то это значение будет значением для нового MimeHeader объект.

Броски:

IllegalArgumentException - если была проблема с указанным именем заголовка пантомимы или значением

См. Также:

getMimeHeader(java.lang.String)

addMimeHeader

public abstract void addMimeHeader(String name,
                                   String value)

Создает a MimeHeader объект с указанным именем и значением и добавляет это к этому SOAPPart объект. Если a MimeHeader с указанным именем уже существует, этот метод добавляет указанное значение к уже существующему значению (ям).

Отметьте, что заголовки RFC822 могут содержать только символы US-ASCII.

Параметры:

name - a String предоставление имени заголовка

value - a String предоставление значения, которое будет установлено или добавлено

Броски:

IllegalArgumentException - если была проблема с указанным именем заголовка пантомимы или значением

getAllMimeHeaders

public abstract Iterator getAllMimeHeaders()

Получает все заголовки для этого SOAPPart возразите как iterator по MimeHeader объекты.

Возвраты:

Iterator объект со всеми заголовками Пантомимы для этого SOAPPart объект

getMatchingMimeHeaders

public abstract Iterator getMatchingMimeHeaders(String[] names)

Получает все MimeHeader объекты, которые соответствуют имя в данном массиве.

Параметры:

names - a String массив с именем (енами) заголовков MIME, которые будут возвращены

Возвраты:

все заголовки MIME, которые соответствуют одно из имен в данном массиве, возвратились как Iterator объект

getNonMatchingMimeHeaders

public abstract Iterator getNonMatchingMimeHeaders(String[] names)

Получает все MimeHeader объекты, имя которых не соответствует имя в данном массиве.

Параметры:

names - a String массив с именем (енами) заголовков MIME, которые не будут возвращены

Возвраты:

все заголовки MIME в этом SOAPPart объект кроме тех, которые соответствуют одно из имен в данном массиве. Несоответствующие заголовки MIME возвращаются как Iterator объект.

setContent

public abstract void setContent(Source source)
                         throws SOAPException

Устанавливает контент SOAPEnvelope объект с данными от данного Source объект. Это Source должен содержать допустимый документ SOAP.

Параметры:

source - javax.xml.transform.Source объект с данными, которые будут установлены

Броски:

SOAPException - если есть проблема в установке источника

См. Также:

getContent()

getContent

public abstract Source getContent()
                           throws SOAPException

Возвращает контент SOAPEnvelope как JAXP Source объект.

Возвраты:

контент как a javax.xml.transform.Source объект

Броски:

SOAPException - если реализация не может преобразовать указанное Source объект

См. Также:

setContent(javax.xml.transform.Source)