javax.xml.ws.soap

Класс AddressingFeature

java.lang. Объект

javax.xml.ws. WebServiceFeature

javax.xml.ws.soap. AddressingFeature

public final class AddressingFeature
extends WebServiceFeature

AddressingFeature представляет использование Адресации WS или с SOAP 1.1/HTTP или с SOAP 1.2/HTTP-СВЯЗЫВАНИЕ. Использование этой функции с любой другой привязкой неопределено.

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

Следующее описывает эффекты этой функции относительно быть включенным или отключенным:

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

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

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

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

Пример 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>
 

См., что Веб-сервисы Адресуются - Ядро, Веб-сервисы, Адресуясь 1.0 - Привязка SOAP, и Веб-сервисы, Адресуясь 1.0 - Метаданные для получения дополнительной информации об Адресации WS.

С тех пор:

JAX-WS 2.1

См. Также:

Addressing

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	AddressingFeature. Ответы Если адресация включается, это свойство определяет, требует ли конечная точка использования только анонимных ответов, или только неанонимных ответов, или всех.

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static String	ID Постоянная величина, идентифицирующая AddressingFeature
protected boolean	необходимый Если адресация включается, это свойство определяет, требует ли конечная точка Адресации WS.

Поля, наследованные от class javax.xml.ws. WebServiceFeature

включенный

Сводка конструктора

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

Конструктор и Описание
AddressingFeature() Создает и конфигурирует AddressingFeature с использованием адресации требований.
AddressingFeature(boolean enabled) Создает и конфигурирует AddressingFeature с использованием адресации требований.
AddressingFeature(boolean enabled, boolean required) Создает и конфигурирует AddressingFeature с использованием адресации требований.
AddressingFeature(boolean enabled, boolean required, AddressingFeature.Responses responses) Создает и конфигурирует AddressingFeature с использованием адресации требований.

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

Модификатор и Тип	Метод и Описание
Строка	getID() Получите уникальный идентификатор для этого WebServiceFeature.
AddressingFeature. Ответы	getResponses() Если адресация включается, это свойство определяет, требует ли конечная точка использования анонимных ответов, или неанонимных ответов, или всех ответов.
boolean	isRequired() Если адресация включается, это свойство определяет, требует ли конечная точка Адресации WS.

Методы, наследованные от class javax.xml.ws. WebServiceFeature

isEnabled

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

ID

public static final String ID

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

См. Также:

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

необходимый

protected boolean required

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

Деталь конструктора

AddressingFeature

public AddressingFeature()

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

AddressingFeature

public AddressingFeature(boolean enabled)

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

Параметры:

enabled - истина включает i.e.ws-адресации ws-адресации, поддерживается, но не требует ее использования

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required)

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

Параметры:

enabled - истина включает i.e.ws-адресации ws-адресации, поддерживается, но не требует ее использования

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

AddressingFeature

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

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

Параметры:

enabled - истина включает i.e.ws-адресации ws-адресации, поддерживается, но не требует ее использования

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

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

С тех пор:

JAX-WS 2.2

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

getID

public String getID()

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

Определенный:

getID в class WebServiceFeature

Возвраты:

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

isRequired

public boolean isRequired()

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

Возвраты:

ток требуемое значение

getResponses

public AddressingFeature.Responses getResponses()

Если адресация включается, это свойство определяет, требует ли конечная точка использования анонимных ответов, или неанонимных ответов, или всех ответов.

Возвраты:

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

С тех пор:

JAX-WS 2.2