public class WSServiceDelegate extends WSService
Service objects provide the client view of a Web service.
Service acts as a factory of the following:
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.
Executor| Modifier and Type | Class and Description |
|---|---|
(package private) class |
WSServiceDelegate.DaemonThreadFactory |
WSService.InitParams| Modifier and Type | Field and Description |
|---|---|
protected static WebServiceFeature[] |
EMPTY_FEATURES |
(package private) ServiceInterceptor |
serviceInterceptor
Multiple
ServiceInterceptors are aggregated into one. |
EMPTY_PARAMS, INIT_PARAMS| Modifier | Constructor and Description |
|---|---|
|
WSServiceDelegate(Source wsdl,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeature... features) |
protected |
WSServiceDelegate(Source wsdl,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeatureList features) |
|
WSServiceDelegate(Source wsdl,
WSDLServiceImpl service,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeature... features) |
|
WSServiceDelegate(Source wsdl,
WSDLServiceImpl service,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeatureList features) |
|
WSServiceDelegate(URL wsdlDocumentLocation,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeature... features) |
protected |
WSServiceDelegate(URL wsdlDocumentLocation,
QName serviceName,
Class<? extends Service> serviceClass,
WebServiceFeatureList features) |
@NotNull final ServiceInterceptor serviceInterceptor
ServiceInterceptors are aggregated into one.protected static final WebServiceFeature[] EMPTY_FEATURES
public WSServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass, WebServiceFeature... features)
protected WSServiceDelegate(URL wsdlDocumentLocation, QName serviceName, Class<? extends Service> serviceClass, WebServiceFeatureList features)
public WSServiceDelegate(@Nullable
Source wsdl,
@NotNull
QName serviceName,
@NotNull
Class<? extends Service> serviceClass,
WebServiceFeature... features)
serviceClass - Either Service.class or other generated service-derived classes.protected WSServiceDelegate(@Nullable
Source wsdl,
@NotNull
QName serviceName,
@NotNull
Class<? extends Service> serviceClass,
WebServiceFeatureList features)
serviceClass - Either Service.class or other generated service-derived classes.public WSServiceDelegate(@Nullable
Source wsdl,
@Nullable
WSDLServiceImpl service,
@NotNull
QName serviceName,
@NotNull
Class<? extends Service> serviceClass,
WebServiceFeature... features)
serviceClass - Either Service.class or other generated service-derived classes.public WSServiceDelegate(@Nullable
Source wsdl,
@Nullable
WSDLServiceImpl service,
@NotNull
QName serviceName,
@NotNull
Class<? extends Service> serviceClass,
WebServiceFeatureList features)
serviceClass - Either Service.class or other generated service-derived classes.protected EntityResolver createCatalogResolver()
public Executor getExecutor()
getExecutor in class ServiceDelegatepublic void setExecutor(Executor executor)
setExecutor in class ServiceDelegatepublic HandlerResolver getHandlerResolver()
getHandlerResolver in class ServiceDelegatefinal HandlerConfigurator getHandlerConfigurator()
public void setHandlerResolver(HandlerResolver resolver)
setHandlerResolver in class ServiceDelegatepublic <T> T getPort(QName portName, Class<T> portInterface) throws WebServiceException
getPort in class ServiceDelegateWebServiceExceptionpublic <T> T getPort(QName portName, Class<T> portInterface, WebServiceFeature... features)
getPort in class ServiceDelegatepublic <T> T getPort(EndpointReference epr, Class<T> portInterface, WebServiceFeature... features)
getPort in class ServiceDelegatepublic <T> T getPort(WSEndpointReference wsepr, Class<T> portInterface, WebServiceFeature... features)
WSServiceServiceDelegate.getPort(EndpointReference, Class, WebServiceFeature...)
but takes WSEndpointReference.protected <T> T getPort(WSEndpointReference wsepr, QName portName, Class<T> portInterface, WebServiceFeatureList features)
public <T> T getPort(Class<T> portInterface, WebServiceFeature... features)
getPort in class ServiceDelegatepublic <T> T getPort(Class<T> portInterface) throws WebServiceException
getPort in class ServiceDelegateWebServiceExceptionpublic void addPort(QName portName, String bindingId, String endpointAddress) throws WebServiceException
addPort in class ServiceDelegateWebServiceExceptionpublic <T> Dispatch<T> createDispatch(QName portName, Class<T> aClass, Service.Mode mode) throws WebServiceException
createDispatch in class ServiceDelegateWebServiceExceptionpublic <T> Dispatch<T> createDispatch(QName portName, WSEndpointReference wsepr, Class<T> aClass, Service.Mode mode, WebServiceFeature... features)
WSService#createDispatch(EndpointReference, Class, Mode, WebServiceFeature[])
but it takes the port name separately, so that EPR without embedded metadata can be used.createDispatch in class WSServicepublic <T> Dispatch<T> createDispatch(QName portName, WSEndpointReference wsepr, Class<T> aClass, Service.Mode mode, WebServiceFeatureList features)
public <T> Dispatch<T> createDispatch(QName portName, Class<T> aClass, Service.Mode mode, WebServiceFeature... features)
createDispatch in class ServiceDelegatepublic <T> Dispatch<T> createDispatch(QName portName, Class<T> aClass, Service.Mode mode, WebServiceFeatureList features)
public <T> Dispatch<T> createDispatch(EndpointReference endpointReference, Class<T> type, Service.Mode mode, WebServiceFeature... features)
createDispatch in class ServiceDelegate@NotNull public PortInfo safeGetPort(QName portName)
PortInfo for the given name, with error check.public EndpointAddress getEndpointAddress(QName qName)
public Dispatch<Object> createDispatch(QName portName, JAXBContext jaxbContext, Service.Mode mode) throws WebServiceException
createDispatch in class ServiceDelegateWebServiceExceptionpublic Dispatch<Object> createDispatch(QName portName, WSEndpointReference wsepr, JAXBContext jaxbContext, Service.Mode mode, WebServiceFeature... features)
WSService#createDispatch(EndpointReference, JAXBContext, Mode, WebServiceFeature[])
but it takes the port name separately, so that EPR without embedded metadata can be used.createDispatch in class WSServiceprotected Dispatch<Object> createDispatch(QName portName, WSEndpointReference wsepr, JAXBContext jaxbContext, Service.Mode mode, WebServiceFeatureList features)
@NotNull public Container getContainer()
WSServiceContainer object.
The components inside WSEndpoint uses this reference
to communicate with the hosting environment.
getContainer in class WSServiceContainer instance
is given, Container.NONE will be returned.public Dispatch<Object> createDispatch(QName portName, JAXBContext jaxbContext, Service.Mode mode, WebServiceFeature... webServiceFeatures)
createDispatch in class ServiceDelegateprotected Dispatch<Object> createDispatch(QName portName, JAXBContext jaxbContext, Service.Mode mode, WebServiceFeatureList features)
public Dispatch<Object> createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
createDispatch in class ServiceDelegatepublic QName getServiceName()
getServiceName in class ServiceDelegatepublic Class getServiceClass()
public Iterator<QName> getPorts() throws WebServiceException
getPorts in class ServiceDelegateWebServiceExceptionpublic URL getWSDLDocumentLocation()
getWSDLDocumentLocation in class ServiceDelegateprotected InvocationHandler getStubHandler(BindingImpl binding, SEIPortInfo eif, @Nullable WSEndpointReference epr)
@NotNull public WSDLPortImpl getPortModel(WSDLServiceImpl wsdlService, QName portName)
WSDLPortImpl with error check.public SEIModel buildRuntimeModel(QName serviceName, QName portName, Class portInterface, WSDLPort wsdlPort, WebServiceFeatureList features)
public WSDLServiceImpl getWsdlService()
Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.