ServiceDelegate (Java Platform SE 8 ) (original) (raw)

java.lang.Object
- javax.xml.ws.spi.ServiceDelegate

public abstract class ServiceDelegate
extends Object
Since:
JAX-WS 2.0
See Also:
Service, Provider

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ServiceDelegate()

Method Summary

All Methods Instance Methods Abstract Methods

Modifier and Type	Method	Description
abstract void	addPort(QName portName,String bindingId,String endpointAddress)	Creates a new port for the service.
abstract Dispatch	createDispatch(EndpointReference endpointReference,Class type,Service.Mode mode,WebServiceFeature... features)	Creates a Dispatch instance for use with objects of the user's choosing.
abstract Dispatch<Object>	createDispatch(EndpointReference endpointReference,JAXBContext context,Service.Mode mode,WebServiceFeature... features)	Creates a Dispatch instance for use with JAXB generated objects.
abstract Dispatch	createDispatch(QName portName,Class type,Service.Mode mode)	Creates a Dispatch instance for use with objects of the user's choosing.
abstract Dispatch	createDispatch(QName portName,Class type,Service.Mode mode,WebServiceFeature... features)	Creates a Dispatch instance for use with objects of the user's choosing.
abstract Dispatch<Object>	createDispatch(QName portName,JAXBContext context,Service.Mode mode)	Creates a Dispatch instance for use with JAXB generated objects.
abstract Dispatch<Object>	createDispatch(QName portName,JAXBContext context,Service.Mode mode,WebServiceFeature... features)	Creates a Dispatch instance for use with JAXB generated objects.
abstract Executor	getExecutor()	Returns the executor for this Serviceinstance.
abstract HandlerResolver	getHandlerResolver()	Returns the configured handler resolver.
abstract T	getPort(Class serviceEndpointInterface)	The getPort method returns a proxy.
abstract T	getPort(Class serviceEndpointInterface,WebServiceFeature... features)	The getPort method returns a proxy.
abstract T	getPort(EndpointReference endpointReference,Class serviceEndpointInterface,WebServiceFeature... features)	The getPort method returns a proxy.
abstract T	getPort(QName portName,Class serviceEndpointInterface)	The getPort method returns a proxy.
abstract T	getPort(QName portName,Class serviceEndpointInterface,WebServiceFeature... features)	The getPort method returns a proxy.
abstract Iterator<QName>	getPorts()	Returns an Iterator for the list ofQNames of service endpoints grouped by this service
abstract QName	getServiceName()	Gets the name of this service.
abstract URL	getWSDLDocumentLocation()	Gets the location of the WSDL document for this Service.
abstract void	setExecutor(Executor executor)	Sets the executor for this Service instance.
abstract void	setHandlerResolver(HandlerResolver handlerResolver)	Sets the HandlerResolver for this Service instance.

   * ### Methods inherited from class java.lang.[Object](../../../../java/lang/Object.html "class in java.lang")  
   `[clone](../../../../java/lang/Object.html#clone--), [equals](../../../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../../../java/lang/Object.html#finalize--), [getClass](../../../../java/lang/Object.html#getClass--), [hashCode](../../../../java/lang/Object.html#hashCode--), [notify](../../../../java/lang/Object.html#notify--), [notifyAll](../../../../java/lang/Object.html#notifyAll--), [toString](../../../../java/lang/Object.html#toString--), [wait](../../../../java/lang/Object.html#wait--), [wait](../../../../java/lang/Object.html#wait-long-), [wait](../../../../java/lang/Object.html#wait-long-int-)`

Constructor Detail

 * #### ServiceDelegate  
 protected ServiceDelegate()

Method Detail

