Spec-Zone .ru
спецификации, руководства, описания, API


javax.xml.ws.spi
Провайдер класса

java.lang.Object
  расширенный javax.xml.ws.spi.Provider

public abstract class Provider
расширяет java.lang. Объект

Поставщик услуг для ServiceDelegate и Endpoint объекты.

С тех пор:
JAX-WS 2.0

Полевая Сводка
static java.lang.String JAXWSPROVIDER_PROPERTY
          Постоянное представление свойства, привыкшего к поиску имя a Provider реализация class.
 
Сводка конструктора
protected Provider()
          Создает новый экземпляр Провайдера
 
Сводка метода
abstract  Endpoint createAndPublishEndpoint(java.lang.String address, java.lang.Object implementor)
          Создает и публикует объект конечной точки с указанным адресом и объект реализации.
 Конечная точка createAndPublishEndpoint(java.lang.String address, java.lang.Object implementor, WebServiceFeature... features)
          Создает и публикует объект конечной точки с указанным адресом, объект реализации и функции веб-сервиса.
 Конечная точка createEndpoint(java.lang.String bindingId, java.lang.Class<?> implementorClass, Invoker invoker, WebServiceFeature... features)
          Создает объект конечной точки с обеспеченной привязкой, реализацией class, invoker и функции веб-сервиса.
abstract  Endpoint createEndpoint(java.lang.String bindingId, java.lang.Object implementor)
          Создает объект конечной точки с обеспеченным объектом привязки и реализации.
 Конечная точка createEndpoint(java.lang.String bindingId, java.lang.Object implementor, WebServiceFeature... features)
          Создает объект конечной точки с обеспеченной привязкой, объект реализации и функции веб-сервиса.
abstract  ServiceDelegate createServiceDelegate(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName, java.lang.Class<? extends Service> serviceClass)
          Создает объект делегата службы.
 ServiceDelegate createServiceDelegate(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName, java.lang.Class<? extends Service> serviceClass, WebServiceFeature... features)
          Создает объект делегата службы.
abstract  W3CEndpointReference createW3CEndpointReference(java.lang.String address, javax.xml.namespace.QName serviceName, javax.xml.namespace.QName portName, java.util.List<org.w3c.dom.Element> metadata, java.lang.String wsdlDocumentLocation, java.util.List<org.w3c.dom.Element> referenceParameters)
          Метод фабрики, чтобы создать a W3CEndpointReference.
 W3CEndpointReference createW3CEndpointReference(java.lang.String address, javax.xml.namespace.QName interfaceName, javax.xml.namespace.QName serviceName, javax.xml.namespace.QName portName, java.util.List<org.w3c.dom.Element> metadata, java.lang.String wsdlDocumentLocation, java.util.List<org.w3c.dom.Element> referenceParameters, java.util.List<org.w3c.dom.Element> elements, java.util.Map<javax.xml.namespace.QName,java.lang.String> attributes)
          Метод фабрики, чтобы создать a W3CEndpointReference.
abstract
<T> T
getPort(EndpointReference endpointReference, java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features)
          getPort метод возвращает прокси.
static Provider provider()
          Создает новый объект провайдера.
abstract  EndpointReference readEndpointReference(javax.xml.transform.Source eprInfoset)
          считайте EndpointReference из инфонабора, содержавшегося в eprInfoset.
 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

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

JAXWSPROVIDER_PROPERTY

public static final java.lang.String JAXWSPROVIDER_PROPERTY
Постоянное представление свойства, привыкшего к поиску имя a Provider реализация class.

См. Также:
Постоянные Значения полей
Деталь конструктора

Провайдер

protected Provider()
Создает новый экземпляр Провайдера

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

провайдер

public static Provider provider()
Создает новый объект провайдера.

Алгоритм, используемый, чтобы определить местоположение подкласса провайдера, чтобы использовать, состоит из следующих шагов:


createServiceDelegate

public abstract ServiceDelegate createServiceDelegate(java.net.URL wsdlDocumentLocation,
                                                      javax.xml.namespace.QName serviceName,
                                                      java.lang.Class<? extends Service> serviceClass)
Создает объект делегата службы.

Параметры:
wsdlDocumentLocation - URL, указывающий на документ WSDL для службы, или null если нет того.
serviceName - Полностью определенное имя службы.
serviceClass - class службы, который ДОЛЖЕН быть также javax.xml.ws.Service или подкласс этого.
Возвраты:
Недавно создаваемый делегат службы.

createServiceDelegate

public ServiceDelegate createServiceDelegate(java.net.URL wsdlDocumentLocation,
                                             javax.xml.namespace.QName serviceName,
                                             java.lang.Class<? extends Service> serviceClass,
                                             WebServiceFeature... features)
Создает объект делегата службы.

