Класс AddressingFeature

public final class AddressingFeature
extends WebServiceFeature

AddressingFeature представляет использование WS-Addressing с привязкой SOAP 1.1/HTTP или SOAP 1.2/HTTP. Использование этой функции с любой другой привязкой не определено.

Эта функция может использоваться при создании прокси SEI, и Dispatch экземпляров на стороне клиента и Endpoint экземпляров на стороне сервера. Эта функция не может использоваться для создания Service экземпляров на стороне клиента.

Ниже описано влияние этой функции при включении или отключении:

• ВКЛЮЧЕНО: В этом режиме WS-Addressing будет включено. Это означает, что конечная точка поддерживает WS-Addressing, но не требует его использования. Отправитель может отправлять сообщения с заголовками WS-Addressing или без них. Но получатель ОБЯЗАН обрабатывать оба типа сообщений.
• ВЫКЛЮЧЕНО: В этом режиме WS-Addressing будет отключено. Во время выполнения отправитель и получатель НЕ ДОЛЖНЫ использовать заголовки WS-Addressing.

Если функция включена, свойство required определяет, требует ли конечная точка WS-Addressing. Если оно установлено в true, заголовки WS-Addressing ДОЛЖНЫ присутствовать в входящих и исходящих сообщениях. По умолчанию свойство required имеет значение false.

Если разработчик веб-службы явно не включил эту функцию, утверждение политики wsam:Addressing в WSDL используется для определения использования WS-Addressing. Явное использование функции переопределяет указание WSDL на использование WS-Addressing. В некоторых случаях это действительно необходимо. Например, если приложение реализовало WS-Addressing самостоятельно, оно может использовать эту функцию для отключения адресации. Это означает, что реализация JAX-WS не потребляет и не генерирует заголовки WS-Addressing.

Если адресация включена, соответствующее утверждение политики wsam:Addressing должно быть сгенерировано в WSDL в соответствии с 3.1 WS-Policy Assertions

Пример 1: Возможные утверждения политики в сгенерированном WSDL для @Addressing

<wsam:Addressing wsp:Optional="true">
     <wsp:Policy/>
   </wsam:Addressing>

Пример 2: Возможные утверждения политики в сгенерированном WSDL для @Addressing(required=true)

<wsam:Addressing>
     <wsp:Policy/>
   </wsam:Addressing>

Пример 3: Возможные утверждения политики в сгенерированном WSDL для @Addressing(required=true, responses=Responses.ANONYMOUS)

<wsam:Addressing>
      <wsp:Policy>
        <wsam:AnonymousResponses/>
      </wsp:Policy>
   </wsam:Addressing>

См. Web Services Addressing - Core, Web Services Addressing 1.0 - SOAP Binding и Web Services Addressing 1.0 - Metadata для получения дополнительной информации о WS-Addressing.

Поля

ID

public static final String ID

Постоянное значение, идентифицирующее AddressingFeature

См. также:

Постоянные значения полей

required

protected boolean required

Если адресация включена, это свойство определяет, требует ли конечная точка WS-Addressing. Если required равно true, заголовки WS-Addressing ДОЛЖНЫ присутствовать в входящих и исходящих сообщениях.

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

AddressingFeature

public AddressingFeature()

Создаёт и настраивает AddressingFeature с использованием требований адресации. Созданная функция включает ws-addressing, т.е. поддерживает ws-addressing, но не требует его использования. Она также настроена для принятия всех типов ответов.

AddressingFeature

public AddressingFeature(boolean enabled)

Создаёт и настраивает AddressingFeature с использованием требований адресации. Если enabled равно true, она включает ws-addressing, т.е. ws-addressing поддерживается, но не требуется. Она также настроена для принятия всех типов ответов.

Параметры:

enabled - true включает ws-addressing, т.е. ws-addressing поддерживается, но не требуется

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required)

Создаёт и настраивает AddressingFeature с использованием требований адресации. Если enabled и required равны true, она включает ws-addressing и требует его использования. Она также настроена для принятия всех типов ответов.

Параметры:

enabled - true включает ws-addressing, т.е. ws-addressing поддерживается, но не требуется

required - true означает требуется использование ws-addressing.

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required,
                         AddressingFeature.Responses responses)

Создаёт и настраивает AddressingFeature с использованием требований адресации. Если enabled и required равны true, она включает ws-addressing и требует его использования. Также типы ответов могут быть настроены с помощью параметра responses.

Параметры:

enabled - true включает ws-addressing, т.е. ws-addressing поддерживается, но не требуется

required - true означает требуется использование ws-addressing.

responses - указывает, какие типы ответов требуются

Since:

JAX-WS 2.2

Методы

getID

public String getID()

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

Спецификация:

getID в классе WebServiceFeature

Возвращает:

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

isRequired

public boolean isRequired()

Если адресация включена, это свойство определяет, требует ли конечная точка WS-Addressing. Если required равно true, заголовки WS-Addressing ДОЛЖНЫ присутствовать в входящих и исходящих сообщениях.

Возвращает:

текущее значение required

getResponses

public AddressingFeature.Responses getResponses()

Возвращает:

AddressingFeature.Responses.ALL когда конечная точка поддерживает все типы ответов, AddressingFeature.Responses.ANONYMOUS когда конечная точка требует использования только анонимных ответов, AddressingFeature.Responses.NON_ANONYMOUS когда конечная точка требует использования только не анонимных ответов

Since:

JAX-WS 2.2