com.sun.xml.ws.client
Class WSServiceDelegate

java.lang.Object
  javax.xml.ws.spi.ServiceDelegate
      com.sun.xml.ws.api.WSService
          com.sun.xml.ws.client.WSServiceDelegate

All Implemented Interfaces:

Component, ComponentRegistry

public class WSServiceDelegate
extends WSService

Service objects provide the client view of a Web service.

Service acts as a factory of the following:

• Proxies for a target service endpoint.
• Instances of javax.xml.ws.Dispatch for dynamic message-oriented invocation of a remote operation.

The ports available on a service can be enumerated using the getPorts method. Alternatively, you can pass a service endpoint interface to the unary getPort method and let the runtime select a compatible port.

Handler chains for all the objects created by a Service can be set by means of the provided HandlerRegistry.

An Executor may be set on the service in order to gain better control over the threads used to dispatch asynchronous callbacks. For instance, thread pooling with certain parameters can be enabled by creating a ThreadPoolExecutor and registering it with the service.

Since:

JAX-WS 2.0

See Also:

Executor

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.xml.ws.api.WSService

WSService.InitParams

Field Summary

protected static javax.xml.ws.WebServiceFeature[]

EMPTY_FEATURES

Fields inherited from class com.sun.xml.ws.api.WSService

EMPTY_PARAMS, INIT_PARAMS

Constructor Summary

	WSServiceDelegate(javax.xml.transform.Source wsdl, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, javax.xml.ws.WebServiceFeature... features)
protected	WSServiceDelegate(javax.xml.transform.Source wsdl, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, WebServiceFeatureList features)
	WSServiceDelegate(javax.xml.transform.Source wsdl, WSDLService service, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, javax.xml.ws.WebServiceFeature... features)
	WSServiceDelegate(javax.xml.transform.Source wsdl, WSDLService service, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, WebServiceFeatureList features)
	WSServiceDelegate(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, javax.xml.ws.WebServiceFeature... features)
protected	WSServiceDelegate(java.net.URL wsdlDocumentLocation, javax.xml.namespace.QName serviceName, java.lang.Class<? extends javax.xml.ws.Service> serviceClass, WebServiceFeatureList features)

Method Summary

