javax.xml.ws.spi

Класс ServiceDelegate

java.lang. Объект

javax.xml.ws.spi. ServiceDelegate

public abstract class ServiceDelegate
extends Object

Делегаты службы используются внутренне Service объекты позволить pluggability реализаций JAX-WS.

Каждый Service у объекта есть свой собственный делегат, создаваемое использование Provider.createServiceDelegate(java.net.URL, javax.xml.namespace.QName, java.lang.Class<? extends javax.xml.ws.Service>) метод. A Service возразите делегирует все его методы экземпляра для его делегата.

С тех пор:

JAX-WS 2.0

См. Также:

Service, Provider

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

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

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

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

Методы

Модификатор и Тип	Метод и Описание
abstract void	addPort(QName portName, String bindingId, String endpointAddress) Создает новый порт для службы.
abstract <T> Dispatch<T>	createDispatch(EndpointReference endpointReference, Class<T> type, Service.Mode mode, WebServiceFeature... features) Создает a Dispatch экземпляр для использования с объектами выбора пользователя.
abstract Dispatch<Object>	createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features) Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты.
abstract <T> Dispatch<T>	createDispatch(QName portName, Class<T> type, Service.Mode mode) Создает a Dispatch экземпляр для использования с объектами выбора пользователя.
abstract <T> Dispatch<T>	createDispatch(QName portName, Class<T> type, Service.Mode mode, WebServiceFeature... features) Создает a Dispatch экземпляр для использования с объектами выбора пользователя.
abstract Dispatch<Object>	createDispatch(QName portName, JAXBContext context, Service.Mode mode) Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты.
abstract Dispatch<Object>	createDispatch(QName portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features) Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты.
abstract Executor	getExecutor() Возвращает исполнителя для этого Serviceэкземпляр.
abstract HandlerResolver	getHandlerResolver() Возвращает сконфигурированный преобразователь обработчика.
abstract <T> T	getPort(Class<T> serviceEndpointInterface) getPort метод возвращает прокси.
abstract <T> T	getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features) getPort метод возвращает прокси.
abstract <T> T	getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features) getPort метод возвращает прокси.
abstract <T> T	getPort(QName portName, Class<T> serviceEndpointInterface) getPort метод возвращает прокси.
abstract <T> T	getPort(QName portName, Class<T> serviceEndpointInterface, WebServiceFeature... features) getPort метод возвращает прокси.
abstract Iterator<QName>	getPorts() Возвраты Iterator для списка QNames конечных точек службы сгруппировался этой службой
abstract QName	getServiceName() Получает имя этой службы.
abstract URL	getWSDLDocumentLocation() Получает расположение документа WSDL для этой Службы.
abstract void	setExecutor(Executor executor) Устанавливает исполнителя для этого Service экземпляр.
abstract void	setHandlerResolver(HandlerResolver handlerResolver) Наборы HandlerResolver для этого Service экземпляр.

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

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

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

ServiceDelegate

protected ServiceDelegate()

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

getPort

public abstract <T> T getPort(QName portName,
            Class<T> serviceEndpointInterface)

getPort метод возвращает прокси. Клиент службы использует этот прокси, чтобы вызвать операции на целевую конечную точку службы. serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается создаваемым динамическим экземпляром прокси.

Параметры:

portName - Полностью определенное имя конечной точки службы в описании службы WSDL

serviceEndpointInterface - Интерфейс конечной точки службы поддерживается динамическим прокси

Возвраты:

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

Броски:

WebServiceException - Это исключение выдается в следующих случаях:

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

См. Также:

Proxy, InvocationHandler

getPort

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

getPort метод возвращает прокси. Клиент службы использует этот прокси, чтобы вызвать операции на целевую конечную точку службы. serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается создаваемым динамическим экземпляром прокси.

Параметры:

portName - Полностью определенное имя конечной точки службы в описании службы WSDL

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

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

Возвраты:

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

Броски:

WebServiceException - Это исключение выдается в следующих случаях:

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

С тех пор:

JAX-WS 2.1

См. Также:

Proxy, InvocationHandler, WebServiceFeature

getPort

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

getPort метод возвращает прокси. Параметр endpointReference определяет конечную точку, которая будет вызвана возвращенным прокси. Если есть какие-либо ссылочные параметры в endpointReference, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. endpointReference's адрес ДОЛЖЕН использоваться для вызовов на конечной точке. Параметр serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно от WSDL, связанного с этим Service экземпляр или от метаданных от endpointReference. Если это Service у экземпляра есть WSDL и endpointReference у метаданных также есть WSDL, тогда WSDL от этого экземпляра ДОЛЖЕН использоваться. Если это Service у экземпляра нет WSDL и endpointReference действительно имеет WSDL, тогда WSDL от endpointReference МОЖЕТ использоваться. Возвращенный прокси не должен быть реконфигурирован клиентом. Если это Service у экземпляра есть известный порт прокси, который соответствует информацию, содержавшуюся в WSDL, тогда тот прокси возвращается, иначе WebServiceException бросается.

