javax.xml.ws

Интерфейс LogicalMessage

public interface LogicalMessage

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

С тех пор:

JAX-WS 2.0

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

Модификатор и Тип	Метод и Описание
Источник	getPayload() Получает полезную нагрузку сообщения как источник XML, может быть вызван многократно на том же самом экземпляре LogicalMessage, всегда возвращает новое Source это может использоваться, чтобы получить всю полезную нагрузку сообщения.
Объект	getPayload(JAXBContext context) Получает полезную нагрузку сообщения как объект JAXB.
void	setPayload(Object payload, JAXBContext context) Устанавливает полезную нагрузку сообщения
void	setPayload(Source payload) Устанавливает полезную нагрузку сообщения

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

getPayload

Source getPayload()

Получает полезную нагрузку сообщения как источник XML, может быть вызван многократно на том же самом экземпляре LogicalMessage, всегда возвращает новое Source это может использоваться, чтобы получить всю полезную нагрузку сообщения.

Если возвращенный Source экземпляр DOMSource, тогда модификации к инкапсулировавшему дереву ДОМА изменяют оперативную полезную нагрузку сообщения, нет никакой потребности к вызову susequently setPayload. Другие типы Source обеспечьте только доступ для чтения к полезной нагрузке сообщения.

Возвраты:

Содержавшая полезная нагрузка сообщения; возвраты null если никакая полезная нагрузка не присутствует в этом сообщении.

setPayload

void setPayload(Source payload)

Устанавливает полезную нагрузку сообщения

Параметры:

payload - полезная нагрузка сообщения

Броски:

WebServiceException - Если любая ошибка во время установки полезной нагрузки в этом сообщении

UnsupportedOperationException - Если эта работа не поддерживается

getPayload

Object getPayload(JAXBContext context)

Получает полезную нагрузку сообщения как объект JAXB. Отметьте, что нет никакого соединения между возвращенным объектом и полезной нагрузкой сообщения, изменения к полезной нагрузке требуют вызова setPayload.

Параметры:

context - JAXBContext, который должен привыкнуть к неМаршаллу полезная нагрузка сообщения

Возвраты:

Содержавшая полезная нагрузка сообщения; возвраты null если никакая полезная нагрузка не присутствует в этом сообщении

Броски:

WebServiceException - Если ошибка происходит при использовании предоставленного JAXBContext с неМаршаллом полезная нагрузка. Причиной WebServiceException является исходный JAXBException.

setPayload

void setPayload(Object payload,
                JAXBContext context)

Устанавливает полезную нагрузку сообщения

Параметры:

payload - полезная нагрузка сообщения

context - JAXBContext, который должен привыкнуть к Маршаллу полезная нагрузка

Броски:

UnsupportedOperationException - Если эта работа не поддерживается

WebServiceException - Если ошибка происходит при использовании предоставленного JAXBContext с Маршаллом полезная нагрузка. Причиной WebServiceException является исходный JAXBException.