javax.xml.ws.spi

Class Provider

java.lang.Object

javax.xml.ws.spi.Provider

public abstract class Provider
extends Object

对于 ServiceDelegate和 Endpoint对象服务提供商。

从以下版本开始：

JAX-WS 2

Field Summary

Fields

Modifier and Type	Field and Description
static String	JAXWSPROVIDER_PROPERTY 恒定代表用来查找一个 Provider实现类的名称的属性。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	Provider() 创建提供程序的一个新实例

方法摘要

Modifier and Type	Method and Description
abstract Endpoint	createAndPublishEndpoint(String address, Object implementor) 使用指定的地址和实现对象创建和发布一个端点对象。
Endpoint	createAndPublishEndpoint(String address, Object implementor, WebServiceFeature... features) 创建并发布一个端点对象，该对象具有指定的地址、实现对象和Web服务功能。
Endpoint	createEndpoint(String bindingId, 类<?> implementorClass, Invoker invoker, WebServiceFeature... features) 创建一个端点对象提供的绑定，实现类，调用Web服务的特点。
abstract Endpoint	createEndpoint(String bindingId, Object implementor) 使用所提供的绑定和实现对象创建一个端点对象。
Endpoint	createEndpoint(String bindingId, Object implementor, WebServiceFeature... features) 创建一个端点对象，该对象具有提供的绑定、实现对象和Web服务功能。
abstract ServiceDelegate	createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, 类<? extends Service> serviceClass) 创建一个服务委托对象。
ServiceDelegate	createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, 类<? extends Service> serviceClass, WebServiceFeature... features) 创建一个服务委托对象。
abstract W3CEndpointReference	createW3CEndpointReference(String address, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters) 工厂方法来创建一个 W3CEndpointReference。
W3CEndpointReference	createW3CEndpointReference(String address, QName interfaceName, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters, List<Element> elements, Map<QName,String> attributes) 工厂方法来创建一个 W3CEndpointReference。
abstract <T> T	getPort(EndpointReference endpointReference, 类<T> serviceEndpointInterface, WebServiceFeature... features) getPort方法返回一个代理。
static Provider	provider() 创建一个新的提供程序对象。
abstract EndpointReference	readEndpointReference(Source eprInfoset) 读取包含在 eprInfoset InfoSet的endpointreference。

Methods inherited from class java.lang.Object

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

Field Detail

JAXWSPROVIDER_PROPERTY

public static final String JAXWSPROVIDER_PROPERTY

恒定代表用来查找一个 Provider实现类的名称的属性。

另请参见：

Constant Field Values

Constructor Detail

Provider

protected Provider()

创建提供程序的一个新实例

方法详细信息

provider

public static Provider provider()

创建一个新的提供程序对象。

用于定位提供者子类使用的算法包括以下步骤：

• 如果有META-INF/services/javax.xml.ws.spi.Provider名称资源存在，那么它的第一行，如果存在，作为UTF-8编码的实现类的名称。
• 如果java.home/lib/jaxws.properties美元文件存在并且是可读的java.util.Properties.load(InputStream)方法，它包含一个输入的关键是javax.xml.ws.spi.Provider，然后该条目作为实现类名称的价值。
• 如果一名javax.xml.ws.spi.Provider系统性的定义，那么它的价值是作为实现类的名称。
• 最后，使用一个默认的实现类名称。

createServiceDelegate

public abstract ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation,
                                                      QName serviceName,
                                                      类<? extends Service> serviceClass)

创建一个服务委托对象。

参数

wsdlDocumentLocation -一个URL指向WSDL文件的服务，或 null如果没有。

serviceName -服务的名称。

serviceClass -服务类，它必须是 javax.xml.ws.Service或子类的方法。

结果

新创建的服务委托。

createServiceDelegate

public ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation,
                                             QName serviceName,
                                             类<? extends Service> serviceClass,
                                             WebServiceFeature... features)

创建一个服务委托对象。

参数

wsdlDocumentLocation -一个URL指向WSDL文件的服务，或 null如果没有。

serviceName -服务的名称。

serviceClass -服务类，它必须是 javax.xml.ws.Service或子类的方法。

features Web服务的功能，必须配置的服务。如果供应商不了解的一个特点，它必须把webserviceexception。

结果

新创建的服务委托。

从以下版本开始：

JAX-WS 2.2

createEndpoint

public abstract Endpoint createEndpoint(String bindingId,
                                        Object implementor)