У вызова этого метода есть то же самое поведение как следующий

 port = service.getPort(portName, serviceEndpointInterface);
 

где portName получается от метаданных endpointReference или от serviceEndpointInterface и WSDL связался с этим Service экземпляр.

Параметры:

endpointReference - EndpointReference для целевой конечной точки службы, которая будет вызвана возвращенным прокси.

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

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

Возвраты:

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

Броски:

WebServiceException -

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

С тех пор:

JAX-WS 2.1

getPort

public abstract <T> T getPort(Class<T> serviceEndpointInterface)

getPort метод возвращает прокси. Параметр serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно. Возвращенный прокси не должен быть реконфигурирован клиентом.

Параметры:

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

Возвраты:

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

Броски:

WebServiceException -

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

getPort

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

getPort метод возвращает прокси. Параметр serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно. Возвращенный прокси не должен быть реконфигурирован клиентом.

Параметры:

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

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

Возвраты:

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

Броски:

WebServiceException -

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

С тех пор:

JAX-WS 2.1

См. Также:

WebServiceFeature

addPort

public abstract void addPort(QName portName,
           String bindingId,
           String endpointAddress)

Создает новый порт для службы. Порты, создаваемые таким образом, не содержат информации о типе порта WSDL и могут только использоваться для того, чтобы создать Dispatchэкземпляры.

Параметры:

portName - Полностью определенное имя для целевой конечной точки службы

bindingId - Идентификатор URI привязки.

endpointAddress - Адрес целевой конечной точки службы как URI

Броски:

WebServiceException - Если любая ошибка в создании порта

См. Также:

SOAPBinding.SOAP11HTTP_BINDING, SOAPBinding.SOAP12HTTP_BINDING, HTTPBinding.HTTP_BINDING

createDispatch

public abstract <T> Dispatch<T> createDispatch(QName portName,
                             Class<T> type,
                             Service.Mode mode)

Создает a Dispatch экземпляр для использования с объектами выбора пользователя.

Параметры:

portName - Полностью определенное имя для целевой конечной точки службы

type - Класс объекта, используемого для сообщений или полезных нагрузок сообщения. Реализации обязаны поддерживать javax.xml.transform.Source и javax.xml.soap.SOAPMessage.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP. Режим ДОЛЖЕН быть MESSAGE когда тип SOAPMessage.

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException - Если любая ошибка в создании Dispatch объект

См. Также:

Source, SOAPMessage

createDispatch

public abstract <T> Dispatch<T> createDispatch(QName portName,
                             Class<T> type,
                             Service.Mode mode,
                             WebServiceFeature... features)

Создает a Dispatch экземпляр для использования с объектами выбора пользователя.

Параметры:

portName - Полностью определенное имя для целевой конечной точки службы

type - Класс объекта, используемого для сообщений или полезных нагрузок сообщения. Реализации обязаны поддерживать javax.xml.transform.Source и javax.xml.soap.SOAPMessage.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP. Режим ДОЛЖЕН быть MESSAGE когда тип SOAPMessage.

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

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException - Если любая ошибка в создании Dispatch возразите или если опция активируется, который не совместимый с этим портом или неподдерживается.

С тех пор:

JAX-WS 2.1

См. Также:

Source, SOAPMessage, WebServiceFeature

createDispatch

public abstract <T> Dispatch<T> createDispatch(EndpointReference endpointReference,
                             Class<T> type,
                             Service.Mode mode,
                             WebServiceFeature... features)

Создает a Dispatch экземпляр для использования с объектами выбора пользователя. Если есть какие-либо ссылочные параметры в endpointReference, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. endpointReference's адрес ДОЛЖЕН использоваться для вызовов на конечной точке. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование диспетчеризирования соответственно от WSDL, связанного с этим Service экземпляр или от метаданных от endpointReference. Если это Service у экземпляра есть WSDL и endpointReference также имеет WSDL в его метаданных, тогда WSDL от этого экземпляра ДОЛЖЕН использоваться. Если это Service у экземпляра нет WSDL и endpointReference действительно имеет WSDL, тогда WSDL от endpointReference МОЖЕТ использоваться. Реализация ДОЛЖНА быть в состоянии получить portName от endpointReference метаданные.

Этот метод ведет себя то же самое как вызов

 dispatch = service.createDispatch(portName, type, mode, features);
 

где portName получается от WSDL или EndpointReference метаданные.

Параметры:

endpointReference - EndpointReference для целевой конечной точки службы, которая будет вызвана возвращенным Dispatch объект.

type - Класс объекта, привыкшего к сообщениям или полезным нагрузкам сообщения. Реализации обязаны поддерживать javax.xml.transform.Source и javax.xml.soap.SOAPMessage.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP. Режим ДОЛЖЕН быть MESSAGE когда тип SOAPMessage.

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

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException -

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

С тех пор:

JAX-WS 2.1

См. Также:

Source, SOAPMessage, WebServiceFeature

createDispatch

public abstract Dispatch<Object> createDispatch(QName portName,
                              JAXBContext context,
                              Service.Mode mode)

Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты.

Параметры:

