PROPOSAL.html - commons-digester - Git at Google

 <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>
	<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>