blob: e64c4fb135fded0c44e8e3ee94d780730383949c [file] [log] [blame]
<title>Proposal for Digester Package</title>
<body bgcolor="white">
<div align="center">
<h1>Proposal for <em>Digester</em> Package</h1>
<h3>(0) Rationale</h3>
<p>Many Jakarta products read XML configuration files to provide
initialization of various Java objects within the system.
<p>There are several ways of doing this now spread across various Jakarta
projects which could all be moved toward a common implementation.
<p>A Commons package would give committers an opportunity to coordinate
their efforts to create and maintain a efficient, feature-rich package
under the ASF license.
<h3>(1) Scope of the Package</h3>
<p>The <em>Digester</em> project shall create and maintain a XML -> Java
object mapping package written in the Java language to be distributed
under the ASF license.
<h3>(1.5) Interaction With Other Packages</h3>
<p><em>Digester</em> relies on:
<li>Java Development Kit (Version 1.2 or later)</li>
<li>A JAXP 1.1 implementation</li>
<li>A SAX 2.0 parser conforming to the JAXP 1.1 APIs</li>
<li>BeanUtils from Commons - for instrospection information</li>
<li>Collections from Commons - inherited dependence from BeanUtils</li>
<h3>(2) Initial Source of the Package</h3>
<p>The initial codebase are an integral part of the
<a href="">Struts Framework</a>.
However, they have very few dependencies on other aspects of Struts, and
those dependencies have been removed in the proposed code base.
Once accepted and released as a Jakarta Commons component, Struts will
be modified to use the Commons version of these classes, and its internal
versions will be deprecated.</p>
<p>The proposed package name for the new component is
<h3>(3) Required Jakarta-Commons Resources</h3>
<li>CVS Repository - New directory <code>digester</code> in the
<code>jakarta-commons</code> CVS repository.</li>
<li>Initial Committers - Most of the initial commiters are already
committers on jakarta-commons,so the only addition is for user id sanders.</li>
<li>Mailing List - Discussions will take place on the general
<em></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
<li>Bugzilla - New component "Digester" under the "Commons" product
category, with appropriate version identifiers as needed.</li>
<li>Jyve FAQ - New category "commons-digester" (when available).</li>
<h3>(4) Initial Committers</h3>
<p>The initial committers on the Digester component shall be:</p>
<li>Geir Magnusson Jr.</li>
<li>Craig R. McClanahan</li>
<li>Scott Sanders</li>
<li>Rodney Waldhoff</li>