Provider (Java EE 5)

java.lang.Object
  javax.xml.ws.spi.Provider

服务端点可以将 Provider 接口作为 SEI 的动态替代方法实现。要求实现支持 Provider<Source> 和 Provider<SOAPMessage>。 ServiceMode 注释可以用来控制 Provider 实例是收到整个协议消息还是只收到消息有效载荷。

since	JAX-WS 2.0
See also	javax.xml.transform.Source, javax.xml.soap.SOAPMessage, javax.xml.ws.ServiceMode

英文文档：

Service provider for ServiceDelegate and Endpoint objects.

Since:

JAX-WS 2.0

---

Field Summary
static String	JAXWSPROVIDER_PROPERTY           A constant representing the property used to lookup the name of a Provider implementation class.

 

Constructor Summary
protected	Provider()           Creates a new instance of Provider

 

Method Summary
abstract  Endpoint	createAndPublishEndpoint(String address, Object implementor)           Creates and publishes an endpoint object with the specified address and implementation object.
abstract  Endpoint	createEndpoint(String bindingId, Object implementor)           Creates an endpoint object with the provided binding and implementation object.
abstract  ServiceDelegate	createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class serviceClass)           Creates a service delegate object.
static Provider	provider()           Creates a new provider object.

 

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

A constant representing the property used to lookup the name of a Provider implementation class.

See Also:

Constant Field Values

Constructor Detail

英文文档：

Provider

protected Provider()

Creates a new instance of Provider

Method Detail

英文文档：

provider

public static Provider provider()

Creates a new provider object.

The algorithm used to locate the provider subclass to use consists of the following steps:

• If a resource with the name of META-INF/services/javax.xml.ws.spi.Provider exists, then its first line, if present, is used as the UTF-8 encoded name of the implementation class.
• If the $java.home/lib/jaxws.properties file exists and it is readable by the java.util.Properties.load(InputStream) method and it contains an entry whose key is javax.xml.ws.spi.Provider, then the value of that entry is used as the name of the implementation class.
• If a system property with the name javax.xml.ws.spi.Provider is defined, then its value is used as the name of the implementation class.
• Finally, a default implementation class name is used.

---

英文文档：

createServiceDelegate

public abstract ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation,
                                                      QName serviceName,
                                                      Class serviceClass)

Creates a service delegate object.

Parameters:

wsdlDocumentLocation - A URL pointing to the WSDL document for the service, or null if there isn't one.

serviceName - The qualified name of the service.

serviceClass - The service class, which must be either javax.xml.ws.Service or a subclass thereof.

Returns:

The newly created service delegate.

---

英文文档：

createEndpoint

public abstract Endpoint createEndpoint(String bindingId,
                                        Object implementor)

Creates an endpoint object with the provided binding and implementation object.

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.

Returns:

The newly created endpoint.

---

英文文档：

createAndPublishEndpoint

public abstract Endpoint createAndPublishEndpoint(String address,
                                                  Object implementor)

Creates and publishes an endpoint object with the specified address and implementation object.

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.

Returns:

The newly created endpoint.

---

Overview  Package   Class  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.