| 
 | J2EE1.4 SDK | |||||||||
| 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. 
  
Call, 
Stub| 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 the 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
                   Proxy, 
InvocationHandler
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.UnsupportedOperationExceptionService class does not support
          the configuration of TypeMappingRegistry.public HandlerRegistry getHandlerRegistry()
HandlerRegistry instance
  for this Service instance.
java.lang.UnsupportedOperationExceptionService class does not support 
          the configuration of a HandlerRegistry| 
 | J2EE1.4 SDK | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2003 Sun Microsystems, Inc. All rights reserved.