使用所提供的绑定和实现对象创建一个端点对象。

参数

bindingId -一个URI指定所需的结合（如SOAP／HTTP）

implementor -服务实施对象，传入的请求将出动。相应的类必须用所有必要的Web服务注释注释。

结果

新创建的端点。

createAndPublishEndpoint

public abstract Endpoint createAndPublishEndpoint(String address,
                                                  Object implementor)

使用指定的地址和实现对象创建和发布一个端点对象。

参数

address -一个URI指定要使用的地址和传输协议。一个HTTP URI必须导致肥皂1.1/http结合使用。实现可能支持其他URI方案。

implementor -服务实施对象，传入的请求将出动。相应的类必须用所有必要的Web服务注释注释。

结果

新创建的端点。

readEndpointReference

public abstract EndpointReference readEndpointReference(Source eprInfoset)

读取包含在 eprInfoset InfoSet的endpointreference。

参数

eprInfoset -信息集为endpointreference

结果

它们分散的 EndpointReference从 eprInfoset。此方法不会返回 null。

异常

WebServiceException -如果有指定的 eprInfoset创造 EndpointReference错误。

NullPointerException -如果 null eprInfoset值了。

从以下版本开始：

JAX-WS 2.1

getPort

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

getPort方法返回一个代理。如果有任何的 endpointReference参考参数，那么这些参数必须出现在SOAP头，示意他们可以参考参数，在所有的消息发送到终点。参数 serviceEndpointInterface指定服务端点接口，通过返回的代理支持。参数 endpointReference指定端点，将通过代理调用返回。在这种方法的实施，JAX-WS运行时系统将选择一个协议绑定的责任（和端口）和配置代理相应的 serviceEndpointInterface WSDL元数据和 EndpointReference。这种方法成功地返回一个代理，WSDL元数据必须是可用的和 endpointReference必须包含一个实现理解 serviceName元数据。

参数

endpointReference - endpointreference将由代理调用返回。

serviceEndpointInterface -服务端点接口

features -目录webservicefeatures配置代理。支持的功能不在 features 参数有默认值。

结果

支持支持指定的服务端点接口的对象代理实例

异常

WebServiceException -

• 如果在创建代理过程中出现错误
• 如果有此方法所需的任何丢失的WSDL元数据}
• 如果这endpointReference是非法的
• 如果一个非法serviceEndpointInterface指定
• 如果启用了一个不与此端口兼容或不支持的功能。

从以下版本开始：

JAX-WS 2.1

另请参见：

WebServiceFeature

createW3CEndpointReference

public abstract W3CEndpointReference createW3CEndpointReference(String address,
                                                                QName serviceName,
                                                                QName portName,
                                                                List<Element> metadata,
                                                                String wsdlDocumentLocation,
                                                                List<Element> referenceParameters)

工厂方法来创建一个 W3CEndpointReference。

此方法可用于指定address财产以及任何其它所需的性能，创造一个任何端点W3CEndpointReference。这种方法也可以用来创建一个端点，是由同一个java EE应用发表W3CEndpointReference。这样做的address属性可以提供或该方法能够自动确定address端点，由同一个java EE应用出版，由serviceName和portName性能。如果address是null和serviceName和portName不确定由同一个java EE应用发布一个端点，一个javax.lang.IllegalStateException必须扔。

参数

address -指定目标端点的地址

在WSDL的服务 serviceName限定名称。

在WSDL端点 portName限定名称。

metadata -目录，应该被添加到 W3CEndpointReference实例 wsa:metadata元元素。

wsdlDocumentLocation URL用于Web服务的WSDL文件的位置。

referenceParameters参考参数和返回 EndpointReference实例关联。

结果

从 serviceName， portName， metadata创造 W3CEndpointReference， wsdlDocumentLocation和 referenceParameters。此方法不会返回 null。

异常

IllegalStateException -

• 如果address，serviceName和portName都null。
• 如果serviceName服务null和portName不null。
• 如果address属性null和serviceName和portName不指定由同一个java EE应用发布一个有效的端点。
• 如果serviceNameis不null和不在指定的WSDL目前。
• 如果portName端口不null和不在WSDL服务目前serviceName。
• 如果wsdlDocumentLocation不null并没有表示一个有效的WSDL。

WebServiceException -如果在创建 W3CEndpointReference发生错误。

从以下版本开始：

JAX-WS 2.1

