Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.xml.ws.spi.Provider
public abstract class Provider
Поставщик услуг для ServiceDelegate
и Endpoint
объекты.
Полевая Сводка | |
---|---|
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 |
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 |
Полевая Деталь |
---|
public static final java.lang.String JAXWSPROVIDER_PROPERTY
Provider
реализация class.
Деталь конструктора |
---|
protected Provider()
Деталь метода |
---|
public static Provider provider()
Алгоритм, используемый, чтобы определить местоположение подкласса провайдера, чтобы использовать, состоит из следующих шагов:
META-INF/services/javax.xml.ws.spi.Provider
существует, тогда его первая строка, если есть используется в качестве UTF-8 закодированное имя реализации class. java.util.Properties.load(InputStream)
метод и это содержат запись, ключ которой javax.xml.ws.spi.Provider
, тогда значение той записи используется в качестве имени реализации class. javax.xml.ws.spi.Provider
определяется, тогда его значение используется в качестве имени реализации class.
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
или подкласс этого. 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. public abstract Endpoint createEndpoint(java.lang.String bindingId, java.lang.Object implementor)
bindingId
- URI, определяющий требуемую привязку (например, SOAP/HTTP)implementor
- Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса. public abstract Endpoint createAndPublishEndpoint(java.lang.String address, java.lang.Object implementor)
address
- URI, определяющий адрес и транспорт/протокол, чтобы использовать. http: URI ДОЛЖЕН привести к SOAP 1.1/HTTP-СВЯЗЫВАНИЕ используемый. Реализации могут поддерживать другие схемы URI.implementor
- Реализация службы возражает, которому будут диспетчеризированы входящие запросы. Соответствующий class ДОЛЖЕН быть аннотирован всеми необходимыми аннотациями Веб-сервиса. public abstract EndpointReference readEndpointReference(javax.xml.transform.Source eprInfoset)
eprInfoset
.
eprInfoset
- инфонабор для EndpointReference EndpointReference
неупорядоченный от eprInfoset
. Этот метод никогда не возвращается null
. WebServiceException
- Если есть ошибка, создавая EndpointReference
от указанного eprInfoset
. java.lang.NullPointerException
- Если null
eprInfoset
значение дается.public abstract <T> T getPort(EndpointReference endpointReference, java.lang.Class<T> serviceEndpointInterface, WebServiceFeature... features)
endpointReference
, тогда те ссылочные параметры ДОЛЖНЫ появиться как заголовки SOAP, указывая на них, чтобы быть ссылочными параметрами, на всех сообщениях, отправленных конечной точке. Параметр serviceEndpointInterface
определяет интерфейс конечной точки службы, который поддерживается возвращенным прокси. Параметр endpointReference
определяет конечную точку, которая будет вызвана возвращенным прокси. В реализации этого метода система времени выполнения JAX-WS берет на себя ответственность выбора привязки протокола (и порт) и конфигурирование прокси соответственно от метаданных WSDL serviceEndpointInterface
и EndpointReference
. Для этого метода, чтобы успешно возвратить прокси, метаданные WSDL ДОЛЖНЫ быть доступными и endpointReference
ДОЛЖЕН содержать понятую реализацию serviceName
метаданные.
endpointReference
- EndpointReference, который будет вызван возвращенным прокси.serviceEndpointInterface
- Интерфейс конечной точки службыfeatures
- Список WebServiceFeatures, чтобы сконфигурировать на прокси. Поддерживавшие функции не в features
у параметра будут их значения по умолчанию. WebServiceException
- endpointReference
недопустимо serviceEndpointInterface
определяется WebServiceFeature
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)
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
serviceName
is 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
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)
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.
address
- Specifies the address of the target endpointinterfaceName
- 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. 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
serviceName
is 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
public Endpoint createAndPublishEndpoint(java.lang.String address, java.lang.Object implementor, WebServiceFeature... features)
Provider
implementations must override the default implementation.
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. public Endpoint createEndpoint(java.lang.String bindingId, java.lang.Object implementor, WebServiceFeature... features)
Provider
implementations must override the default implementation.
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. public Endpoint createEndpoint(java.lang.String bindingId, java.lang.Class<?> implementorClass, Invoker invoker, WebServiceFeature... features)
Provider
implementations must override the default implementation.
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.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
SUMMARY: NESTED | ПОЛЕ | CONSTR | МЕТОД | DETAIL: ПОЛЕ | CONSTR | МЕТОД |
Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to
Generated on 10-February-2011 12:41