scolebourne 2003/08/29 15:11:45
Added: reflect PROPOSAL.html
Log:
Initial checkin
Revision Changes Path
1.1 jakarta-commons-sandbox/reflect/PROPOSAL.html
Index: PROPOSAL.html
===================================================================
<html>
<head>
<title>Proposal for reflect Package</title>
</head>
<body bgcolor="white">
<div align="center">
<h1>Proposal for <em>reflect</em> Package</h1>
</div>
<h3>(0) Rationale</h3>
<p>
The Java Reflection Framework provides an API for accessing and calling
classes, methods and fields dynamically at runtime. It is widely used by
Jakarta applications. Unfortunately it has various bugs, including operating
differently on each JDK version.
</p>
<p>
There is a need for a consistent and accurate reflection implementation.
<em>Reflect</em> will achieve this, following the Java specification properly.
It will also include optional caching, which is essential on pre JDK1.4 JVMs.
Some added-value functionality, like C# style delegates is also in-scope for
discussion for inclusion in <em>Reflect</em>.
</p>
<h3>(1) Scope of the Package</h3>
<p>
The <em>Reflect</em> package shall create and maintain a package that provides
an accurate and thorough reflection implementation for all JDK1.2+ versions.
The package shall exclude bean-level reflection.
</p>
<h3>(1.5) Interaction With Other Packages</h3>
<p><em>Reflect</em> relies only on 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>Coding was started in the Lang project, but is unsuited to remaining there.
Code will be moved to Reflect.</p>
<p>The proposed package name for the new component is
<code>org.apache.commons.reflect</code>.</p>
<h3>(3) Required Jakarta-Commons Resources</h3>
<ul>
<li>CVS Repository - New directory <code>reflect</code> in the
<code>jakarta-commons</code> CVS repository.</li>
<li>Mailing List - Discussions will take place on the general
<em>[EMAIL PROTECTED]</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
[reflect].</li>
<li>Bugzilla - New component "reflect" under the "Commons" product
category, with appropriate version identifiers as needed.</li>
<li>Jyve FAQ - New category "commons-reflect" (when available).</li>
</ul>
<h3>(4) Initial Committers</h3>
<p>The initial committers on the Reflect component shall be:
<ul>
<li>Robert Burrel Donkin</li>
<li>Stephen Colebourne</li>
</ul>
</p>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