createW3CEndpointReference

public W3CEndpointReference createW3CEndpointReference(String address,
                                                       QName interfaceName,
                                                       QName serviceName,
                                                       QName portName,
                                                       List<Element> metadata,
                                                       String wsdlDocumentLocation,
                                                       List<Element> referenceParameters,
                                                       List<Element> elements,
                                                       Map<QName,String> attributes)

工厂方法来创建一个 W3CEndpointReference。使用这种方法，一个 W3CEndpointReference实例可以扩展元素创建，和属性。 Provider实现必须重写默认实现。

此方法可用于指定address财产以及任何其它所需的性能，创造一个任何端点W3CEndpointReference。这种方法也可以用来创建一个端点，是由同一个java EE应用发表W3CEndpointReference。这样做的address属性可以提供或该方法能够自动确定address端点，由同一个java EE应用出版，由serviceName和portName性能。如果address是null和serviceName和portName不确定由同一个java EE应用发布一个端点，一个javax.lang.IllegalStateException必须扔。

参数

address -指定目标端点的地址

interfaceName在 wsa:Metadata元 wsam:InterfaceName元。

在WSDL的服务 serviceName限定名称。

在WSDL端点 portName限定名称。

metadata -目录，应该被添加到 W3CEndpointReference实例 wsa:metadata元元素。

wsdlDocumentLocation URL用于Web服务的WSDL文件的位置。

referenceParameters参考参数和返回 EndpointReference实例关联。

elements扩展元素被返回的 EndpointReference实例关联。

attributes扩展属性以返回 EndpointReference实例关联。

结果

从 serviceName， portName， metadata创造 W3CEndpointReference， wsdlDocumentLocation和 referenceParameters。这个方法没有返回 null。

异常

IllegalStateException -

• 如果address，serviceName和portName都null。
• 如果serviceName服务null和portName不null。
• 如果address属性null和serviceName和portName不指定由同一个java EE应用发布一个有效的端点。
• 如果serviceNameis不null和不在指定的WSDL目前。
• 如果portName端口不null和不在WSDL服务目前serviceName。
• 如果wsdlDocumentLocation不null并没有表示一个有效的WSDL。
• 如果wsdlDocumentLocation不null但wsdli：wsdllocation命名空间名称无法得到可用的元数据。

WebServiceException -如果在创建 W3CEndpointReference发生错误。

从以下版本开始：

JAX-WS 2.2

createAndPublishEndpoint

public Endpoint createAndPublishEndpoint(String address,
                                         Object implementor,
                                         WebServiceFeature... features)

创建并发布一个端点对象，该对象具有指定的地址、实现对象和Web服务功能。 Provider实现必须重写默认实现。

参数

address -一个URI指定要使用的地址和传输协议。一个HTTP URI必须导致肥皂1.1/http结合使用。实现可能支持其他URI方案。

implementor -服务实施对象，传入的请求将出动。相应的类必须用所有必要的Web服务注释注释。

features -目录webservicefeatures配置的端点。支持的功能不在 features 参数有默认值。

结果

新创建的端点。

从以下版本开始：

JAX-WS 2.2

createEndpoint

public Endpoint createEndpoint(String bindingId,
                               Object implementor,
                               WebServiceFeature... features)

创建一个端点对象，该对象具有提供的绑定、实现对象和Web服务功能。 Provider实现必须重写默认实现。

参数

bindingId -一个URI指定所需的结合（如SOAP／HTTP）

implementor -服务实施对象，传入的请求将出动。相应的类必须用所有必要的Web服务注释注释。

features -目录webservicefeatures配置的端点。支持的功能不在 features 参数有默认值。

结果

新创建的端点。

从以下版本开始：

JAX-WS 2.2

createEndpoint

public Endpoint createEndpoint(String bindingId,
                               类<?> implementorClass,
                               Invoker invoker,
                               WebServiceFeature... features)

创建一个端点对象提供的绑定，实现类，调用Web服务的特点。容器通常使用此创建端点对象。 Provider实现必须重写默认实现。

参数

bindingId -一个URI指定所需的结合（如SOAP／HTTP）。可以为空。

implementorClass -服务实现类必须注明所有必要的Web服务注释。

invoker -对服务实例的实际调用。

features -目录webservicefeatures配置的端点。支持的功能不在 features 参数有默认值。

结果

新创建的端点。

从以下版本开始：

JAX-WS 2.2