| <!-- |
| 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. |
| --> |
| <document xmlns="http://maven.apache.org/XDOC/2.0" |
| xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
| xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"> |
| <properties> |
| <title>Proposal for Commons DBUtils Package</title> |
| </properties> |
| <body> |
| |
| |
| <section name="Proposal for DBUtils Package"> |
| |
| |
| |
| <subsection name="(0) Rationale"> |
| |
| <p> |
| Correct JDBC coding is time consuming and error prone. Many |
| JDBC coding tasks can be simplified with a small helper library |
| that factors out the mundane resource cleanup steps. DbUtils |
| is focused on providing such a library without any heavyweight |
| framework surrounding it. |
| </p> |
| |
| |
| </subsection> |
| <subsection name="(1) Scope of the Package"> |
| |
| <p> |
| This proposal is to create a package of Java utility classes for |
| various types of JDBC related activity. DbUtils will |
| not be an OO representation of database objects nor will |
| it be an Object/Relational framework. It will be |
| a lightweight JDBC library that helps developers write |
| correct database code. |
| </p> |
| |
| |
| </subsection> |
| <subsection name="(1.5) Interaction With Other Packages"> |
| |
| <p><em>DBUtils</em> relies only on standard Java 1.2 (or later) APIs for |
| production deployment. It utilizes the JUnit testing framework for |
| developing and executing unit tests, but this is of interest only to |
| developers of the component. Being dependent on Java 1.2 means that |
| this code is expected to be of JDBC 2.0 level. |
| </p> |
| |
| <p> |
| No external configuration files are utilized. |
| </p> |
| |
| |
| </subsection> |
| <subsection name="(2) Initial Source of the Package"> |
| |
| <p> |
| Potential source code for this package will come from the initial |
| committers' personal libraries. |
| </p> |
| |
| <p> |
| The proposed package name for the new component is |
| <code>org.apache.commons.dbutils</code>. |
| </p> |
| |
| |
| </subsection> |
| <subsection name="(3) Required Jakarta-Commons Resources"> |
| |
| <ul> |
| <li>CVS Repository - New directory <code>dbutils</code> in the |
| <code>jakarta-commons</code> CVS repository.</li> |
| <li>Mailing List - Discussions will take place on the general |
| <em>dev@commons.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 |
| [dbutils].</li> |
| <li>Bugzilla - New component "DBUtils" under the "Commons" product |
| category, with appropriate version identifiers as needed.</li> |
| </ul> |
| |
| |
| </subsection> |
| <subsection name="(4) Initial Committers"> |
| |
| <p>The initial committers on the DBUtils component shall be:</p> |
| <ul> |
| <li>Henri Yandell</li> |
| <li>Steven Caswell</li> |
| <li>Juozas Baliuka</li> |
| <li>David Graham</li> |
| </ul> |
| |
| </subsection> |
| </section> |
| </body> |
| </document> |