You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2003/12/05 23:19:42 UTC
cvs commit: jakarta-commons-sandbox/events PROPOSAL.html
scolebourne 2003/12/05 14:19:42
Added: events PROPOSAL.html
Log:
Initial checkin
Revision Changes Path
1.1 jakarta-commons-sandbox/events/PROPOSAL.html
Index: PROPOSAL.html
===================================================================
<html>
<head>
<title>Proposal for Events Package</title>
</head>
<body bgcolor="white">
<div align="center">
<h1>Proposal for <em>Events</em> Package</h1>
</div>
<h3>(0) Rationale</h3>
<p>
The Java JDK provides a design framework for events to observe change.
There is relatively little support for classes to actually fire these events.
This is most noticable in the Java Collections Framework where there is no
standard mechanism to listen for changes to a collection.
</p>
<p>
A Commons package to support event classes as an extension to the JDK
would be a useful addition to many projects.
</p>
<h3>(1) Scope of the Package</h3>
<p>
The package will create and maintain a set of classes that fire events, and
a set of classes that handle and manage the events. These will be designed to
work closely with existing JDK APIs and be distributed under the ASF license.
</p>
<h3>(1.5) Interaction With Other Packages</h3>
<p><em>Events</em> relies on commons-collections and the standard JDK 1.2
(or later) APIs for production deployment. It utilizes the JUnit unit testing
framework for developing and executing unit tests, but this is of interest only
to developers of the component.
</p>
<p>
No external configuration files are utilized.
</p>
<h3>(2) Initial Source of the Package</h3>
<p>
The initial codebase was originally located in the commons-collections project.
It has been separated to enable it to grow independently.
</p>
<p>
The proposed package name for the new component is
<code>org.apache.commons.events</code>.
</p>
<h3>(3) Required Jakarta-Commons Resources</h3>
<ul>
<li>CVS Repository - New directory <code>events</code> in the
<code>jakarta-commons-sandbox</code> CVS repository. All initial committers
are already committers on <code>jakarta-commons-sandbox</code>, so no
additional user setups are required.</li>
<li>Mailing List - Discussions will take place on the general
<em>commons-dev@jakarta.apache.org</em> mailing list. To help
list subscribers identify messages of interest, it is suggested that
the message subject of messages about this component be prefixed with
[Events].</li>
<li>Bugzilla - New component "Events" under the "Commons" product
category, with appropriate version identifiers as needed.</li>
<li>Jyve FAQ - New category "commons-events" (when available).
</ul>
<h3>(4) Initial Committers</h3>
<ul>
<li>Stephen Colebourne</li>
<li>Neil O'Toole</li>
</ul>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org