blob: cce5aad38f630389f4dd6ba36aecfd1249c3c6c5 [file] [log] [blame]
<html>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<head>
<title>Proposal for Digester Package</title>
</head>
<body bgcolor="white">
<div align="center">
<h1>Proposal for <em>Digester</em> Package</h1>
</div>
<h3>(0) Rationale</h3>
<p>Many Jakarta products read XML configuration files to provide
initialization of various Java objects within the system.
</p>
<p>There are several ways of doing this now spread across various Jakarta
projects which could all be moved toward a common implementation.
</p>
<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.
</p>
<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:
</p>
<ul>
<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>
</ul>
<h3>(2) Initial Source of the Package</h3>
<p>The initial codebase are an integral part of the
<a href="http://jakarta.apache.org/struts">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
org.apache.commons.digester.
</p>
<h3>(3) Required Jakarta-Commons Resources</h3>
<ul>
<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>jakarta-commons@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
[Digester].</li>
<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>
</ul>
<h3>(4) Initial Committers</h3>
<p>The initial committers on the Digester component shall be:</p>
<ul>
<li>Geir Magnusson Jr.</li>
<li>Craig R. McClanahan</li>
<li>Scott Sanders</li>
<li>Rodney Waldhoff</li>
</ul>
</body>
</html>