void	addPort(javax.xml.namespace.QName portName, java.lang.String bindingId, java.lang.String endpointAddress)
SEIModel	buildRuntimeModel(javax.xml.namespace.QName serviceName, javax.xml.namespace.QName portName, java.lang.Class portInterface, WSDLPort wsdlPort, WebServiceFeatureList features)
protected org.xml.sax.EntityResolver	createCatalogResolver()
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.ws.EndpointReference endpointReference, java.lang.Class<T> type, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... features)
javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.ws.EndpointReference endpointReference, javax.xml.bind.JAXBContext context, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... features)
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.namespace.QName portName, java.lang.Class<T> aClass, javax.xml.ws.Service.Mode mode)
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.namespace.QName portName, java.lang.Class<T> aClass, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... features)
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.namespace.QName portName, java.lang.Class<T> aClass, javax.xml.ws.Service.Mode mode, WebServiceFeatureList features)
javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.namespace.QName portName, javax.xml.bind.JAXBContext jaxbContext, javax.xml.ws.Service.Mode mode)
javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.namespace.QName portName, javax.xml.bind.JAXBContext jaxbContext, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... webServiceFeatures)
protected javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.namespace.QName portName, javax.xml.bind.JAXBContext jaxbContext, javax.xml.ws.Service.Mode mode, WebServiceFeatureList features)
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.namespace.QName portName, WSEndpointReference wsepr, java.lang.Class<T> aClass, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... features) Works like ServiceDelegate.createDispatch(javax.xml.ws.EndpointReference, java.lang.Class, javax.xml.ws.Service.Mode, javax.xml.ws.WebServiceFeature[]) but it takes the port name separately, so that EPR without embedded metadata can be used.
<T> javax.xml.ws.Dispatch<T>	createDispatch(javax.xml.namespace.QName portName, WSEndpointReference wsepr, java.lang.Class<T> aClass, javax.xml.ws.Service.Mode mode, WebServiceFeatureList features)
javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.namespace.QName portName, WSEndpointReference wsepr, javax.xml.bind.JAXBContext jaxbContext, javax.xml.ws.Service.Mode mode, javax.xml.ws.WebServiceFeature... features) Works like ServiceDelegate.createDispatch(javax.xml.ws.EndpointReference, javax.xml.bind.JAXBContext, javax.xml.ws.Service.Mode, javax.xml.ws.WebServiceFeature[]) but it takes the port name separately, so that EPR without embedded metadata can be used.
protected javax.xml.ws.Dispatch<java.lang.Object>	createDispatch(javax.xml.namespace.QName portName, WSEndpointReference wsepr, javax.xml.bind.JAXBContext jaxbContext, javax.xml.ws.Service.Mode mode, WebServiceFeatureList features)
Container	getContainer() Gets the Container object.
EndpointAddress	getEndpointAddress(javax.xml.namespace.QName qName)
java.util.concurrent.Executor	getExecutor()
javax.xml.ws.handler.HandlerResolver	getHandlerResolver()
<T> T	getPort(java.lang.Class<T> portInterface)
<T> T	getPort(java.lang.Class<T> portInterface, javax.xml.ws.WebServiceFeature... features)
<T> T	getPort(javax.xml.ws.EndpointReference epr, java.lang.Class<T> portInterface, javax.xml.ws.WebServiceFeature... features)
<T> T	getPort(javax.xml.namespace.QName portName, java.lang.Class<T> portInterface)
<T> T	getPort(javax.xml.namespace.QName portName, java.lang.Class<T> portInterface, javax.xml.ws.WebServiceFeature... features)
<T> T	getPort(WSEndpointReference wsepr, java.lang.Class<T> portInterface, javax.xml.ws.WebServiceFeature... features) Works like ServiceDelegate.getPort(EndpointReference, Class, WebServiceFeature...) but takes WSEndpointReference.
protected <T> T	getPort(WSEndpointReference wsepr, javax.xml.namespace.QName portName, java.lang.Class<T> portInterface, WebServiceFeatureList features)
WSDLPort	getPortModel(WSDLService wsdlService, javax.xml.namespace.QName portName) Obtains a WSDLPortImpl with error check.
java.util.Iterator<javax.xml.namespace.QName>	getPorts()
protected java.util.Map<javax.xml.namespace.QName,PortInfo>	getQNameToPortInfoMap()
java.lang.Class	getServiceClass()
javax.xml.namespace.QName	getServiceName()
protected java.lang.reflect.InvocationHandler	getStubHandler(BindingImpl binding, SEIPortInfo eif, WSEndpointReference epr)
java.net.URL	getWSDLDocumentLocation()
WSDLService	getWsdlService()
PortInfo	safeGetPort(javax.xml.namespace.QName portName) Obtains PortInfo for the given name, with error check.
void	setExecutor(java.util.concurrent.Executor executor)
void	setHandlerResolver(javax.xml.ws.handler.HandlerResolver resolver)

Methods inherited from class com.sun.xml.ws.api.WSService

create, create, create, create, getComponents, getSPI, unwrap

Methods inherited from class java.lang.Object

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

Field Detail

EMPTY_FEATURES

protected static final javax.xml.ws.WebServiceFeature[] EMPTY_FEATURES

Constructor Detail

WSServiceDelegate

public WSServiceDelegate(java.net.URL wsdlDocumentLocation,
                         javax.xml.namespace.QName serviceName,
                         java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                         javax.xml.ws.WebServiceFeature... features)

WSServiceDelegate

protected WSServiceDelegate(java.net.URL wsdlDocumentLocation,
                            javax.xml.namespace.QName serviceName,
                            java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                            WebServiceFeatureList features)

WSServiceDelegate

public WSServiceDelegate(@Nullable
                         javax.xml.transform.Source wsdl,
                         @NotNull
                         javax.xml.namespace.QName serviceName,
                         @NotNull
                         java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                         javax.xml.ws.WebServiceFeature... features)

Parameters:

serviceClass - Either Service.class or other generated service-derived classes.

WSServiceDelegate

protected WSServiceDelegate(@Nullable
                            javax.xml.transform.Source wsdl,
                            @NotNull
                            javax.xml.namespace.QName serviceName,
                            @NotNull
                            java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                            WebServiceFeatureList features)

Parameters:

serviceClass - Either Service.class or other generated service-derived classes.

WSServiceDelegate

public WSServiceDelegate(@Nullable
                         javax.xml.transform.Source wsdl,
                         @Nullable
                         WSDLService service,
                         @NotNull
                         javax.xml.namespace.QName serviceName,
                         @NotNull
                         java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                         javax.xml.ws.WebServiceFeature... features)

