JAX-WS API 2.3.1 · javax.xml.ws.spi.Provider

Modifier and Type	Field and Description
private static final String	DEFAULT_JAXWSPROVIDER A constant representing the name of the default `Provider` implementation class.

Access	Constructor and Description
protected	Provider() Creates a new instance of Provider

Method Summary

Modifier and Type	Method and Description
public abstract Endpoint	Returns: The newly created endpoint. createAndPublishEndpoint(String 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. address, Object A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations. implementor) Creates and publishes an endpoint object with the specified address and implementation object.
public Endpoint	Returns: The newly created endpoint. createAndPublishEndpoint(String 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. address, Object A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations. implementor, WebServiceFeature... A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. features) Creates and publishes an endpoint object with the specified address, implementation object and web service features.
public abstract Endpoint	Returns: The newly created endpoint. createEndpoint(String A URI specifying the desired binding (e.g. SOAP/HTTP) bindingId, Object A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations. implementor) Creates an endpoint object with the provided binding and implementation object.
public Endpoint	Returns: The newly created endpoint. createEndpoint(String A URI specifying the desired binding (e.g. SOAP/HTTP) bindingId, Object A service implementation object to which incoming requests will be dispatched. The corresponding class MUST be annotated with all the necessary Web service annotations. implementor, WebServiceFeature... A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. features) Creates an endpoint object with the provided binding, implementation object and web service features.
public Endpoint	Returns: The newly created endpoint. createEndpoint(String A URI specifying the desired binding (e.g. SOAP/HTTP). Can be null. bindingId, Class<?> A service implementation class that MUST be annotated with all the necessary Web service annotations. implementorClass, Invoker that does the actual invocation on the service instance. invoker, WebServiceFeature... A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. features) Creates an endpoint object with the provided binding, implementation class, invoker and web service features.
public abstract ServiceDelegate	Returns: The newly created service delegate. createServiceDelegate(URL A URL pointing to the WSDL document for the service, or `null` if there isn't one. wsdlDocumentLocation, QName The qualified name of the service. serviceName, Class<? extends Service> The service class, which MUST be either `javax.xml.ws.Service` or a subclass thereof. serviceClass) Creates a service delegate object.
public ServiceDelegate	Returns: The newly created service delegate. createServiceDelegate(URL A URL pointing to the WSDL document for the service, or `null` if there isn't one. wsdlDocumentLocation, QName The qualified name of the service. serviceName, Class<? extends Service> The service class, which MUST be either `javax.xml.ws.Service` or a subclass thereof. serviceClass, WebServiceFeature... Web Service features that must be configured on the service. If the provider doesn't understand a feature, it must throw a WebServiceException. features) Creates a service delegate object.
public abstract W3CEndpointReference	Returns: the `W3CEndpointReference` created from `serviceName`, `portName`, `metadata`, `wsdlDocumentLocation` and `referenceParameters`. This method never returns `null`. createW3CEndpointReference(String Specifies the address of the target endpoint address, QName Qualified name of the service in the WSDL. serviceName, QName Qualified name of the endpoint in the WSDL. portName, List<Element> A list of elements that should be added to the `W3CEndpointReference` instances `wsa:metadata` element. metadata, String URL for the WSDL document location for the service. wsdlDocumentLocation, List<Element> Reference parameters to be associated with the returned `EndpointReference` instance. referenceParameters) Factory method to create a `W3CEndpointReference`.
public W3CEndpointReference	Returns: the `W3CEndpointReference` created from `serviceName`, `portName`, `metadata`, `wsdlDocumentLocation` and `referenceParameters`. This method never returns `null`. createW3CEndpointReference(String Specifies the address of the target endpoint address, QName the `wsam:InterfaceName` element in the `wsa:Metadata` element. interfaceName, QName Qualified name of the service in the WSDL. serviceName, QName Qualified name of the endpoint in the WSDL. portName, List<Element> A list of elements that should be added to the `W3CEndpointReference` instances `wsa:metadata` element. metadata, String URL for the WSDL document location for the service. wsdlDocumentLocation, List<Element> Reference parameters to be associated with the returned `EndpointReference` instance. referenceParameters, List<Element> extension elements to be associated with the returned `EndpointReference` instance. elements, Map<QName, String> extension attributes to be associated with the returned `EndpointReference` instance. attributes) Factory method to create a `W3CEndpointReference`.
public abstract < Service endpoint interface T> T	Returns: Object Proxy instance that supports the specified service endpoint interface getPort(EndpointReference the EndpointReference that will be invoked by the returned proxy. endpointReference, Class<T> Service endpoint interface serviceEndpointInterface, WebServiceFeature... A list of WebServiceFeatures to configure on the proxy. Supported features not in the `features` parameter will have their default values. features) The getPort method returns a proxy.
public static Provider	Returns: provider object provider() Creates a new provider object.
public abstract EndpointReference	Returns: the `EndpointReference` unmarshalled from `eprInfoset`. This method never returns `null`. readEndpointReference(Source infoset for EndpointReference eprInfoset) read an EndpointReference from the infoset contained in `eprInfoset`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

DEFAULT_JAXWSPROVIDER	back to summary
private static final String DEFAULT_JAXWSPROVIDER A constant representing the name of the default `Provider` implementation class.

Provider	back to summary
protected Provider() Creates a new instance of Provider

Method Detail

createAndPublishEndpoint	back to summary
public abstract Endpoint createAndPublishEndpoint(String address, Object implementor) Creates and publishes an endpoint object with the specified address and implementation object. Parameters address:String 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:Object 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:Endpoint The newly created endpoint.

createAndPublishEndpoint

back to summary

public abstract Endpoint createAndPublishEndpoint(String address, Object implementor)

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

Parameters

address:String: 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:Object: 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:Endpoint

The newly created endpoint.

createAndPublishEndpoint back to summary

createAndPublishEndpoint	back to summary
public Endpoint createAndPublishEndpoint(String address, 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:String 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:Object 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:WebServiceFeature[] A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. Returns:Endpoint The newly created endpoint. Since 1.7, JAX-WS 2.2

public Endpoint createAndPublishEndpoint(String address, 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:String: 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:Object: 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:WebServiceFeature[]: A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.

Returns:Endpoint

The newly created endpoint.

Since

1.7, JAX-WS 2.2

createEndpoint	back to summary
public abstract Endpoint createEndpoint(String bindingId, Object implementor) Creates an endpoint object with the provided binding and implementation object. Parameters bindingId:String A URI specifying the desired binding (e.g. SOAP/HTTP) implementor:Object 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:Endpoint The newly created endpoint.

createEndpoint

back to summary

public abstract Endpoint createEndpoint(String bindingId, Object implementor)

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

Parameters

bindingId:String: A URI specifying the desired binding (e.g. SOAP/HTTP)
implementor:Object: 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:Endpoint

The newly created endpoint.

createEndpoint back to summary

createEndpoint	back to summary
public Endpoint createEndpoint(String bindingId, 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:String A URI specifying the desired binding (e.g. SOAP/HTTP) implementor:Object 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:WebServiceFeature[] A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. Returns:Endpoint The newly created endpoint. Since 1.7, JAX-WS 2.2

public Endpoint createEndpoint(String bindingId, 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:String: A URI specifying the desired binding (e.g. SOAP/HTTP)
implementor:Object: 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:WebServiceFeature[]: A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.

Returns:Endpoint

The newly created endpoint.

Since

1.7, JAX-WS 2.2

createEndpoint back to summary

createEndpoint	back to summary
public Endpoint createEndpoint(String bindingId, 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:String A URI specifying the desired binding (e.g. SOAP/HTTP). Can be null. implementorClass:Class<?> A service implementation class that MUST be annotated with all the necessary Web service annotations. invoker:Invoker that does the actual invocation on the service instance. features:WebServiceFeature[] A list of WebServiceFeatures to configure on the endpoint. Supported features not in the `features` parameter will have their default values. Returns:Endpoint The newly created endpoint. Since 1.7, JAX-WS 2.2

public Endpoint createEndpoint(String bindingId, 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:String: A URI specifying the desired binding (e.g. SOAP/HTTP). Can be null.
implementorClass:Class<?>: A service implementation class that MUST be annotated with all the necessary Web service annotations.
invoker:Invoker: that does the actual invocation on the service instance.
features:WebServiceFeature[]: A list of WebServiceFeatures to configure on the endpoint. Supported features not in the features parameter will have their default values.

Returns:Endpoint

The newly created endpoint.

Since

1.7, JAX-WS 2.2

createServiceDelegate back to summary

createServiceDelegate	back to summary
public abstract ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass) Creates a service delegate object. Parameters wsdlDocumentLocation:URL A URL pointing to the WSDL document for the service, or `null` if there isn't one. serviceName:QName The qualified name of the service. serviceClass:Class<? extends Service> The service class, which MUST be either `javax.xml.ws.Service` or a subclass thereof. Returns:ServiceDelegate The newly created service delegate.

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

Creates a service delegate object.

Parameters

wsdlDocumentLocation:URL: A URL pointing to the WSDL document for the service, or null if there isn't one.
serviceName:QName: The qualified name of the service.
serviceClass:Class<? extends Service>: The service class, which MUST be either javax.xml.ws.Service or a subclass thereof.

Returns:ServiceDelegate

The newly created service delegate.

createServiceDelegate back to summary

createServiceDelegate	back to summary
public ServiceDelegate createServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass, WebServiceFeature... features) Creates a service delegate object. Parameters wsdlDocumentLocation:URL A URL pointing to the WSDL document for the service, or `null` if there isn't one. serviceName:QName The qualified name of the service. serviceClass:Class<? extends Service> The service class, which MUST be either `javax.xml.ws.Service` or a subclass thereof. features:WebServiceFeature[] Web Service features that must be configured on the service. If the provider doesn't understand a feature, it must throw a WebServiceException. Returns:ServiceDelegate The newly created service delegate. Since 1.7, JAX-WS 2.2

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

Creates a service delegate object.

Parameters

wsdlDocumentLocation:URL: A URL pointing to the WSDL document for the service, or null if there isn't one.
serviceName:QName: The qualified name of the service.
serviceClass:Class<? extends Service>: The service class, which MUST be either javax.xml.ws.Service or a subclass thereof.
features:WebServiceFeature[]: Web Service features that must be configured on the service. If the provider doesn't understand a feature, it must throw a WebServiceException.

Returns:ServiceDelegate

The newly created service delegate.

Since

1.7, JAX-WS 2.2

createW3CEndpointReference back to summary

createW3CEndpointReference	back to summary
public abstract W3CEndpointReference createW3CEndpointReference(String address, QName serviceName, QName portName, List<Element> metadata, String wsdlDocumentLocation, List<Element> referenceParameters) Factory method to create a `W3CEndpointReference`. 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` properties. 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:String Specifies the address of the target endpoint serviceName:QName Qualified name of the service in the WSDL. portName:QName Qualified name of the endpoint in the WSDL. metadata:List<Element> A list of elements that should be added to the `W3CEndpointReference` instances `wsa:metadata` element. wsdlDocumentLocation:String URL for the WSDL document location for the service. referenceParameters:List<Element> Reference parameters to be associated with the returned `EndpointReference` instance. Returns:W3CEndpointReference the `W3CEndpointReference` created from `serviceName`, `portName`, `metadata`, `wsdlDocumentLocation` and `referenceParameters`. This method never returns `null`. Exceptions 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 1.6, JAX-WS 2.1

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

Factory method to create a W3CEndpointReference.

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 properties. 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:String: Specifies the address of the target endpoint
serviceName:QName: Qualified name of the service in the WSDL.
portName:QName: Qualified name of the endpoint in the WSDL.
metadata:List<Element>: A list of elements that should be added to the W3CEndpointReference instances wsa:metadata element.
wsdlDocumentLocation:String: URL for the WSDL document location for the service.
referenceParameters:List<Element>: Reference parameters to be associated with the returned EndpointReference instance.

Returns:W3CEndpointReference

the W3CEndpointReference created from serviceName, portName, metadata, wsdlDocumentLocation and referenceParameters. This method never returns null.

Exceptions

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

1.6, JAX-WS 2.1

createW3CEndpointReference back to summary

createW3CEndpointReference	back to summary
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) 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:String Specifies the address of the target endpoint interfaceName:QName the `wsam:InterfaceName` element in the `wsa:Metadata` element. serviceName:QName Qualified name of the service in the WSDL. portName:QName Qualified name of the endpoint in the WSDL. metadata:List<Element> A list of elements that should be added to the `W3CEndpointReference` instances `wsa:metadata` element. wsdlDocumentLocation:String URL for the WSDL document location for the service. referenceParameters:List<Element> Reference parameters to be associated with the returned `EndpointReference` instance. elements:List<Element> extension elements to be associated with the returned `EndpointReference` instance. attributes:Map<QName, String> extension attributes to be associated with the returned `EndpointReference` instance. Returns:W3CEndpointReference the `W3CEndpointReference` created from `serviceName`, `portName`, `metadata`, `wsdlDocumentLocation` and `referenceParameters`. This method never returns `null`. Exceptions 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 1.7, JAX-WS 2.2

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)

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:String: Specifies the address of the target endpoint
interfaceName:QName: the wsam:InterfaceName element in the wsa:Metadata element.
serviceName:QName: Qualified name of the service in the WSDL.
portName:QName: Qualified name of the endpoint in the WSDL.
metadata:List<Element>: A list of elements that should be added to the W3CEndpointReference instances wsa:metadata element.
wsdlDocumentLocation:String: URL for the WSDL document location for the service.
referenceParameters:List<Element>: Reference parameters to be associated with the returned EndpointReference instance.
elements:List<Element>: extension elements to be associated with the returned EndpointReference instance.
attributes:Map<QName, String>: extension attributes to be associated with the returned EndpointReference instance.

Returns:W3CEndpointReference

the W3CEndpointReference created from serviceName, portName, metadata, wsdlDocumentLocation and referenceParameters. This method never returns null.

Exceptions

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

1.7, JAX-WS 2.2

getPort back to summary

getPort	back to summary
public abstract <T> T getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features) The getPort method returns a proxy. If there are any reference parameters in the `endpointReference`, then those reference parameters MUST appear as SOAP headers, indicating them to be reference parameters, on all messages sent to the endpoint. The parameter `serviceEndpointInterface` specifies the service endpoint interface that is supported by the returned proxy. The parameter `endpointReference` specifies the endpoint that will be invoked by the returned proxy. In the implementation of this method, the JAX-WS runtime system takes the responsibility of selecting a protocol binding (and a port) and configuring the proxy accordingly from the WSDL metadata of the `serviceEndpointInterface` and the `EndpointReference`. For this method to successfully return a proxy, WSDL metadata MUST be available and the `endpointReference` MUST contain an implementation understood `serviceName` metadata. Parameters <T> Service endpoint interface endpointReference:EndpointReference the EndpointReference that will be invoked by the returned proxy. serviceEndpointInterface:Class<T> Service endpoint interface features:WebServiceFeature[] A list of WebServiceFeatures to configure on the proxy. Supported features not in the `features` parameter will have their default values. Returns:T Object Proxy instance that supports the specified service endpoint interface Exceptions WebServiceException: If there is an error during creation of the proxy If there is any missing WSDL metadata as required by this method} If this `endpointReference` is illegal If an illegal `serviceEndpointInterface` is specified If a feature is enabled that is not compatible with this port or is unsupported. Since 1.6, JAX-WS 2.1 See Also `WebServiceFeature`

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

The getPort method returns a proxy. If there are any reference parameters in the endpointReference, then those reference parameters MUST appear as SOAP headers, indicating them to be reference parameters, on all messages sent to the endpoint. The parameter serviceEndpointInterface specifies the service endpoint interface that is supported by the returned proxy. The parameter endpointReference specifies the endpoint that will be invoked by the returned proxy. In the implementation of this method, the JAX-WS runtime system takes the responsibility of selecting a protocol binding (and a port) and configuring the proxy accordingly from the WSDL metadata of the serviceEndpointInterface and the EndpointReference. For this method to successfully return a proxy, WSDL metadata MUST be available and the endpointReference MUST contain an implementation understood serviceName metadata.

Parameters

<T>: Service endpoint interface
endpointReference:EndpointReference: the EndpointReference that will be invoked by the returned proxy.
serviceEndpointInterface:Class<T>: Service endpoint interface
features:WebServiceFeature[]: A list of WebServiceFeatures to configure on the proxy. Supported features not in the features parameter will have their default values.

Returns:T

Object Proxy instance that supports the specified service endpoint interface

Exceptions

WebServiceException:

If there is an error during creation of the proxy
If there is any missing WSDL metadata as required by this method}
If this endpointReference is illegal
If an illegal serviceEndpointInterface is specified
If a feature is enabled that is not compatible with this port or is unsupported.

Since

1.6, JAX-WS 2.1

See Also

WebServiceFeature

provider back to summary

provider	back to summary
public static Provider provider() Creates a new provider object. The algorithm used to locate the provider subclass to use consists of the following steps: Use the service-provider loading facilities, defined by the `java.util.ServiceLoader` class, to attempt to locate and load an implementation of `javax.xml.ws.spi.Provider` service using the default loading mechanism. Use the configuration file "jaxws.properties". The file is in standard `java.util.Properties` format and typically located in the `conf` directory of the Java installation. It contains the fully qualified name of the implementation class with the key `javax.xml.ws.spi.Provider`. 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 platform default implementation is used. Returns:Provider provider object

public static Provider provider()

Creates a new provider object.

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

Use the service-provider loading facilities, defined by the java.util.ServiceLoader class, to attempt to locate and load an implementation of javax.xml.ws.spi.Provider service using the default loading mechanism.
Use the configuration file "jaxws.properties". The file is in standard java.util.Properties format and typically located in the conf directory of the Java installation. It contains the fully qualified name of the implementation class with the key javax.xml.ws.spi.Provider.
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 platform default implementation is used.

Returns:Provider: provider object

readEndpointReference back to summary

readEndpointReference	back to summary
public abstract EndpointReference readEndpointReference(Source eprInfoset) read an EndpointReference from the infoset contained in `eprInfoset`. Parameters eprInfoset:Source infoset for EndpointReference Returns:EndpointReference the `EndpointReference` unmarshalled from `eprInfoset`. This method never returns `null`. Exceptions WebServiceException: If there is an error creating the `EndpointReference` from the specified `eprInfoset`. NullPointerException: If the `null` `eprInfoset` value is given. Since 1.6, JAX-WS 2.1

public abstract EndpointReference readEndpointReference(Source eprInfoset)

read an EndpointReference from the infoset contained in eprInfoset.

Parameters

eprInfoset:Source: infoset for EndpointReference

Returns:EndpointReference

the EndpointReference unmarshalled from eprInfoset. This method never returns null.

Exceptions

WebServiceException:: If there is an error creating the EndpointReference from the specified eprInfoset.
NullPointerException:: If the null eprInfoset value is given.

Since

1.6, JAX-WS 2.1

public abstract Class Provider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail