Интерфейс Dispatch<T>

Все суперинтерфейсы:: BindingProvider

public interface Dispatch<T>
extends BindingProvider

Интерфейс Dispatch предоставляет поддержку динамического вызова операций конечной точки службы. Класс javax.xml.ws.Service выступает в роли фабрики для создания экземпляров Dispatch.

С:: JAX-WS 2.0

Поля

Поля, унаследованные от интерфейса javax.xml.ws.BindingProvider

ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, SOAPACTION_URI_PROPERTY, SOAPACTION_USE_PROPERTY, USERNAME_PROPERTY

Методы

Модификатор и тип	Метод и описание
`T`	`invoke(T msg)` Вызов операции службы синхронно.
`Response<T>`	`invokeAsync(T msg)` Вызов операции службы асинхронно.
`Future<?>`	`invokeAsync(T msg, AsyncHandler<T> handler)` Вызов операции службы асинхронно.
`void`	`invokeOneWay(T msg)` Вызов операции службы в одностороннем режиме.

Методы, унаследованные от интерфейса javax.xml.ws.BindingProvider

getBinding, getEndpointReference, getEndpointReference, getRequestContext, getResponseContext

Методы

invoke

T invoke(T msg)

Вызов операции службы синхронно. Клиент отвечает за обеспечение того, что объект msg, при сериализации, сформирован в соответствии с требованиями используемой привязкой протокола.

Параметры:: msg - Объект, который будет формировать сообщение или полезную нагрузку сообщения, используемого для вызова операции.
Возвращает:: Сообщение или полезную нагрузку сообщения в ответ на вызов операции.
Исключения:: WebServiceException - Если произошла ошибка во время связи со службой; WebServiceException - Если возникла ошибка в конфигурации экземпляра Dispatch

invokeAsync

Response<T> invokeAsync(T msg)

Вызов операции службы асинхронно. Метод возвращается без ожидания ответа на вызов операции, результаты операции получаются путем опроса возвращенного Response.

Клиент отвечает за обеспечение того, что объект msg, при сериализации, сформирован в соответствии с требованиями используемой привязкой протокола.

Параметры:: msg - Объект, который будет формировать сообщение или полезную нагрузку сообщения, используемого для вызова операции.
Возвращает:: Сообщение или полезную нагрузку сообщения в ответ на вызов операции.
Исключения:: WebServiceException - Если возникла ошибка в конфигурации экземпляра Dispatch

invokeAsync

Future<?> invokeAsync(T msg,
                      AsyncHandler<T> handler)

Вызов операции службы асинхронно. Метод возвращается без ожидания ответа на вызов операции, результаты операции сообщаются клиенту через переданный handler.

Параметры:: msg - Объект, который будет формировать сообщение или полезную нагрузку сообщения, используемого для вызова операции.; handler - Объект обработчика, который получит ответ на вызов операции.
Возвращает:: Объект Future, который может использоваться для проверки состояния вызова операции. Этот объект НЕ должен использоваться для получения результатов операции - объект, возвращаемый из Future<?>.get(), зависит от реализации, и любое его использование приведет к непереносимому поведению.
Исключения:: WebServiceException - Если возникла ошибка в конфигурации экземпляра Dispatch

invokeOneWay

void invokeOneWay(T msg)

Вызов операции службы в одностороннем режиме. Вызов операции логически неблокирующий, с учётом возможностей базового протокола, результаты не возвращаются. Когда используемый протокол - SOAP/HTTP, этот метод должен блокироваться до получения кода ответа HTTP или возникновения ошибки.

Параметры:: msg - Объект, который будет формировать сообщение или полезную нагрузку сообщения, используемого для вызова операции.
Исключения:: WebServiceException - Если возникла ошибка в конфигурации экземпляра Dispatch или ошибка произошла во время вызова.

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