Параметры:
wsdlDocumentLocation - URL, указывающий на документ WSDL для службы, или null если нет того.
serviceName - Полностью определенное имя службы.
serviceClass - class службы, который ДОЛЖЕН быть также javax.xml.ws.Service или подкласс этого.
features - Функции Веб-сервиса, которые должны быть сконфигурированы на службе. Если провайдер не понимает функцию, он должен бросить WebServiceException.
Возвраты:
Недавно создаваемый делегат службы.
С тех пор:
JAX-WS 2.2

createEndpoint

public abstract Endpoint createEndpoint(java.lang.String bindingId,
                                        java.lang.Object implementor)
Создает объект конечной точки с обеспеченным объектом привязки и реализации.

Параметры:
bindingId - URI, определяющий требуемую привязку (например, SOAP/HTTP)
implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.
Возвраты:
Недавно создаваемая конечная точка.

createAndPublishEndpoint

public abstract Endpoint createAndPublishEndpoint(java.lang.String address,
                                                  java.lang.Object implementor)
Создает и публикует объект конечной точки с указанным адресом и объект реализации.

Параметры:
address - URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.
implementor - Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса.
Возвраты:
Недавно создаваемая конечная точка.

readEndpointReference

public abstract EndpointReference readEndpointReference(javax.xml.transform.Source eprInfoset)
считайте EndpointReference из инфонабора, содержавшегося в eprInfoset.

Параметры:
eprInfoset - инфонабор для EndpointReference
Возвраты:
EndpointReference неупорядоченный от eprInfoset. Этот метод никогда не возвращается null.
Броски:
WebServiceException - Если есть ошибка, создавая EndpointReference от указанного eprInfoset.
java.lang.NullPointerException - Если null eprInfoset значение дается.
С тех пор:
JAX-WS 2.1

getPort

public abstract <T> T getPort(EndpointReference endpointReference,
                              java.lang.Class<T> serviceEndpointInterface,
                              WebServiceFeature... features)
getPort метод возвращает прокси. Если есть какие-либо ссылочные параметры в endpointReference, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. Параметр serviceEndpointInterface определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. Параметр endpointReference определяет конечную точку, которая будет вызвана возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно от метаданных WSDL serviceEndpointInterface и EndpointReference. Для этого метода, чтобы успешно возвратить прокси, метаданные WSDL ДОЛЖНЫ быть доступными и endpointReference ДОЛЖЕН содержать понятую реализацию serviceName метаданные.

Параметры:
endpointReference - EndpointReference, который будет вызван возвращенным прокси.
serviceEndpointInterface - Интерфейс конечной точки службы
features - Список WebServiceFeatures, чтобы сконфигурировать на прокси. Поддерживавшие функции не в features у параметра будут их значения по умолчанию.
Возвраты:
Объектный экземпляр Прокси, который поддерживает указанный интерфейс конечной точки службы
Броски:
WebServiceException -
  • Если есть ошибка во время создания прокси
  • Если есть какие-либо недостающие метаданные WSDL как требуется этим методом}
  • Если это endpointReference недопустимо
  • Если недопустимое serviceEndpointInterface определяется
  • Если опция активируется, который не совместимый с этим портом или неподдерживается.
С тех пор:
JAX-WS 2.1
См. Также:
WebServiceFeature

createW3CEndpointReference

public abstract W3CEndpointReference createW3CEndpointReference(java.lang.String address,
                                                                javax.xml.namespace.QName serviceName,
                                                                javax.xml.namespace.QName portName,
                                                                java.util.List<org.w3c.dom.Element> metadata,
                                                                java.lang.String wsdlDocumentLocation,
                                                                java.util.List<org.w3c.dom.Element> referenceParameters)
Метод фабрики, чтобы создать a W3CEndpointReference.

Этот метод может использоваться, чтобы создать a W3CEndpointReference для любой конечной точки, определяя address свойство наряду с любыми другими требуемыми свойствами. Этот метод может также использоваться, чтобы создать a W3CEndpointReference для конечной точки, которая публикуется тем же самым приложением EE Java. Сделать так address свойство может быть обеспечено, или этот метод может автоматически определить address из конечной точки, которая публикуется тем же самым приложением EE Java и идентифицируется serviceName и portName propeties. Если address null и serviceName и portName не идентифицируйте конечную точку, опубликованную тем же самым приложением EE Java, a javax.lang.IllegalStateException ДОЛЖЕН быть брошен.

Параметры:
address - Определяет адрес целевой конечной точки
serviceName - Полностью определенное имя службы в WSDL.
portName - Полностью определенное имя конечной точки в WSDL.
metadata - Список элементов, которые должны быть добавлены к W3CEndpointReference экземпляры wsa:metadata элемент.
wsdlDocumentLocation - URL для расположения документа WSDL для службы.
referenceParameters - Ссылочные параметры, которые будут связаны с возвращенным EndpointReference экземпляр.
Возвраты:
W3CEndpointReference created from serviceName, portName, metadata, wsdlDocumentLocation and referenceParameters. This method never returns null.
Throws:
java.lang.IllegalStateException -
  • If the address, serviceName and portName are all null.
  • If the serviceName service is null and the portName> is NOT null.
  • If the address property is null and the serviceName and portName do not specify a valid endpoint published by the same Java EE application.
  • If the serviceNameis NOT null and is not present in the specified WSDL.
  • If the portName port is not null and it is not present in serviceName service in the WSDL.
  • If the wsdlDocumentLocation is NOT null and does not represent a valid WSDL.
