[logback-dev] svn commit: r1084 - logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db
noreply.seb at qos.ch
noreply.seb at qos.ch
Thu Dec 14 18:44:37 CET 2006
Author: seb
Date: Thu Dec 14 18:44:37 2006
New Revision: 1084
Modified:
logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/ConnectionSource.java
logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DataSourceConnectionSource.java
logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DriverManagerConnectionSource.java
logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/JNDIConnectionSource.java
Log:
javadoc update
Modified: logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/ConnectionSource.java
==============================================================================
--- logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/ConnectionSource.java (original)
+++ logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/ConnectionSource.java Thu Dec 14 18:44:37 2006
@@ -19,6 +19,9 @@
* The <id>ConnectionSource</id> interface provides a pluggable means of
* transparently obtaining JDBC {@link java.sql.Connection}s for logback classes
* that require the use of a {@link java.sql.Connection}.
+ *
+ * For more informations about this component, please refer to the online manual at
+ * http://logback.qos.ch/manual/appenders.html#DBAppender
*
* @author <a href="mailto:rdecampo at twcny.rr.com">Ray DeCampo</a>
*/
Modified: logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DataSourceConnectionSource.java
==============================================================================
--- logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DataSourceConnectionSource.java (original)
+++ logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DataSourceConnectionSource.java Thu Dec 14 18:44:37 2006
@@ -21,6 +21,9 @@
* manner based on a {@link javax.sql.DataSource DataSource}.
* <p>
*
+ * For more informations about this component, please refer to the online manual at
+ * http://logback.qos.ch/manual/appenders.html#DBAppender
+ *
* @author Ray DeCampo
* @author Ceki Gülcü
*/
Modified: logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DriverManagerConnectionSource.java
==============================================================================
--- logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DriverManagerConnectionSource.java (original)
+++ logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/DriverManagerConnectionSource.java Thu Dec 14 18:44:37 2006
@@ -19,45 +19,8 @@
* {@link ConnectionSource} that obtains the Connection in the traditional JDBC
* manner based on the connection URL.
* <p>
- * Note that this class will establish a new Connection for each call to
- * {@link #getConnection()}. It is recommended that you either use a JDBC
- * driver that natively supported Connection pooling or that you create your own
- * implementation of {@link ConnectionSource} that taps into whatever pooling
- * mechanism you are already using. (If you have access to a JNDI implementation
- * that supports {@link javax.sql.DataSource}s, e.g. within a J2EE application
- * server, see {@link JNDIConnectionSource}). See <a href="#dbcp">below</a>
- * for a configuration example that uses the <a
- * href="http://jakarta.apache.org/commons/dbcp/index.html">commons-dbcp</a>
- * package from Apache.
- * <p>
- * Sample configuration:<br>
- *
- * <pre>
- * <connectionSource class="org.apache.log4j.jdbc.DriverManagerConnectionSource">
- * <param name="driver" value="com.mysql.jdbc.Driver" />
- * <param name="url" value="jdbc:mysql://localhost:3306/mydb" />
- * <param name="username" value="myUser" />
- * <param name="password" value="myPassword" />
- * </connectionSource>
- * </pre>
- *
- * <p>
- * <a name="dbcp">If</a> you do not have another connection pooling mechanism
- * built into your application, you can use the <a
- * href="http://jakarta.apache.org/commons/dbcp/index.html">commons-dbcp</a>
- * package from Apache:<br>
- *
- * <pre>
- * <connectionSource class="org.apache.log4j.jdbc.DriverManagerConnectionSource">
- * <param name="driver" value="org.apache.commons.dbcp.PoolingDriver" />
- * <param name="url" value="jdbc:apache:commons:dbcp:/myPoolingDriver" />
- * </connectionSource>
- * </pre>
- *
- * Then the configuration information for the commons-dbcp package goes into the
- * file myPoolingDriver.jocl and is placed in the classpath. See the <a
- * href="http://jakarta.apache.org/commons/dbcp/index.html">commons-dbcp</a>
- * documentation for details.
+ * For more informations about this component, please refer to the online manual at
+ * http://logback.qos.ch/manual/appenders.html#DBAppender
*
* @author <a href="mailto:rdecampo at twcny.rr.com">Ray DeCampo</a>
*/
Modified: logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/JNDIConnectionSource.java
==============================================================================
--- logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/JNDIConnectionSource.java (original)
+++ logback/trunk/logback-core/src/main/java/ch/qos/logback/core/db/JNDIConnectionSource.java Thu Dec 14 18:44:37 2006
@@ -30,31 +30,8 @@
* of connection pooling and whatever other goodies the application server
* provides.
* <p>
- * Sample configuration:<br>
- *
- * <pre>
- * <connectionSource class="org.apache.log4j.jdbc.JNDIConnectionSource">
- * <param name="jndiLocation" value="jdbc/MySQLDS" />
- * </connectionSource>
- * </pre>
- *
- * <p>
- * Sample configuration (with username and password):<br>
- *
- * <pre>
- * <connectionSource class="org.apache.log4j.jdbc.JNDIConnectionSource">
- * <param name="jndiLocation" value="jdbc/MySQLDS" />
- * <param name="username" value="myUser" />
- * <param name="password" value="myPassword" />
- * </connectionSource>
- * </pre>
- *
- * <p>
- * Note that this class will obtain an {@link javax.naming.InitialContext} using
- * the no-argument constructor. This will usually work when executing within a
- * J2EE environment. When outside the J2EE environment, make sure that you
- * provide a jndi.properties file as described by your JNDI provider's
- * documentation.
+ * For more informations about this component, please refer to the online manual at
+ * http://logback.qos.ch/manual/appenders.html#DBAppender
*
* @author <a href="mailto:rdecampo at twcny.rr.com">Ray DeCampo</a>
*/
More information about the logback-dev
mailing list