Message:

  A new issue has been created in JIRA.

---------------------------------------------------------------------
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: Unassigned
   Priority: Major

    Project: Avalon Central
 Components: 
             SITE

   Assignee: 
   Reporter: Stephen McConnell

    Created: Tue, 20 Jul 2004 3:33 AM
    Updated: Tue, 20 Jul 2004 3:33 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]

Reply via email to