* #### getPort  
public abstract <T> T getPort([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                              [Class](../../../../java/lang/Class.html "class in java.lang")<T> serviceEndpointInterface)  
The `getPort` method returns a proxy. A service client uses this proxy to invoke operations on the target service endpoint. The `serviceEndpointInterface` specifies the service endpoint interface that is supported by the created dynamic proxy instance.  
Parameters:  
`portName` \- Qualified name of the service endpoint in the WSDL service description  
`serviceEndpointInterface` \- Service endpoint interface supported by the dynamic proxy  
Returns:  
Object Proxy instance that supports the specified service endpoint interface  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- This exception is thrown in the following cases:  
         * If there is an error in creation of the proxy  
         * If there is any missing WSDL metadata as required by this method  
         * If an illegal`serviceEndpointInterface` or `portName` is specified  
See Also:  
[Proxy](../../../../java/lang/reflect/Proxy.html "class in java.lang.reflect"), [InvocationHandler](../../../../java/lang/reflect/InvocationHandler.html "interface in java.lang.reflect")  
* #### getPort  
public abstract <T> T getPort([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                              [Class](../../../../java/lang/Class.html "class in java.lang")<T> serviceEndpointInterface,  
                              [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
The `getPort` method returns a proxy. A service client uses this proxy to invoke operations on the target service endpoint. The `serviceEndpointInterface` specifies the service endpoint interface that is supported by the created dynamic proxy instance.  
Parameters:  
`portName` \- Qualified name of the service endpoint in the WSDL service description  
`serviceEndpointInterface` \- Service endpoint interface supported by the dynamic proxy or instance  
`features` \- A list of WebServiceFeatures to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Object Proxy instance that supports the specified service endpoint interface  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- This exception is thrown in the following cases:  
         * If there is an error in creation of the proxy  
         * If there is any missing WSDL metadata as required by this method  
         * If an illegal`serviceEndpointInterface` or `portName` is specified  
         * If a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[Proxy](../../../../java/lang/reflect/Proxy.html "class in java.lang.reflect"), [InvocationHandler](../../../../java/lang/reflect/InvocationHandler.html "interface in java.lang.reflect"), [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### getPort  
public abstract <T> T getPort([EndpointReference](../../../../javax/xml/ws/EndpointReference.html "class in javax.xml.ws") endpointReference,  
                              [Class](../../../../java/lang/Class.html "class in java.lang")<T> serviceEndpointInterface,  
                              [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
The `getPort` method returns a proxy. The parameter `endpointReference` specifies the endpoint that will be invoked by the returned 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 `endpointReference's` address MUST be used for invocations on the endpoint. The parameter `serviceEndpointInterface` specifies the service endpoint interface that is supported 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 associated with this `Service` instance or from the metadata from the `endpointReference`. If this `Service` instance has a WSDL and the `endpointReference` metadata also has a WSDL, then the WSDL from this instance MUST be used. If this `Service` instance does not have a WSDL and the `endpointReference` does have a WSDL, then the WSDL from the `endpointReference` MAY be used. The returned proxy should not be reconfigured by the client. If this `Service` instance has a known proxy port that matches the information contained in the WSDL, then that proxy is returned, otherwise a WebServiceException is thrown.  
 Calling this method has the same behavior as the following  
 `port = service.getPort(portName, serviceEndpointInterface);`  
       
 where the `portName` is retrieved from the metadata of the `endpointReference` or from the`serviceEndpointInterface` and the WSDL associated with this `Service` instance.  
Parameters:  
`endpointReference` \- The `EndpointReference` for the target service endpoint that will be invoked by the returned proxy.  
`serviceEndpointInterface` \- Service endpoint interface.  
`features` \- A list of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Object Proxy instance that supports the specified service endpoint interface.  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \-  
         * If there is an error during creation of the proxy.  
         * If there is any missing WSDL metadata as required by this method.  
         * If the `endpointReference` metadata does not match the `serviceName` of this`Service` instance.  
         * If a `portName` cannot be extracted from the WSDL or `endpointReference` metadata.  
         * If an invalid`endpointReference` is specified.  
         * If an invalid`serviceEndpointInterface` is specified.  
         * If a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
* #### getPort  
public abstract <T> T getPort([Class](../../../../java/lang/Class.html "class in java.lang")<T> serviceEndpointInterface)  
The `getPort` method returns a proxy. The parameter`serviceEndpointInterface` specifies the service endpoint interface that is supported 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. The returned proxy should not be reconfigured by the client.  
Parameters:  
`serviceEndpointInterface` \- Service endpoint interface  
Returns:  
Object instance that supports the specified service endpoint interface  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \-  
         * If there is an error during creation of the proxy  
         * If there is any missing WSDL metadata as required by this method  
         * If an illegal`serviceEndpointInterface` is specified  
* #### getPort  
public abstract <T> T getPort([Class](../../../../java/lang/Class.html "class in java.lang")<T> serviceEndpointInterface,  
                              [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
The `getPort` method returns a proxy. The parameter`serviceEndpointInterface` specifies the service endpoint interface that is supported 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. The returned proxy should not be reconfigured by the client.  
Parameters:  
`serviceEndpointInterface` \- Service endpoint interface  
`features` \- An array of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Object instance that supports the specified service endpoint interface  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \-  
         * If there is an error during creation of the proxy  
         * If there is any missing WSDL metadata as required by this method  
         * If an illegal`serviceEndpointInterface` is specified  
         * If a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### addPort  
public abstract void addPort([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                             [String](../../../../java/lang/String.html "class in java.lang") bindingId,  
                             [String](../../../../java/lang/String.html "class in java.lang") endpointAddress)  
Creates a new port for the service. Ports created in this way contain no WSDL port type information and can only be used for creating`Dispatch`instances.  
Parameters:  
`portName` \- Qualified name for the target service endpoint  
`bindingId` \- A URI identifier of a binding.  
`endpointAddress` \- Address of the target service endpoint as a URI  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If any error in the creation of the port  
See Also:  
[SOAPBinding.SOAP11HTTP\_BINDING](../../../../javax/xml/ws/soap/SOAPBinding.html#SOAP11HTTP%5FBINDING), [SOAPBinding.SOAP12HTTP\_BINDING](../../../../javax/xml/ws/soap/SOAPBinding.html#SOAP12HTTP%5FBINDING), [HTTPBinding.HTTP\_BINDING](../../../../javax/xml/ws/http/HTTPBinding.html#HTTP%5FBINDING)  
* #### createDispatch  
public abstract <T> [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<T> createDispatch([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                                               [Class](../../../../java/lang/Class.html "class in java.lang")<T> type,  
                                               [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode)  
Creates a `Dispatch` instance for use with objects of the user's choosing.  
Parameters:  
`portName` \- Qualified name for the target service endpoint  
`type` \- The class of object used for messages or message payloads. Implementations are required to support`javax.xml.transform.Source` and `javax.xml.soap.SOAPMessage`.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body. Mode MUST be `MESSAGE` when type is `SOAPMessage`.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If any error in the creation of the `Dispatch` object  
See Also:  
[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform"), [SOAPMessage](../../../../javax/xml/soap/SOAPMessage.html "class in javax.xml.soap")  
* #### createDispatch  
public abstract <T> [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<T> createDispatch([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                                               [Class](../../../../java/lang/Class.html "class in java.lang")<T> type,  
                                               [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode,  
                                               [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
Creates a `Dispatch` instance for use with objects of the user's choosing.  
Parameters:  
`portName` \- Qualified name for the target service endpoint  
`type` \- The class of object used for messages or message payloads. Implementations are required to support`javax.xml.transform.Source` and `javax.xml.soap.SOAPMessage`.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body. Mode MUST be `MESSAGE` when type is `SOAPMessage`.  
`features` \- A list of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If any error in the creation of the `Dispatch` object or if a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform"), [SOAPMessage](../../../../javax/xml/soap/SOAPMessage.html "class in javax.xml.soap"), [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### createDispatch  
public abstract <T> [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<T> createDispatch([EndpointReference](../../../../javax/xml/ws/EndpointReference.html "class in javax.xml.ws") endpointReference,  
                                               [Class](../../../../java/lang/Class.html "class in java.lang")<T> type,  
                                               [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode,  
                                               [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
Creates a `Dispatch` instance for use with objects of the user's choosing. 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 `endpointReference's` address MUST be used for invocations on the endpoint. 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 dispatch accordingly from the WSDL associated with this `Service` instance or from the metadata from the `endpointReference`. If this `Service` instance has a WSDL and the `endpointReference` also has a WSDL in its metadata, then the WSDL from this instance MUST be used. If this `Service` instance does not have a WSDL and the `endpointReference` does have a WSDL, then the WSDL from the `endpointReference` MAY be used. An implementation MUST be able to retrieve the `portName` from the`endpointReference` metadata.  
 This method behaves the same as calling  
 `dispatch = service.createDispatch(portName, type, mode, features);`  
       
 where the `portName` is retrieved from the WSDL or `EndpointReference` metadata.  
Parameters:  
`endpointReference` \- The `EndpointReference` for the target service endpoint that will be invoked by the returned `Dispatch` object.  
`type` \- The class of object used to messages or message payloads. Implementations are required to support`javax.xml.transform.Source` and `javax.xml.soap.SOAPMessage`.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body. Mode MUST be `MESSAGE` when type is `SOAPMessage`.  
`features` \- An array of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \-  
         * If there is any missing WSDL metadata as required by this method.  
         * If the `endpointReference` metadata does not match the `serviceName` or `portName` of a WSDL associated with this `Service` instance.  
         * If the `portName` cannot be determined from the `EndpointReference` metadata.  
         * If any error in the creation of the `Dispatch` object.  
         * If a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform"), [SOAPMessage](../../../../javax/xml/soap/SOAPMessage.html "class in javax.xml.soap"), [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### createDispatch  
public abstract [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<[Object](../../../../java/lang/Object.html "class in java.lang")> createDispatch([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                                                [JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind") context,  
                                                [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode)  
Creates a `Dispatch` instance for use with JAXB generated objects.  
Parameters:  
`portName` \- Qualified name for the target service endpoint  
`context` \- The JAXB context used to marshall and unmarshall messages or message payloads.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If any error in the creation of the `Dispatch` object  
See Also:  
[JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind")  
* #### createDispatch  
public abstract [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<[Object](../../../../java/lang/Object.html "class in java.lang")> createDispatch([QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") portName,  
                                                [JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind") context,  
                                                [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode,  
                                                [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
Creates a `Dispatch` instance for use with JAXB generated objects.  
Parameters:  
`portName` \- Qualified name for the target service endpoint  
`context` \- The JAXB context used to marshall and unmarshall messages or message payloads.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body.  
`features` \- A list of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If any error in the creation of the `Dispatch` object or if a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind"), [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### createDispatch  
public abstract [Dispatch](../../../../javax/xml/ws/Dispatch.html "interface in javax.xml.ws")<[Object](../../../../java/lang/Object.html "class in java.lang")> createDispatch([EndpointReference](../../../../javax/xml/ws/EndpointReference.html "class in javax.xml.ws") endpointReference,  
                                                [JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind") context,  
                                                [Service.Mode](../../../../javax/xml/ws/Service.Mode.html "enum in javax.xml.ws") mode,  
                                                [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")... features)  
Creates a `Dispatch` instance for use with JAXB generated objects. 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 `endpointReference's` address MUST be used for invocations on the endpoint. 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 dispatch accordingly from the WSDL associated with this `Service` instance or from the metadata from the `endpointReference`. If this `Service` instance has a WSDL and the `endpointReference` also has a WSDL in its metadata, then the WSDL from this instance MUST be used. If this `Service` instance does not have a WSDL and the `endpointReference` does have a WSDL, then the WSDL from the `endpointReference` MAY be used. An implementation MUST be able to retrieve the `portName` from the`endpointReference` metadata.  
 This method behavies the same as calling  
 `dispatch = service.createDispatch(portName, context, mode, features);`  
       
 where the `portName` is retrieved from the WSDL or `endpointReference` metadata.  
Parameters:  
`endpointReference` \- The `EndpointReference` for the target service endpoint that will be invoked by the returned `Dispatch` object.  
`context` \- The JAXB context used to marshall and unmarshall messages or message payloads.  
`mode` \- Controls whether the created dispatch instance is message or payload oriented, i.e. whether the user will work with complete protocol messages or message payloads. E.g. when using the SOAP protocol, this parameter controls whether the user will work with SOAP messages or the contents of a SOAP body.  
`features` \- An array of `WebServiceFeatures` to configure on the proxy. Supported features not in the `features` parameter will have their default values.  
Returns:  
Dispatch instance  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \-  
         * If there is any missing WSDL metadata as required by this method.  
         * If the `endpointReference` metadata does not match the `serviceName` or `portName` of a WSDL associated with this `Service` instance.  
         * If the `portName` cannot be determined from the `EndpointReference` metadata.  
         * If any error in the creation of the `Dispatch` object.  
         * if a feature is enabled that is not compatible with this port or is unsupported.  
Since:  
JAX-WS 2.1  
See Also:  
[JAXBContext](../../../../javax/xml/bind/JAXBContext.html "class in javax.xml.bind"), [WebServiceFeature](../../../../javax/xml/ws/WebServiceFeature.html "class in javax.xml.ws")  
* #### getServiceName  
public abstract [QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace") getServiceName()  
Gets the name of this service.  
Returns:  
Qualified name of this service  
* #### getPorts  
public abstract [Iterator](../../../../java/util/Iterator.html "interface in java.util")<[QName](../../../../javax/xml/namespace/QName.html "class in javax.xml.namespace")> getPorts()  
Returns an `Iterator` for the list of`QName`s of service endpoints grouped by this service  
Returns:  
Returns `java.util.Iterator` with elements of type `javax.xml.namespace.QName`  
Throws:  
`[WebServiceException](../../../../javax/xml/ws/WebServiceException.html "class in javax.xml.ws")` \- If this Service class does not have access to the required WSDL metadata  
* #### getWSDLDocumentLocation  
public abstract [URL](../../../../java/net/URL.html "class in java.net") getWSDLDocumentLocation()  
Gets the location of the WSDL document for this Service.  
Returns:  
URL for the location of the WSDL document for this service  
* #### getHandlerResolver  
public abstract [HandlerResolver](../../../../javax/xml/ws/handler/HandlerResolver.html "interface in javax.xml.ws.handler") getHandlerResolver()  
Returns the configured handler resolver.  
Returns:  
HandlerResolver The `HandlerResolver` being used by this `Service` instance, or `null` if there isn't one.  
* #### setHandlerResolver  
public abstract void setHandlerResolver([HandlerResolver](../../../../javax/xml/ws/handler/HandlerResolver.html "interface in javax.xml.ws.handler") handlerResolver)  
Sets the `HandlerResolver` for this `Service` instance.  
 The handler resolver, if present, will be called once for each proxy or dispatch instance that is created, and the handler chain returned by the resolver will be set on the instance.  
Parameters:  
`handlerResolver` \- The `HandlerResolver` to use for all subsequently created proxy/dispatch objects.  
See Also:  
[HandlerResolver](../../../../javax/xml/ws/handler/HandlerResolver.html "interface in javax.xml.ws.handler")  
* #### getExecutor  
public abstract [Executor](../../../../java/util/concurrent/Executor.html "interface in java.util.concurrent") getExecutor()  
Returns the executor for this `Service`instance. The executor is used for all asynchronous invocations that require callbacks.  
Returns:  
The `java.util.concurrent.Executor` to be used to invoke a callback.  
See Also:  
[Executor](../../../../java/util/concurrent/Executor.html "interface in java.util.concurrent")  
* #### setExecutor  
public abstract void setExecutor([Executor](../../../../java/util/concurrent/Executor.html "interface in java.util.concurrent") executor)  
Sets the executor for this `Service` instance. The executor is used for all asynchronous invocations that require callbacks.  
Parameters:  
`executor` \- The `java.util.concurrent.Executor` to be used to invoke a callback.  
Throws:  
`[SecurityException](../../../../java/lang/SecurityException.html "class in java.lang")` \- If the instance does not support setting an executor for security reasons (e.g. the necessary permissions are missing).  
See Also:  
[Executor](../../../../java/util/concurrent/Executor.html "interface in java.util.concurrent")

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.

ServiceDelegate (Java Platform SE 8 ) (original) (raw)

Constructor Summary

Method Summary

Constructor Detail

Method Detail