[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&uuml;lc&uuml;
  */

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>
- *      &lt;connectionSource class=&quot;org.apache.log4j.jdbc.DriverManagerConnectionSource&quot;&gt;
- *         &lt;param name=&quot;driver&quot; value=&quot;com.mysql.jdbc.Driver&quot; /&gt;
- *         &lt;param name=&quot;url&quot; value=&quot;jdbc:mysql://localhost:3306/mydb&quot; /&gt;
- *         &lt;param name=&quot;username&quot; value=&quot;myUser&quot; /&gt;
- *         &lt;param name=&quot;password&quot; value=&quot;myPassword&quot; /&gt;
- *      &lt;/connectionSource&gt;
- * </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>
- *      &lt;connectionSource class=&quot;org.apache.log4j.jdbc.DriverManagerConnectionSource&quot;&gt;
- *         &lt;param name=&quot;driver&quot; value=&quot;org.apache.commons.dbcp.PoolingDriver&quot; /&gt;
- *         &lt;param name=&quot;url&quot; value=&quot;jdbc:apache:commons:dbcp:/myPoolingDriver&quot; /&gt;
- *      &lt;/connectionSource&gt;
- * </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>
- *     &lt;connectionSource class=&quot;org.apache.log4j.jdbc.JNDIConnectionSource&quot;&gt;
- *         &lt;param name=&quot;jndiLocation&quot; value=&quot;jdbc/MySQLDS&quot; /&gt;
- *     &lt;/connectionSource&gt;
- * </pre>
- * 
- * <p>
- * Sample configuration (with username and password):<br>
- * 
- * <pre>
- *     &lt;connectionSource class=&quot;org.apache.log4j.jdbc.JNDIConnectionSource&quot;&gt;
- *         &lt;param name=&quot;jndiLocation&quot; value=&quot;jdbc/MySQLDS&quot; /&gt;
- *         &lt;param name=&quot;username&quot; value=&quot;myUser&quot; /&gt;
- *         &lt;param name=&quot;password&quot; value=&quot;myPassword&quot; /&gt;
- *     &lt;/connectionSource&gt;
- * </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