jstrachan 01/05/08 06:07:48 Modified: threading STATUS.html Log: Added myself as a committer Revision Changes Path 1.2 +148 -147 jakarta-commons-sandbox/threading/STATUS.html Index: STATUS.html =================================================================== RCS file: /home/cvs/jakarta-commons-sandbox/threading/STATUS.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- STATUS.html 2001/04/15 00:50:57 1.1 +++ STATUS.html 2001/05/08 13:07:43 1.2 @@ -1,147 +1,148 @@ -<html> -<head> -<title>Status File for Jakarta Commons "Threading" Component</title> -<head> -<body bgcolor="white"> - - -<div align="center"> -<h1>The Jakarta Commons <em>BeanUtils</em> Component</h1> -$Id: STATUS.html,v 1.1 2001/04/15 00:50:57 craigmcc Exp $<br> -<a href="#Introduction">[Introduction]</a> -<a href="#Dependencies">[Dependencies]</a> -<a href="#Release Info">[Release Info]</a> -<a href="#Committers">[Committers]</a> -<a href="#Action Items">[Action Items]</a> -<br><br> -</div> - - -<a name="Introduction"></a> -<h3>1. INTRODUCTION</h3> - -<p>The <em>Threading Goodies</em> package provides a set of Java interfaces -and classes useful in coordinating and communication between multiple threads -in a server environment. The following interfaces are included:</p> -<ul> -<li><strong>Notifier</strong> - A background thread that delivers published - objects to the specified list of Subscribers.</li> -<li><strong>Publisher</strong> - An object that accepts subscriptions from - interested Subscribers and delivers published messages (i.e. arbitrary - Java objects) to all Subscribers.</li> -<li><strong>Queue</strong> - Message queue that supports multiple readers and - multiple writers. Different implementations have different behavioral - characteristics.</li> -<li><strong>Semaphore</strong> - A lock that can be acquired by only one - thread at a time (with optional timeout on acquiring the lock).</li> -<li><strong>Subscriber</strong> - An object that expresses interest in messages - transmitted by a Publisher by subscribing to that Publisher.</li> -</ul> - -<p>The following implementations of these interfaces are included:</p> -<ul> -<li><strong>Alarm</strong> - A Publisher that fires timer events either - continuously or as one-shot requests.</li> -<li><strong>AsynchPublisher</strong> - A Publisher that uses a Notifier for - message delivery via a background thread. Multiple publishers can share - the same Notifier, or use different ones.</li> -<li><strong>Counter</strong> - A Semaphore that maintains a counter, which - is initialized in the constructor. Calls to <code>acquire()</code> will - not block unless the count hits zero, so this object can be used (for - example), to maintain the number of available elements in a Queue and - automatically support thread coordination.</li> -<li><strong>FIFONotifier</strong> - A Notifier that guarantees to deliver - notifications in the order received, even in the face of usage from - multiple threads or very rapid calls from the same thread.</li> -<li><strong>FIFOQueue</strong> - A Queue that operates in a - first-in/first-out manner (analogous to a LinkedList).</li> -<li><strong>LIFOQueue</strong> - A Queue that operates in a - last-in/first-out manner (analogous to a Stack).</li> -<li><strong>Mutex</strong> - A Semaphore that can be locked by only one - Thread at a time.</li> -<li><strong>SynchPublisher</strong> - A Publisher that uses the caller's - thread for message delivery.</li> -</ul> - -<p>In addition, the following classes are also included:</p> -<ul> -<li><strong>Condition</strong> - A simple condition variable that can be - used (for example) as a "queue not empty" flag on a Queue implementation. - </li> -<li><strong>MultiSemaphore</strong> - Utility class that supports locking - and unlocking of multiple semaphores at once.</li> -<li><strong>Timer</strong> - A stopwatch class that measures elapsed time - in milliseconds. A Timer instance can be started, stopped, and reset - any number of times.</li> -</ul> - -<p>Most of the classes in the proposal were originally inspired by a series -of articles called "Java Threads in the Real World" in JavaWorld (09/1998 - -04/1999) by Allen Holub.</p> - - -<a name="Dependencies"></a> -<h3>2. DEPENDENCIES</h3> - -<p>The <em>Threading</em> component is dependent upon the following external -components for development and use:</p> -<ul> -<li><a href="http://java.sun.com/j2se";>Java Development Kit</a> - (Version 1.2 or later)</li> -<li><a href="http://www.junit.org";>JUnit Testing Framework</a> - (Version 3.2 or later) - for unit tests only, not required - for deployment</li> -</ul> - - -<a name="Release Info"></a> -<h3>3. RELEASE INFO</h3> - -<p>Current Release: <strong>Unreleased, CVS Repository Only</strong></p> - -<p>Planned Next Release: Version 1.0, by April 30, 2001. See the -<a href="#Action Items">Action Items</a> list for tasks that need to be -completed prior to this release.</p> - - -<a name="Committers"></a> -<h3>4. COMMITTERS</h3> - -<p>The following individuals are the primary developers and maintainers of this -component. Developers who plan to use <em>BeanUtils</em> in their own -projects are encouraged to collaborate on the future development of this -component to ensure that it continues to meet a variety of needs.</p> -<ul> -<li><a href="mailto:[EMAIL PROTECTED]";>Craig McClanahan</a> -</ul> - - -<a name="Action Items"></a> -<h3>5. ACTION ITEMS</h3> - -<p>The following action items need to be completed prior to a Version 1.0 -release of this component:</p> - -<table border="1"> - - <tr> - <th width="80%">Action Item</th> - <th width="20%">Volunteer</th> - </tr> - - <tr> - <td><strong>Unit Tests</strong>. Create unit tests for all of the - included classes.</td> - <td align="center"> </td> - </tr> - - <tr> - <td><strong>Install / Use Documentation</strong>. Create simple - installation and User's Guide documentation for this component.</td> - <td align="center"> </td> - </tr> - -</table> - -</body> -</html> +<html> +<head> +<title>Status File for Jakarta Commons "Threading" Component</title> +<head> +<body bgcolor="white"> + + +<div align="center"> +<h1>The Jakarta Commons <em>BeanUtils</em> Component</h1> +$Id: STATUS.html,v 1.2 2001/05/08 13:07:43 jstrachan Exp $<br> +<a href="#Introduction">[Introduction]</a> +<a href="#Dependencies">[Dependencies]</a> +<a href="#Release Info">[Release Info]</a> +<a href="#Committers">[Committers]</a> +<a href="#Action Items">[Action Items]</a> +<br><br> +</div> + + +<a name="Introduction"></a> +<h3>1. INTRODUCTION</h3> + +<p>The <em>Threading Goodies</em> package provides a set of Java interfaces +and classes useful in coordinating and communication between multiple threads +in a server environment. The following interfaces are included:</p> +<ul> +<li><strong>Notifier</strong> - A background thread that delivers published + objects to the specified list of Subscribers.</li> +<li><strong>Publisher</strong> - An object that accepts subscriptions from + interested Subscribers and delivers published messages (i.e. arbitrary + Java objects) to all Subscribers.</li> +<li><strong>Queue</strong> - Message queue that supports multiple readers and + multiple writers. Different implementations have different behavioral + characteristics.</li> +<li><strong>Semaphore</strong> - A lock that can be acquired by only one + thread at a time (with optional timeout on acquiring the lock).</li> +<li><strong>Subscriber</strong> - An object that expresses interest in messages + transmitted by a Publisher by subscribing to that Publisher.</li> +</ul> + +<p>The following implementations of these interfaces are included:</p> +<ul> +<li><strong>Alarm</strong> - A Publisher that fires timer events either + continuously or as one-shot requests.</li> +<li><strong>AsynchPublisher</strong> - A Publisher that uses a Notifier for + message delivery via a background thread. Multiple publishers can share + the same Notifier, or use different ones.</li> +<li><strong>Counter</strong> - A Semaphore that maintains a counter, which + is initialized in the constructor. Calls to <code>acquire()</code> will + not block unless the count hits zero, so this object can be used (for + example), to maintain the number of available elements in a Queue and + automatically support thread coordination.</li> +<li><strong>FIFONotifier</strong> - A Notifier that guarantees to deliver + notifications in the order received, even in the face of usage from + multiple threads or very rapid calls from the same thread.</li> +<li><strong>FIFOQueue</strong> - A Queue that operates in a + first-in/first-out manner (analogous to a LinkedList).</li> +<li><strong>LIFOQueue</strong> - A Queue that operates in a + last-in/first-out manner (analogous to a Stack).</li> +<li><strong>Mutex</strong> - A Semaphore that can be locked by only one + Thread at a time.</li> +<li><strong>SynchPublisher</strong> - A Publisher that uses the caller's + thread for message delivery.</li> +</ul> + +<p>In addition, the following classes are also included:</p> +<ul> +<li><strong>Condition</strong> - A simple condition variable that can be + used (for example) as a "queue not empty" flag on a Queue implementation. + </li> +<li><strong>MultiSemaphore</strong> - Utility class that supports locking + and unlocking of multiple semaphores at once.</li> +<li><strong>Timer</strong> - A stopwatch class that measures elapsed time + in milliseconds. A Timer instance can be started, stopped, and reset + any number of times.</li> +</ul> + +<p>Most of the classes in the proposal were originally inspired by a series +of articles called "Java Threads in the Real World" in JavaWorld (09/1998 - +04/1999) by Allen Holub.</p> + + +<a name="Dependencies"></a> +<h3>2. DEPENDENCIES</h3> + +<p>The <em>Threading</em> component is dependent upon the following external +components for development and use:</p> +<ul> +<li><a href="http://java.sun.com/j2se";>Java Development Kit</a> + (Version 1.2 or later)</li> +<li><a href="http://www.junit.org";>JUnit Testing Framework</a> + (Version 3.2 or later) - for unit tests only, not required + for deployment</li> +</ul> + + +<a name="Release Info"></a> +<h3>3. RELEASE INFO</h3> + +<p>Current Release: <strong>Unreleased, CVS Repository Only</strong></p> + +<p>Planned Next Release: Version 1.0, by April 30, 2001. See the +<a href="#Action Items">Action Items</a> list for tasks that need to be +completed prior to this release.</p> + + +<a name="Committers"></a> +<h3>4. COMMITTERS</h3> + +<p>The following individuals are the primary developers and maintainers of this +component. Developers who plan to use <em>BeanUtils</em> in their own +projects are encouraged to collaborate on the future development of this +component to ensure that it continues to meet a variety of needs.</p> +<ul> +<li><a href="mailto:[EMAIL PROTECTED]";>Craig McClanahan</a> +<li><a href="mailto:[EMAIL PROTECTED]";>James Strachan</a> +</ul> + + +<a name="Action Items"></a> +<h3>5. ACTION ITEMS</h3> + +<p>The following action items need to be completed prior to a Version 1.0 +release of this component:</p> + +<table border="1"> + + <tr> + <th width="80%">Action Item</th> + <th width="20%">Volunteer</th> + </tr> + + <tr> + <td><strong>Unit Tests</strong>. Create unit tests for all of the + included classes.</td> + <td align="center"> </td> + </tr> + + <tr> + <td><strong>Install / Use Documentation</strong>. Create simple + installation and User's Guide documentation for this component.</td> + <td align="center"> </td> + </tr> + +</table> + +</body> +</html>
