Save This Page
Home » openjdk-7 » javax » xml » rpc » [javadoc | source]
javax.xml.rpc
public interface: Service [javadoc | source] Service class acts as a factory of the following:
Method from javax.xml.rpc.Service Summary:
createCall,   createCall,   createCall,   createCall,   getCalls,   getHandlerRegistry,   getPort,   getPort,   getPorts,   getServiceName,   getTypeMappingRegistry,   getWSDLDocumentLocation
Method from javax.xml.rpc.Service Detail:
 public Call createCall() throws ServiceException
    Creates a Call object not associated with
specific operation or target service endpoint. This
Call object needs to be configured using the
setter methods on the Call interface.
 public Call createCall(QName portName) throws ServiceException
    Creates a Call instance.
 public Call createCall(QName portName,
    QName operationName) throws ServiceException
    Creates a Call instance.
 public Call createCall(QName portName,
    String operationName) throws ServiceException
    Creates a Call instance.
 public Call[] getCalls(QName portName) throws ServiceException
    Gets an array of preconfigured Call objects for
invoking operations on the specified port. There is one
Call object per operation that can be invoked
on the specified port. Each Call object is
pre-configured and does not need to be configured using
the setter methods on Call interface.


    Each invocation of the getCalls method
returns a new array of preconfigured Call

objects


    This method requires the Service implementation
class to have access to the WSDL related metadata.
 public HandlerRegistry getHandlerRegistry()
    Returns the configured HandlerRegistry instance
for this Service instance.
 public Remote getPort(Class serviceEndpointInterface) throws ServiceException
    The getPort method returns either an instance of a generated
stub implementation class or a dynamic proxy. The parameter
serviceEndpointInterface specifies the service
endpoint interface that is supported by the returned stub or
proxy. In the implementation of this method, the JAX-RPC
runtime system takes the responsibility of selecting a protocol
binding (and a port) and configuring the stub accordingly.
The returned Stub instance should not be
reconfigured by the client.
 public Remote getPort(QName portName,
    Class serviceEndpointInterface) throws ServiceException
    The getPort method returns either an instance of a generated
stub implementation class or a dynamic proxy. A service client
uses this dynamic proxy to invoke operations on the target
service endpoint. The serviceEndpointInterface
specifies the service endpoint interface that is supported by
the created dynamic proxy or stub instance.
 public Iterator getPorts() throws ServiceException
    Returns an Iterator for the list of
QNames of service endpoints grouped by this
service.
 public QName getServiceName()
    Gets the name of this Service.
 public TypeMappingRegistry getTypeMappingRegistry()
    Gets the TypeMappingRegistry for this
Service object. The returned
TypeMappingRegistry instance is pre-configured
to support the standard type mapping between XML and Java
types types as required by the JAX-RPC specification.
 public URL getWSDLDocumentLocation()
    Gets location of the WSDL document for this Service.