Parameters:

serviceClass - Either Service.class or other generated service-derived classes.

WSServiceDelegate

public WSServiceDelegate(@Nullable
                         javax.xml.transform.Source wsdl,
                         @Nullable
                         WSDLService service,
                         @NotNull
                         javax.xml.namespace.QName serviceName,
                         @NotNull
                         java.lang.Class<? extends javax.xml.ws.Service> serviceClass,
                         WebServiceFeatureList features)

Parameters:

serviceClass - Either Service.class or other generated service-derived classes.

Method Detail

getQNameToPortInfoMap

protected java.util.Map<javax.xml.namespace.QName,PortInfo> getQNameToPortInfoMap()

createCatalogResolver

protected org.xml.sax.EntityResolver createCatalogResolver()

getExecutor

public java.util.concurrent.Executor getExecutor()

Specified by:

getExecutor in class javax.xml.ws.spi.ServiceDelegate

setExecutor

public void setExecutor(java.util.concurrent.Executor executor)

Specified by:

setExecutor in class javax.xml.ws.spi.ServiceDelegate

getHandlerResolver

public javax.xml.ws.handler.HandlerResolver getHandlerResolver()

Specified by:

getHandlerResolver in class javax.xml.ws.spi.ServiceDelegate

setHandlerResolver

public void setHandlerResolver(javax.xml.ws.handler.HandlerResolver resolver)

Specified by:

setHandlerResolver in class javax.xml.ws.spi.ServiceDelegate

getPort

public <T> T getPort(javax.xml.namespace.QName portName,
                     java.lang.Class<T> portInterface)
          throws javax.xml.ws.WebServiceException

Specified by:

getPort in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

getPort

public <T> T getPort(javax.xml.namespace.QName portName,
                     java.lang.Class<T> portInterface,
                     javax.xml.ws.WebServiceFeature... features)

Specified by:

getPort in class javax.xml.ws.spi.ServiceDelegate

getPort

public <T> T getPort(javax.xml.ws.EndpointReference epr,
                     java.lang.Class<T> portInterface,
                     javax.xml.ws.WebServiceFeature... features)

Specified by:

getPort in class javax.xml.ws.spi.ServiceDelegate

getPort

public <T> T getPort(WSEndpointReference wsepr,
                     java.lang.Class<T> portInterface,
                     javax.xml.ws.WebServiceFeature... features)

Description copied from class: WSService

Works like ServiceDelegate.getPort(EndpointReference, Class, WebServiceFeature...) but takes WSEndpointReference.

Specified by:

getPort in class WSService

getPort

protected <T> T getPort(WSEndpointReference wsepr,
                        javax.xml.namespace.QName portName,
                        java.lang.Class<T> portInterface,
                        WebServiceFeatureList features)

getPort

public <T> T getPort(java.lang.Class<T> portInterface,
                     javax.xml.ws.WebServiceFeature... features)

Specified by:

getPort in class javax.xml.ws.spi.ServiceDelegate

getPort

public <T> T getPort(java.lang.Class<T> portInterface)
          throws javax.xml.ws.WebServiceException

Specified by:

getPort in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

addPort

public void addPort(javax.xml.namespace.QName portName,
                    java.lang.String bindingId,
                    java.lang.String endpointAddress)
             throws javax.xml.ws.WebServiceException

Specified by:

addPort in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
                                                   java.lang.Class<T> aClass,
                                                   javax.xml.ws.Service.Mode mode)
                                        throws javax.xml.ws.WebServiceException

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
                                                   WSEndpointReference wsepr,
                                                   java.lang.Class<T> aClass,
                                                   javax.xml.ws.Service.Mode mode,
                                                   javax.xml.ws.WebServiceFeature... features)

Description copied from class: WSService

Works like ServiceDelegate.createDispatch(javax.xml.ws.EndpointReference, java.lang.Class, javax.xml.ws.Service.Mode, javax.xml.ws.WebServiceFeature[]) but it takes the port name separately, so that EPR without embedded metadata can be used.

Specified by:

createDispatch in class WSService

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
                                                   WSEndpointReference wsepr,
                                                   java.lang.Class<T> aClass,
                                                   javax.xml.ws.Service.Mode mode,
                                                   WebServiceFeatureList features)

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
                                                   java.lang.Class<T> aClass,
                                                   javax.xml.ws.Service.Mode mode,
                                                   javax.xml.ws.WebServiceFeature... features)

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.namespace.QName portName,
                                                   java.lang.Class<T> aClass,
                                                   javax.xml.ws.Service.Mode mode,
                                                   WebServiceFeatureList features)

