| 
 | |||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
Service class acts as a factory of the following:
 
javax.xml.rpc.Call for
     the dynamic invocation of a remote operation on the
     target service endpoint.
 
| Method Summary | |
|  Call | createCall()Creates a Callobject not associated with
 specific operation or target service endpoint. | 
|  Call | createCall(QName portName)Creates a Callinstance. | 
|  Call | createCall(QName portName,
           QName operationName)Creates a Callinstance. | 
|  Call | createCall(QName portName,
           java.lang.String operationName)Creates a Callinstance. | 
|  Call[] | getCalls(QName portName)Gets an array of preconfigured Callobjects for
 invoking operations on the specified port. | 
|  HandlerRegistry | getHandlerRegistry()Returns the configured HandlerRegistryinstance
 for thisServiceinstance. | 
|  java.rmi.Remote | getPort(java.lang.Class serviceEndpointInterface)The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. | 
|  java.rmi.Remote | getPort(QName portName,
        java.lang.Class serviceEndpointInterface)The getPort method returns either an instance of a generated stub implementation class or a dynamic proxy. | 
|  java.util.Iterator | getPorts()Returns an Iteratorfor the list ofQNames of service endpoints grouped by this
 service. | 
|  QName | getServiceName()Gets the name of this Service. | 
|  TypeMappingRegistry | getTypeMappingRegistry()Gets the TypeMappingRegistryfor thisServiceobject. | 
|  java.net.URL | getWSDLDocumentLocation()Gets location of the WSDL document for this Service. | 
| Method Detail | 
public java.rmi.Remote getPort(QName portName,
                               java.lang.Class serviceEndpointInterface)
                        throws ServiceException
serviceEndpointInterface
 specifies the service endpoint interface that is supported by
 the created dynamic proxy or stub instance.
portName - Qualified name of the service endpoint in
              the WSDL service descriptionserviceEndpointInterface - Service endpoint interface
              supported by the dynamic proxy or stub
              instance
ServiceException - This exception is thrown in the
              following cases:
              serviceEndpointInterface
                  or portName is specified
              
public java.rmi.Remote getPort(java.lang.Class serviceEndpointInterface)
                        throws ServiceException
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.
serviceEndpointInterface - Service endpoint interface
ServiceException - serviceEndpointInterface
                  is specified
              
public Call[] getCalls(QName portName)
                throws ServiceException
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.
portName - Qualified name for the target service endpoint
ServiceException - If this Service class does not
              have access to the required WSDL metadata
              or if an illegal portName is
              specified.
public Call createCall(QName portName)
                throws ServiceException
Call instance.
portName - Qualified name for the target service endpoint
ServiceException - If any error in the creation of
              the Call object
public Call createCall(QName portName,
                       QName operationName)
                throws ServiceException
Call instance.
portName - Qualified name for the target service
              endpointoperationName - Qualified Name of the operation for
              which this Call object is to
              be created.
ServiceException - If any error in the creation of
              the Call object
public Call createCall(QName portName,
                       java.lang.String operationName)
                throws ServiceException
Call instance.
portName - Qualified name for the target service
              endpointoperationName - Name of the operation for which this
                  Call object is to be
                  created.
ServiceException - If any error in the creation of
              the Call object
public Call createCall()
                throws ServiceException
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.
ServiceException - If any error in the creation of
              the Call objectpublic QName getServiceName()
public java.util.Iterator getPorts()
                            throws ServiceException
Iterator for the list of
 QNames of service endpoints grouped by this
 service.
java.util.Iterator with elements
     of type javax.xml.namespace.QName
ServiceException - If this Service class does not
     have access to the required WSDL metadatapublic java.net.URL getWSDLDocumentLocation()
public TypeMappingRegistry getTypeMappingRegistry()
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.
java.lang.UnsupportedOperationException - if the Service class does not support
     the configuration of TypeMappingRegistry.public HandlerRegistry getHandlerRegistry()
HandlerRegistry instance
 for this Service instance.
java.lang.UnsupportedOperationException - - if the Service class does not support
     the configuration of a HandlerRegistry| 
 | |||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||