Класс EndpointReference

java.lang.Object
- javax.xml.ws.EndpointReference

Прямые известные подклассы:: W3CEndpointReference

public abstract class EndpointReference
extends Object

Этот класс представляет собой WS-Addressing EndpointReference, являющийся удаленной ссылкой на конечную точку веб-службы. Подробности о WS-Addressing EndpointReferences можно найти в WS-Addressing 1.0 - Core.

Этот класс является неизменяемым, так как типичному разработчику веб-служб не нужно беспокоиться о его содержимом. Разработчик веб-службы должен использовать этот класс исключительно как механизм для ссылки на удалённую конечную точку веб-службы. Обратитесь к API Service, которые клиенты могут использовать для работы с EndpointReference. Обратитесь к API Endpoint и BindingProvider для получения информации о том, как можно создать EndpointReferences для опубликованных конечных точек.

Конкретные реализации этого класса будут представлять EndpointReference для конкретной версии адресации. Например, W3CEndpointReference предназначен для использования с рекомендацией W3C Web Services Addressing 1.0 - Core. Если разработчикам JAX-WS необходимо поддерживать различные версии адресации, они должны написать собственный подкласс EndpointReference для этой версии. Это позволит реализации JAX-WS создать собственную, vendor-специфическую EndpointReferences для обозначения другой версии адресации.

Разработчики веб-служб, которые хотят передавать или возвращать EndpointReference в методах Java в SEI, должны использовать конкретные экземпляры EndpointReference , такие как W3CEndpointReference. Таким образом, схема, настроенная из SEI, будет более подробно описывать тип передаваемой ссылки на конечную точку.

От разработчиков реализаций JAX-WS ожидается извлечение XML-инфосета из EndpointReferece с помощью метода writeTo(javax.xml.transform.Result).

JAXB свяжет этот класс с xs:anyType. Если требуется более подходящая настройка, разработчики веб-служб должны использовать конкретный подкласс, например, W3CEndpointReference.

С момента:: JAX-WS 2.1
См. также:: W3CEndpointReference, Service

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

Модификатор	Конструктор и описание
`protected`	`EndpointReference()`

Методы

Модификатор и тип	Метод и описание
`<T> T`	`getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)` Метод `getPort` возвращает прокси.
`static EndpointReference`	`readFrom(Source eprInfoset)` Метод-фабрика для чтения EndpointReference из инфосета, содержащегося в `eprInfoset`.
`String`	`toString()` Отображает EPR-инфосет для удобства отладки.
`abstract void`	`writeTo(Result result)` Записывает этот `EndpointReference` в указанный формат инфосета

Наследуемые методы из класса java.lang.Object

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

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

EndpointReference

protected EndpointReference()

Методы

readFrom

public static EndpointReference readFrom(Source eprInfoset)

Метод-фабрика для чтения EndpointReference из инфосета, содержащегося в eprInfoset. Этот метод делегирует вызов методу Provider.readEndpointReference(javax.xml.transform.Source) vendor-специфической реализации.

Параметры:: eprInfoset - EndpointReference инфосет для разбора
Возвращает:: EndpointReference, разобранный из eprInfoset никогда null
Исключения:: WebServiceException - если возникла ошибка при создании EndpointReference из eprInfoset; IllegalArgumentException - если значение null eprInfoset задано.

writeTo

public abstract void writeTo(Result result)

Записать этот EndpointReference в указанный формат инфосета

Параметры:: result - для записи инфосета
Исключения:: WebServiceException - если произошла ошибка при записи EndpointReference в указанный result.; IllegalArgumentException - Если значение null result задано.

getPort

public <T> T getPort(Class<T> serviceEndpointInterface,
                     WebServiceFeature... features)

Метод getPort возвращает прокси. Если в экземпляре EndpointReference присутствуют параметры ссылки, то эти параметры ссылки ОБЯЗАТЕЛЬНО должны появляться в виде SOAP-заголовков, указывающих их как параметры ссылки, во всех сообщениях, отправляемых в конечную точку. Параметр serviceEndpointInterface указывает интерфейс конечной точки службы, который поддерживает возвращаемый прокси. Экземпляр EndpointReference указывает конечную точку, которая будет вызвана возвращаемым прокси. В реализации этого метода система времени выполнения JAX-WS берёт на себя ответственность за выбор протокольного связывания (и порта) и соответствующую настройку прокси на основе метаданных WSDL из этого EndpointReference или из аннотаций на serviceEndpointInterface. Для успешного возврата прокси метаданные WSDL ДОЛЖНЫ быть доступны, а экземпляр EndpointReference ДОЛЖЕН содержать реализацию, понятную serviceName метаданным.

Поскольку этот порт не создан из объекта Service, обработчики не будут автоматически настраиваться, и HandlerResolver и Executor нельзя получить или установить для этого порта. Метод BindingProvider().getBinding().setHandlerChain() можно использовать для ручного конфигурирования обработчиков для этого порта.

Параметры:

serviceEndpointInterface - Интерфейс конечной точки службы

features - Массив WebServiceFeatures для конфигурации прокси. Поддерживаемые функции, отсутствующие в

features

параметре, будут иметь свои значения по умолчанию.

Возвращает:

Экземпляр прокси-объекта, поддерживающий указанный интерфейс конечной точки службы

Исключения:

WebServiceException -

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

См. также:

Proxy, WebServiceFeature

toString

public String toString()

Отображает EPR-инфосет для удобства отладки.

Переопределяет:: toString в классе Object
Возвращает:: строковое представление объекта.

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