[jira] Assigned: (CENTRAL-15) Lifecycle spec for Startable should be updated

[de...@avalon.apache.org]

Message:

   The following issue has been re-assigned.

   Assignee: Niclas Hedhman (mailto:niclas@apache.org)
---------------------------------------------------------------------
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: Open
   Priority: Major

    Project: Avalon Central
 Components: 
             SITE

   Assignee: Niclas Hedhman
   Reporter: Stephen McConnell

    Created: Tue, 20 Jul 2004 3:33 AM
    Updated: Tue, 20 Jul 2004 11:46 PM

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: dev-unsubscribe@avalon.apache.org
For additional commands, e-mail: dev-help@avalon.apache.org