createDispatch

public <T> javax.xml.ws.Dispatch<T> createDispatch(javax.xml.ws.EndpointReference endpointReference,
                                                   java.lang.Class<T> type,
                                                   javax.xml.ws.Service.Mode mode,
                                                   javax.xml.ws.WebServiceFeature... features)

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

safeGetPort

@NotNull
public PortInfo safeGetPort(javax.xml.namespace.QName portName)

Obtains PortInfo for the given name, with error check.

getEndpointAddress

public EndpointAddress getEndpointAddress(javax.xml.namespace.QName qName)

createDispatch

public javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
                                                              javax.xml.bind.JAXBContext jaxbContext,
                                                              javax.xml.ws.Service.Mode mode)
                                                       throws javax.xml.ws.WebServiceException

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

createDispatch

public javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
                                                              WSEndpointReference wsepr,
                                                              javax.xml.bind.JAXBContext jaxbContext,
                                                              javax.xml.ws.Service.Mode mode,
                                                              javax.xml.ws.WebServiceFeature... features)

Description copied from class: WSService

Works like ServiceDelegate.createDispatch(javax.xml.ws.EndpointReference, javax.xml.bind.JAXBContext, javax.xml.ws.Service.Mode, javax.xml.ws.WebServiceFeature[]) but it takes the port name separately, so that EPR without embedded metadata can be used.

Specified by:

createDispatch in class WSService

createDispatch

protected javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
                                                                 WSEndpointReference wsepr,
                                                                 javax.xml.bind.JAXBContext jaxbContext,
                                                                 javax.xml.ws.Service.Mode mode,
                                                                 WebServiceFeatureList features)

getContainer

@NotNull
public Container getContainer()

Description copied from class: WSService

Gets the Container object.

The components inside WSEndpoint uses this reference to communicate with the hosting environment.

Specified by:

getContainer in class WSService

Returns:

always same object. If no "real" Container instance is given, Container.NONE will be returned.

createDispatch

public javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
                                                              javax.xml.bind.JAXBContext jaxbContext,
                                                              javax.xml.ws.Service.Mode mode,
                                                              javax.xml.ws.WebServiceFeature... webServiceFeatures)

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

createDispatch

protected javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.namespace.QName portName,
                                                                 javax.xml.bind.JAXBContext jaxbContext,
                                                                 javax.xml.ws.Service.Mode mode,
                                                                 WebServiceFeatureList features)

createDispatch

public javax.xml.ws.Dispatch<java.lang.Object> createDispatch(javax.xml.ws.EndpointReference endpointReference,
                                                              javax.xml.bind.JAXBContext context,
                                                              javax.xml.ws.Service.Mode mode,
                                                              javax.xml.ws.WebServiceFeature... features)

Specified by:

createDispatch in class javax.xml.ws.spi.ServiceDelegate

getServiceName

public javax.xml.namespace.QName getServiceName()

Specified by:

getServiceName in class javax.xml.ws.spi.ServiceDelegate

getServiceClass

public java.lang.Class getServiceClass()

getPorts

public java.util.Iterator<javax.xml.namespace.QName> getPorts()
                                                       throws javax.xml.ws.WebServiceException

Specified by:

getPorts in class javax.xml.ws.spi.ServiceDelegate

Throws:

javax.xml.ws.WebServiceException

getWSDLDocumentLocation

public java.net.URL getWSDLDocumentLocation()

Specified by:

getWSDLDocumentLocation in class javax.xml.ws.spi.ServiceDelegate

getStubHandler

protected java.lang.reflect.InvocationHandler getStubHandler(BindingImpl binding,
                                                             SEIPortInfo eif,
                                                             @Nullable
                                                             WSEndpointReference epr)

getPortModel

@NotNull
public WSDLPort getPortModel(WSDLService wsdlService,
                                     javax.xml.namespace.QName portName)

Obtains a WSDLPortImpl with error check.

Returns:

guaranteed to be non-null.

buildRuntimeModel

public SEIModel buildRuntimeModel(javax.xml.namespace.QName serviceName,
                                  javax.xml.namespace.QName portName,
                                  java.lang.Class portInterface,
                                  WSDLPort wsdlPort,
                                  WebServiceFeatureList features)

getWsdlService

public WSDLService getWsdlService()