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 ge 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 asociated 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)