WebServiceException - If an error occurs while creating the W3CEndpointReference.
Since:
JAX-WS 2.1

createW3CEndpointReference

public W3CEndpointReference createW3CEndpointReference(java.lang.String address,
                                                       javax.xml.namespace.QName interfaceName,
                                                       javax.xml.namespace.QName serviceName,
                                                       javax.xml.namespace.QName portName,
                                                       java.util.List<org.w3c.dom.Element> metadata,
                                                       java.lang.String wsdlDocumentLocation,
                                                       java.util.List<org.w3c.dom.Element> referenceParameters,
                                                       java.util.List<org.w3c.dom.Element> elements,
                                                       java.util.Map<javax.xml.namespace.QName,java.lang.String> attributes)
Factory method to create a W3CEndpointReference. Using this method, a W3CEndpointReference instance can be created with extension elements, and attributes. Provider implementations must override the default implementation.

This method can be used to create a W3CEndpointReference for any endpoint by specifying the address property along with any other desired properties. This method can also be used to create a W3CEndpointReference for an endpoint that is published by the same Java EE application. To do so the address property can be provided or this method can automatically determine the address of an endpoint that is published by the same Java EE application and is identified by the serviceName and portName propeties. If the address is null and the serviceName and portName do not identify an endpoint published by the same Java EE application, a javax.lang.IllegalStateException MUST be thrown.

Parameters:
address - Specifies the address of the target endpoint
interfaceName - the wsam:InterfaceName element in the wsa:Metadata element.
serviceName - Qualified name of the service in the WSDL.
portName - Qualified name of the endpoint in the WSDL.
metadata - A list of elements that should be added to the W3CEndpointReference instances wsa:metadata element.
wsdlDocumentLocation - URL for the WSDL document location for the service.
referenceParameters - Reference parameters to be associated with the returned EndpointReference instance.
elements - extension elements to be associated with the returned EndpointReference instance.
attributes - extension attributes to be associated with the returned EndpointReference instance.
Returns:
the W3CEndpointReference created from serviceName, portName, metadata, wsdlDocumentLocation and referenceParameters. This method never returns null.
Throws:
java.lang.IllegalStateException -
  • If the address, serviceName and portName are all null.
  • If the serviceName service is null and the portName> is NOT null.
  • If the address property is null and the serviceName and portName do not specify a valid endpoint published by the same Java EE application.
  • If the serviceNameis NOT null and is not present in the specified WSDL.
  • If the portName port is not null and it is not present in serviceName service in the WSDL.
  • If the wsdlDocumentLocation is NOT null and does not represent a valid WSDL.
  • If the wsdlDocumentLocation is NOT null but wsdli:wsdlLocation's namespace name cannot be got from the available metadata.
WebServiceException - If an error occurs while creating the W3CEndpointReference.
Since:
JAX-WS 2.2

createAndPublishEndpoint

public Endpoint createAndPublishEndpoint(java.lang.String address,
                                         java.lang.Object implementor,
                                         WebServiceFeature... features)
Creates and publishes an endpoint object with the specified address, implementation object and web service features. Provider implementations must override the default implementation.

Parameters:
address - A URI specifying the address and transport/protocol to use. A http: URI MUST result in the SOAP 1.1/HTTP binding being used. Implementations may support other URI schemes.
implementor - A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations.
features - A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.
Returns:
The newly created endpoint.
Since:
JAX-WS 2.2

createEndpoint

public Endpoint createEndpoint(java.lang.String bindingId,
                               java.lang.Object implementor,
                               WebServiceFeature... features)
Creates an endpoint object with the provided binding, implementation object and web service features. Provider implementations must override the default implementation.

Parameters:
bindingId - A URI specifying the desired binding (e.g. SOAP/HTTP)
implementor - A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations.
features - A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.
Returns:
The newly created endpoint.
Since:
JAX-WS 2.2

createEndpoint

public Endpoint createEndpoint(java.lang.String bindingId,
                               java.lang.Class<?> implementorClass,
                               Invoker invoker,
                               WebServiceFeature... features)
Creates an endpoint object with the provided binding, implementation class, invoker and web service features. Containers typically use this to create Endpoint objects. Provider implementations must override the default implementation.

Parameters:
bindingId - A URI specifying the desired binding (e.g. SOAP/HTTP). Can be null.
implementorClass - A service implementation class that MUST be annotated with all the necessary Web service annotations.
invoker - that does the actual invocation on the service instance.
features - A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.
Returns:
The newly created endpoint.
Since:
JAX-WS 2.2


Представьте ошибку или функцию

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41

free hit counter