Интерфейс LogicalMessage

public interface LogicalMessage

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

С момента:: JAX-WS 2.0

Методы

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

Методы

getPayload

Source getPayload()

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

Если возвращаемый Source является экземпляром DOMSource, то изменения в древовидной структуре DOM изменят полезную нагрузку сообщения непосредственно. В этом случае нет необходимости вызывать 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.

© 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.