This is an automated email from the ASF dual-hosted git repository.
ggregory pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-dbcp.git
The following commit(s) were added to refs/heads/master by this push:
new dfe44b69 Add URLs to JDBC and Commons Pool.
dfe44b69 is described below
commit dfe44b69b731fead58cd3f1a3c94430a68fc7789
Author: Gary Gregory <[email protected]>
AuthorDate: Mon Jul 11 10:08:40 2022 -0400
Add URLs to JDBC and Commons Pool.
---
src/site/xdoc/index.xml | 196 ++++++++++++++++++++++++------------------------
1 file changed, 100 insertions(+), 96 deletions(-)
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index c7c26e91..ad5ca88e 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -1,96 +1,100 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
- <!--
- 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>
-
- <properties>
- <title>Overview</title>
- <author email="[email protected]">Commons Documentation Team</author>
- </properties>
-
- <body>
-
-<section name="The DBCP Component">
-
-<p>Many Apache projects support interaction with a relational database.
-Creating a new connection for each user can be time consuming (often
-requiring multiple seconds of clock time), in order to perform a database
-transaction that might take milliseconds. Opening a connection per user
-can be unfeasible in a publicly-hosted Internet application where the
-number of simultaneous users can be very large. Accordingly, developers
-often wish to share a "pool" of open connections between all of the
-application's current users. The number of users actually performing
-a request at any given time is usually a very small percentage of the
-total number of active users, and during request processing is the only
-time that a database connection is required. The application itself logs
-into the DBMS, and handles any user account issues internally.</p>
-
-<p>There are several Database Connection Pools already available, both
-within Apache products and elsewhere. This Commons package provides an
-opportunity to coordinate the efforts required to create and maintain an
-efficient, feature-rich package under the ASF license.</p>
-
-<p>The <code>commons-dbcp2</code> artifact relies on code in the
-<code>commons-pool2</code> artifact to provide the underlying object pool
-mechanisms.</p>
-
-<p>DBCP now comes in four different versions to support different versions of
-JDBC. Here is how it works:</p>
-<p>Developing</p>
-<ul>
-<li>DBCP 2.5.0 and up compiles and runs under Java 8 (JDBC 4.2) and up.</li>
-<li>DBCP 2.4.0 compiles and runs under Java 7 (JDBC 4.1) and above.</li>
-</ul>
-<p>Running</p>
-<ul>
-<li>DBCP 2.5.0 and up binaries should be used by applications running on Java
8 and up.</li>
-<li>DBCP 2.4.0 binaries should be used by applications running under Java
7.</li>
-</ul>
-<p>DBCP 2 is based on Commons Pool 2 and provides increased performance, JMX
-support as well as numerous other new features compared to DBCP 1.x. Users
-upgrading to 2.x should be aware that the Java package name has changed, as
well
-as the Maven co-ordinates, since DBCP 2.x is not binary compatible with DBCP
-1.x. Users should also be aware that some configuration options (e.g. maxActive
-to maxTotal) have been renamed to align them with the new names used by Commons
-Pool 2.</p>
-
-</section>
-
-<section name="Releases">
- <p>
- See the <a href="download_dbcp.cgi">downloads</a> page for information
on
- obtaining releases.
- </p>
-</section>
-
-<section name="Documentation">
-
-<p>The
-<a href="apidocs/index.html">Javadoc API documents</a>
-are available online. In particular, you should
-read the package overview of the
-<code><a
href="apidocs/org/apache/commons/dbcp2/package-summary.html#package_description">org.apache.commons.dbcp2</a></code>
-package for an overview of how to use DBCP.</p>
-
-<p>There are
-<a
href="https://gitbox.apache.org/repos/asf?p=commons-dbcp.git;a=tree;f=doc;hb=refs/heads/master";>several
examples</a>
-of using DBCP available.</p>
-
-</section>
-
-</body>
-</document>
+<?xml version="1.0" encoding="ISO-8859-1"?>
+ <!--
+ 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>
+
+ <properties>
+ <title>Overview</title>
+ <author email="[email protected]">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+
+<section name="The DBCP Component">
+
+<p>Many Apache projects support interaction with a relational database.
+Creating a new connection for each user can be time consuming (often
+requiring multiple seconds of clock time), in order to perform a database
+transaction that might take milliseconds. Opening a connection per user
+can be unfeasible in a publicly-hosted Internet application where the
+number of simultaneous users can be very large. Accordingly, developers
+often wish to share a "pool" of open connections between all of the
+application's current users. The number of users actually performing
+a request at any given time is usually a very small percentage of the
+total number of active users, and during request processing is the only
+time that a database connection is required. The application itself logs
+into the DBMS, and handles any user account issues internally.</p>
+
+<p>There are several Database Connection Pools already available, both
+within Apache products and elsewhere. This Commons package provides an
+opportunity to coordinate the efforts required to create and maintain an
+efficient, feature-rich package under the ASF license.</p>
+
+<p>The <code>commons-dbcp2</code> artifact relies on code in the
+<code>commons-pool2</code> artifact to provide the underlying object pool
+mechanisms.</p>
+
+<p>DBCP now comes in four different versions to support different versions of
+JDBC. Here is how it works:</p>
+<p>Developing</p>
+<ul>
+<li>DBCP 2.5.0 and up compiles and runs under Java 8
+(<a
href="https://docs.oracle.com/javase/8/docs/technotes/guides/jdbc/jdbc_42.html";>JDBC
4.2</a>) and up.</li>
+<li>DBCP 2.4.0 compiles and runs under Java 7
+(<a
href="https://docs.oracle.com/javase/7/docs/technotes/guides/jdbc/jdbc_41.html";>JDBC
4.1</a>) and above.</li>
+</ul>
+<p>Running</p>
+<ul>
+<li>DBCP 2.5.0 and up binaries should be used by applications running on Java
8 and up.</li>
+<li>DBCP 2.4.0 binaries should be used by applications running under Java
7.</li>
+</ul>
+<p>DBCP 2 is based on
+<a href="https://commons.apache.org/proper/commons-pool/";>Apache Commons
Pool</a>
+and provides increased performance, JMX
+support as well as numerous other new features compared to DBCP 1.x. Users
+upgrading to 2.x should be aware that the Java package name has changed, as
well
+as the Maven co-ordinates, since DBCP 2.x is not binary compatible with DBCP
+1.x. Users should also be aware that some configuration options (e.g. maxActive
+to maxTotal) have been renamed to align them with the new names used by Commons
+Pool.</p>
+
+</section>
+
+<section name="Releases">
+ <p>
+ See the <a href="download_dbcp.cgi">downloads</a> page for information
on
+ obtaining releases.
+ </p>
+</section>
+
+<section name="Documentation">
+
+<p>The
+<a href="apidocs/index.html">Javadoc API documents</a>
+are available online. In particular, you should
+read the package overview of the
+<code><a
href="apidocs/org/apache/commons/dbcp2/package-summary.html#package_description">org.apache.commons.dbcp2</a></code>
+package for an overview of how to use DBCP.</p>
+
+<p>There are
+<a
href="https://gitbox.apache.org/repos/asf?p=commons-dbcp.git;a=tree;f=doc;hb=refs/heads/master";>several
examples</a>
+of using DBCP available.</p>
+
+</section>
+
+</body>
+</document>