portName - Полностью определенное имя для целевой конечной точки службы

context - Контекст JAXB, привыкший к маршальским и немаршальским сообщениям или полезным нагрузкам сообщения.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP.

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException - Если любая ошибка в создании Dispatch объект

См. Также:

JAXBContext

createDispatch

public abstract Dispatch<Object> createDispatch(QName portName,
                              JAXBContext context,
                              Service.Mode mode,
                              WebServiceFeature... features)

Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты.

Параметры:

portName - Полностью определенное имя для целевой конечной точки службы

context - Контекст JAXB, привыкший к маршальским и немаршальским сообщениям или полезным нагрузкам сообщения.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP.

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

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException - Если любая ошибка в создании Dispatch возразите или если опция активируется, который не совместимый с этим портом или неподдерживается.

С тех пор:

JAX-WS 2.1

См. Также:

JAXBContext, WebServiceFeature

createDispatch

public abstract Dispatch<Object> createDispatch(EndpointReference endpointReference,
                              JAXBContext context,
                              Service.Mode mode,
                              WebServiceFeature... features)

Создает a Dispatch экземпляр для использования с JAXB сгенерированные объекты. Если есть какие-либо ссылочные параметры в endpointReference, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. endpointReference's адрес ДОЛЖЕН использоваться для вызовов на конечной точке. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование диспетчеризирования соответственно от WSDL, связанного с этим Service экземпляр или от метаданных от endpointReference. Если это Service у экземпляра есть WSDL и endpointReference также имеет WSDL в его метаданных, тогда WSDL от этого экземпляра ДОЛЖЕН использоваться. Если это Service у экземпляра нет WSDL и endpointReference действительно имеет WSDL, тогда WSDL от endpointReference МОЖЕТ использоваться. Реализация ДОЛЖНА быть в состоянии получить portName от endpointReference метаданные.

Этот метод behavies то же самое как вызов

 dispatch = service.createDispatch(portName, context, mode, features);
 

где portName получается от WSDL или endpointReference метаданные.

Параметры:

endpointReference - EndpointReference для целевой конечной точки службы, которая будет вызвана возвращенным Dispatch объект.

context - Контекст JAXB, привыкший к маршальским и немаршальским сообщениям или полезным нагрузкам сообщения.

mode - Средства управления, диспетчеризируют ли создаваемые экземпляр, являются сообщением или полезной нагрузкой, ориентированной, то есть будет ли пользователь работать с полными сообщениями протокола или передавать полезные нагрузки. Например, при использовании протокола SOAP, этот параметр управляет, будет ли пользователь работать с сообщениями SOAP или содержанием тела SOAP.

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

Возвраты:

Диспетчеризируйте экземпляр

Броски:

WebServiceException -

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

С тех пор:

JAX-WS 2.1

См. Также:

JAXBContext, WebServiceFeature

getServiceName

public abstract QName getServiceName()

Получает имя этой службы.

Возвраты:

Полностью определенное имя этой службы

getPorts

public abstract Iterator<QName> getPorts()

Возвраты Iterator для списка QNames конечных точек службы сгруппировался этой службой

Возвраты:

Возвраты java.util.Iterator с элементами типа javax.xml.namespace.QName

Броски:

WebServiceException - Если у этого класса Службы нет доступа к необходимым метаданным WSDL

getWSDLDocumentLocation

public abstract URL getWSDLDocumentLocation()

Получает расположение документа WSDL для этой Службы.

Возвраты:

URL для расположения документа WSDL для этой службы

getHandlerResolver

public abstract HandlerResolver getHandlerResolver()

Возвращает сконфигурированный преобразователь обработчика.

Возвраты:

HandlerResolver HandlerResolver быть используемым этим Service экземпляр, или null если нет того.

setHandlerResolver

public abstract void setHandlerResolver(HandlerResolver handlerResolver)

Наборы HandlerResolver для этого Service экземпляр.

Однажды преобразователь обработчика, если есть вызовут для каждого прокси или диспетчеризирует экземпляр, который создается, и цепочка обработчика, возвращенная преобразователем, будет установлена на экземпляре.

Параметры:

handlerResolver - HandlerResolver чтобы использовать для всех впоследствии создаваемых проксируют/диспетчеризируют объекты.

См. Также:

HandlerResolver

getExecutor

public abstract Executor getExecutor()

Возвращает исполнителя для этого Serviceэкземпляр. Исполнитель используется для всех асинхронных вызовов, которые требуют обратных вызовов.

Возвраты:

java.util.concurrent.Executor использоваться, чтобы вызвать обратный вызов.

См. Также:

Executor

setExecutor

public abstract void setExecutor(Executor executor)

Устанавливает исполнителя для этого Service экземпляр. Исполнитель используется для всех асинхронных вызовов, которые требуют обратных вызовов.

Параметры:

executor - java.util.concurrent.Executor использоваться, чтобы вызвать обратный вызов.

Броски:

SecurityException - Если экземпляр не поддерживает установку исполнителя для соображений безопасности (например, необходимые полномочия отсутствуют).

См. Также:

Executor