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@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@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@twcny.rr.com">Ray DeCampo</a> */