Message:
The following issue has been closed.
Resolver: Niclas Hedhman
Date: Wed, 21 Jul 2004 12:02 AM
I have inserted the proposed text, but also added a statement of optional timeout
handling in container.
---------------------------------------------------------------------
View the issue:
http://issues.apache.org/jira/browse/CENTRAL-15
Here is an overview of the issue:
---------------------------------------------------------------------
Key: CENTRAL-15
Summary: Lifecycle spec for Startable should be updated
Type: Bug
Status: Closed
Priority: Major
Resolution: FIXED
Project: Avalon Central
Components:
SITE
Assignee: Niclas Hedhman
Reporter: Stephen McConnell
Created: Tue, 20 Jul 2004 3:33 AM
Updated: Wed, 21 Jul 2004 12:02 AM
Description:
The description of the start and stop stages on
http://avalon.apache.org/products/runtime/reference/component/lifecycle/incarnation.html
should be updated to include something like the following:
The Startable interface is used by any component that is constantly running for the
duration of its life. The interface defines two methods: start and stop . Neither
method has any parameters.
The contract surrounding this interface is that the start method is called once after
the component is fully initialized, and the stop method is called once before the
component is disposed of. Neither method will be called more than once, and start will
always be called before stop . Furthermore, the method must return, it can not go into
a endless loop. From this follows that the component should create a thread and call
the Thread.start() method inside this method to ctart the continous processing. The
stop() method should interrupt the thread in a safe manner. This should be done by
variables and the Thread.interrupt() method, slightly depending on how the thread is
operating. Implications of using this interface require that the start and stop
methods be conducted safely (unlike the Thread.stop method) and not render the system
unstable.
---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
If you want more information on JIRA, or have a bug to report see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
