Класс RespectBindingFeature

public final class RespectBindingFeature
extends WebServiceFeature

Данный функциональный элемент поясняет использование wsdl:binding в среде выполнения JAX-WS. Данный функциональный элемент может быть использован при создании прокси-объектов SEI и экземпляров Dispatch на стороне клиента, а также экземпляров Endpoint на стороне сервера. Данный функциональный элемент нельзя использовать для создания экземпляров Service на стороне клиента.

Этот функциональный элемент полезен только для веб-служб, имеющих связанный WSDL. Включение этого функционального элемента требует, чтобы реализация JAX-WS проверила wsdl:binding для конечной точки во время выполнения, чтобы убедиться, что все wsdl:extensions с атрибутом required установленным в значение true правильно понимаются и используются.

Ниже описано влияние включения или выключения этого функционального элемента:

• ВКЛЮЧЕНО: В этом режиме среда выполнения JAX-WS должна гарантировать, что все необходимые wsdl:binding расширения (включая политики) либо понятны и используются средой выполнения, либо явно отключены приложением веб-службы. Веб-служба может отключить определённое расширение, если существует соответствующий WebServiceFeature или аннотация. Аналогично, клиент веб-службы может отключить определённое расширение, используя соответствующее WebServiceFeature при создании прокси-объекта или экземпляра Dispatch. Среда выполнения также должна гарантировать, что привязка параметров/возвращаемых значений SEI соответствует wsdl:binding. Если при включенном функциональном элементе требуемое (wsdl:required="true") wsdl:binding расширение присутствует в WSDL, но не поддерживается средой выполнения JAX-WS и не было явно отключено разработчиком веб-службы, среда выполнения JAX-WS должна действовать соответствующим образом в зависимости от того, находится она на стороне клиента или сервера:
  • Клиент: среда выполнения должна выбросить исключение WebServiceException не ранее, чем при вызове одного из методов выше, но не позднее первого вызова операции конечной точки.
  • Сервер: выбросить исключение WebServiceException, и конечная точка не должна быть развернута.
• ВЫКЛЮЧЕНО: В этом режиме реализация может выбрать, проверять ли wsdl:binding или нет, и в какой степени будут проверяться wsdl:binding. Например, одна реализация может действовать так, как если бы этот функциональный элемент был включён, а другая — только проверять привязки типов параметров/возвращаемых значений SEI.

Подробное описание полей

ID

public static final String ID

Значение константы, определяющей RespectBindingFeature

See Also:

Значения константных полей

Подробное описание конструкторов

RespectBindingFeature

public RespectBindingFeature()

Создаёт RespectBindingFeature. Созданный экземпляр будет включён.

RespectBindingFeature

public RespectBindingFeature(boolean enabled)

Создаёт RespectBindingFeature

Параметры:

enabled - указывает, должен ли этот функциональный элемент быть включён или нет.

Подробное описание методов

getID

public String getID()

Получить уникальный идентификатор для этого WebServiceFeature.

Указано в:

getID в классе WebServiceFeature

Возвращает:

уникальный идентификатор этого функционального элемента.