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 [EMAIL PROTECTED] java.sql.Connection}s for
logback classes
* that require the use of a [EMAIL PROTECTED] 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:[EMAIL PROTECTED]">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 [EMAIL PROTECTED] 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 @@
* [EMAIL PROTECTED] 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
- * [EMAIL PROTECTED] #getConnection()}. It is recommended that you either use
a JDBC
- * driver that natively supported Connection pooling or that you create your
own
- * implementation of [EMAIL PROTECTED] ConnectionSource} that taps into
whatever pooling
- * mechanism you are already using. (If you have access to a JNDI
implementation
- * that supports [EMAIL PROTECTED] javax.sql.DataSource}s, e.g. within a J2EE
application
- * server, see [EMAIL PROTECTED] 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:[EMAIL PROTECTED]">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 [EMAIL PROTECTED]
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:[EMAIL PROTECTED]">Ray DeCampo</a>
*/
_______________________________________________
logback-dev mailing list
[email protected]
http://qos.ch/mailman/listinfo/logback-dev
