*** This API provides Binary Compatibility only, not Source Compatibility ***

com.sas.services.deployment
Class RMIDeployableService

java.lang.Object
  |
  +--com.sas.services.deployment.DeployableService
        |
        +--com.sas.services.deployment.RMIDeployableService

All Implemented Interfaces:

DeployInterface,

public class RMIDeployableService

extends DeployableService

An RMI deployable service is an object that represents a foundation service that can be deployed by the ServiceLoader utility. It represents a foundation service which is utltimately defined in terms of an Open Metadata Architecture (OMA) metadata schema.

During the process of querying a metadata source for a foundation service deployment the creation of a DeployableService represents a conversion from an OMA metadata representation into an alternative representation that is more suited for use in the foundation service deployment domain.

Since:

1.0

See Also:

Serialized Form

Constructor Summary

RMIDeployableService(String id, ServiceConfigurationInterface serviceConfiguration, RMIBinding rmiBinding)
Constructs an instance that specifies an RMI binding that may be used to lookup a service in an RMI registry.

RMIDeployableService(String id, ServiceConfigurationInterface serviceConfiguration, String[] dependencies, RMIBinding rmiBinding)
Constructs an instance that specifies a factory that will be used to instantiate a service and optionally register it with the RMI registry.

RMIDeployableService(String id, ServiceConfigurationInterface serviceConfiguration, String[] dependencies, Set rmiBindings)
Constructs an instance that specifies a factory that will be used to instantiate a service and optionally register it with the RMI registry.

Method Summary

RemoteServiceInterface	deploy() Deploys an RMI service by either looking up its stub in an RMI registry or instantiating a service and optionally registering it with RMI.
String	toString() Gets a string representation of this instance.

Methods inherited from class com.sas.services.deployment.DeployableService

compareTo, equals, getDependencies, getId, getServiceConfiguration, getServiceFactory, hashCode, setDependencies

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RMIDeployableService

public RMIDeployableService(String id,
                            ServiceConfigurationInterface serviceConfiguration,
                            RMIBinding rmiBinding)
                     throws ServiceException

Constructs an instance that specifies an RMI binding that may be used to lookup a service in an RMI registry. This constructor should be used if one wants to lookup a previously deployed service.

Parameters:

id - Deployable service's ID.

serviceConfiguration - Deployable service's configuration.

rmiBinding - RMI name binding that associates a remote service to an RMI registry.

Throws:

ServiceException - if unable to obtain a service by looking it up in an RMI registry.

RMIDeployableService

public RMIDeployableService(String id,
                            ServiceConfigurationInterface serviceConfiguration,
                            String[] dependencies,
                            Set rmiBindings)
                     throws ServiceException

Constructs an instance that specifies a factory that will be used to instantiate a service and optionally register it with the RMI registry.

Parameters:

id - Deployable service's repository ID.

serviceConfiguration - Deployable service's initialization configuration that will be provided to the service factory.

dependencies - A set of 0..* service repository IDs upon which this service depends. This service may not be deployed until these other services are deployed. A null parameter value indicates that there are no other dependencies.

rmiBindings - Set of RMI name bindings associating service to one or more RMI registries.

Throws:

ServiceException - if unable to construct an instance.

RMIDeployableService

public RMIDeployableService(String id,
                            ServiceConfigurationInterface serviceConfiguration,
                            String[] dependencies,
                            RMIBinding rmiBinding)
                     throws ServiceException

Constructs an instance that specifies a factory that will be used to instantiate a service and optionally register it with the RMI registry.

Parameters:

id - Deployable service's repository ID.

serviceConfiguration - Deployable service's initialization configuration that will be provided to the service factory.

dependencies - A set of 0..* service repository IDs upon which this service depends. This service may not be deployed until these other services are deployed. A null parameter value indicates that there are no other dependencies.

rmiBinding - RMI name binding that associates a remote service to an RMI registry.

Throws:

ServiceException - if unable to construct an instance.

Method Detail

deploy

public RemoteServiceInterface deploy()
                              throws ServiceException

Deploys an RMI service by either looking up its stub in an RMI registry or instantiating a service and optionally registering it with RMI.

Overrides:

deploy in class DeployableService

Returns:

Deployed service.

Throws:

ServiceException - if unable to deploy the service.

See Also:

DeployInterface.deploy()

toString

public String toString()

Gets a string representation of this instance.

Overrides:

toString in class DeployableService

Returns:

String representation of this instance.

*** This API provides Binary Compatibility only, not Source Compatibility ***