org.globus.ogsa
Interface GridServiceCallback

All Known Subinterfaces:
GridServiceBase, PersistentGridServiceBase, PersistentGridServiceCallback
All Known Implementing Classes:
DynamicFactoryLifecycleCallbackImpl, FactoryProvider, GridServiceImpl, MasterCounterFactory, NotificationSourceProvider, PersistentGridServiceImpl, ProviderCallbackRecorder, RegistryPublishProvider, ServiceGroupRegistrationProvider

public interface GridServiceCallback

The GridServiceCallback interface defines callback methods that can be implemented by all Grid services to be notified by life cycle events.


Method Summary
 void activate(GridContext context)
          Called when a service becomes active after having been deactivated.
 void deactivate(GridContext context)
          Called just before a service gets deactivated.
 void postCreate(GridContext context)
          Called when a service has been created and all of its configuration has been set up.
 void preCreate(GridServiceBase base)
          Called when a service object is created.
 void preDestroy(GridContext context)
          Called just before a service gets destroyed.
 

Method Detail

preCreate

public void preCreate(GridServiceBase base)
               throws GridServiceException
Called when a service object is created.

Parameters:
base - the Grid service that is in the process of creating this service object, or if this is a persistent Grid service it points to the service to be created.
Throws:
GridServiceException - if the service should not be created

postCreate

public void postCreate(GridContext context)
                throws GridServiceException
Called when a service has been created and all of its configuration has been set up.

Parameters:
context - state information currently associated with the service that was created.
Throws:
GridServiceException - if the service creation should be aborted

activate

public void activate(GridContext context)
              throws GridServiceException
Called when a service becomes active after having been deactivated. A service is always activated before any methods can be called on it.

Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the service activation should be aborted

deactivate

public void deactivate(GridContext context)
                throws GridServiceException
Called just before a service gets deactivated. When a service is deactivated it is subject to garbage collection, so if state is to be survive deactivation it has to be checkpointed into persistent storage. A deactivated service is however still discoverable by clients.

Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the service deactivation failed

preDestroy

public void preDestroy(GridContext context)
                throws GridServiceException
Called just before a service gets destroyed. After this call is made the framework removes all knowledge about the service, so it is a good place to clean up service resources. Note that this call can be triggered both by a client initiated destroy call, as well as a framework initiated softstate timeout.

Parameters:
context - state information currently associated with the service
Throws:
GridServiceException - if the destruction failed (will be reported to clients in the case of explicit destroy calls)


Copyright ? 1999 University of Chicago and The University of Southern California. All Rights Reserved.