org.sape.carbon.core.component.lifecycle
Interface Startable

All Known Subinterfaces:

ComponentLifecycle

All Known Implementing Classes:

AbstractTotalCache, DefaultDeploymentServiceImpl, DefaultHttpAdaptorServiceImpl, DefaultJrmpRemotingImpl, DefaultSchedulerServiceImpl, DefaultThreadPoolImpl, SynchronousMailService

public interface Startable

This interface should be implemented by Components that wish to provide callback methods to participate in lifecycle start and stop operations. Copyright 2002 Sapient

Since:

carbon 1.0

Version:

$Revision: 1.7 $($Author: dvoet $ / $Date: 2003/05/05 21:21:13 $)

Author:

Chris Herron, January 2002

Method Summary

void	start() Start the component.
void	stop() Stop the component.

Method Detail

start

public void start()
           throws Exception

Start the component. On return, the container will begin fowarding requests to the component. This may be an opportunity to dispatch worker threads.

Throws:

Exception - when there is a failure to start the component

stop

public void stop()
          throws Exception

Stop the component. Prior to entry, the container will cease forwarding requests for service to the component. This is an opportunity to cleanly complete or abort any outstanding work. For example, a set of worker threads could be killed off, or a queue set to drain.

Throws:

Exception - when there is a failure to stop the exception