javax.xml.ws

Класс EndpointReference

java.lang. Объект

javax.xml.ws. EndpointReference

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

W3CEndpointReference

public abstract class EndpointReference
extends Object

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

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

Конкретные реализации этого class представят EndpointReference для определенной версии Адресации. Например W3CEndpointReference для использования с Веб-сервисами W3C, Адресуясь 1.0 - Базовая Рекомендация. Если конструкторы JAX-WS должны поддерживать различные версии адресации, они должны записать свое собственное EndpointReference подкласс для той версии. Это позволит реализации JAX-WS создавать определенного поставщика EndpointReferences то, что поставщик может использовать, чтобы отметить различную версию адресации.

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

Конструкторы JAX-WS, как ожидают, извлекут инфонабор XML из EndpointReferece использование writeTo(javax.xml.transform.Result) метод.

JAXB свяжет этот class с 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.
Строка	toString() Дисплеи инфонабор EPR для того, чтобы отладить удобство.
abstract void	writeTo(Result result) запишите это EndpointReference к указанному формату инфонабора

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

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) метод.

Параметры:

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 метаданные.

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

Параметры:

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

features - Массив WebServiceFeatures сконфигурировать на прокси. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.

Возвраты:

Объектный экземпляр Прокси, который поддерживает указанный интерфейс конечной точки службы

Броски:

WebServiceException -

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

См. Также:

Proxy, WebServiceFeature

toString

public String toString()

Дисплеи инфонабор EPR для того, чтобы отладить удобство.

Переопределения:

toString в class Object

Возвраты:

строковое представление объекта.