Repository: commons-dbcp Updated Branches: refs/heads/master 25d940708 -> 2ce7b2c3d
Format Javadoc to line length 120. Project: http://git-wip-us.apache.org/repos/asf/commons-dbcp/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-dbcp/commit/2ce7b2c3 Tree: http://git-wip-us.apache.org/repos/asf/commons-dbcp/tree/2ce7b2c3 Diff: http://git-wip-us.apache.org/repos/asf/commons-dbcp/diff/2ce7b2c3 Branch: refs/heads/master Commit: 2ce7b2c3d10c6ae928b975705db26d969453913d Parents: 25d9407 Author: Gary Gregory <garydgreg...@gmail.com> Authored: Mon Jun 11 09:50:19 2018 -0600 Committer: Gary Gregory <garydgreg...@gmail.com> Committed: Mon Jun 11 09:50:19 2018 -0600 ---------------------------------------------------------------------- .../apache/commons/dbcp2/PoolingDataSource.java | 38 +++++++++++--------- 1 file changed, 22 insertions(+), 16 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-dbcp/blob/2ce7b2c3/src/main/java/org/apache/commons/dbcp2/PoolingDataSource.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/dbcp2/PoolingDataSource.java b/src/main/java/org/apache/commons/dbcp2/PoolingDataSource.java index 89a872b..99e89d5 100644 --- a/src/main/java/org/apache/commons/dbcp2/PoolingDataSource.java +++ b/src/main/java/org/apache/commons/dbcp2/PoolingDataSource.java @@ -32,10 +32,10 @@ import org.apache.commons.pool2.ObjectPool; import org.apache.commons.pool2.impl.GenericObjectPool; /** - * A simple {@link DataSource} implementation that obtains - * {@link Connection}s from the specified {@link ObjectPool}. + * A simple {@link DataSource} implementation that obtains {@link Connection}s from the specified {@link ObjectPool}. * - * @param <C> The connection type + * @param <C> + * The connection type * * @author Rodney Waldhoff * @author Glenn L. Nielsen @@ -68,6 +68,7 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Close and free all {@link Connection}s from the pool. + * * @since 2.1 */ @Override @@ -91,11 +92,11 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto } /** - * Sets the value of the accessToUnderlyingConnectionAllowed property. - * It controls if the PoolGuard allows access to the underlying connection. - * (Default: false) + * Sets the value of the accessToUnderlyingConnectionAllowed property. It controls if the PoolGuard allows access to + * the underlying connection. (Default: false) * - * @param allow Access to the underlying connection is granted when true. + * @param allow + * Access to the underlying connection is granted when true. */ public void setAccessToUnderlyingConnectionAllowed(final boolean allow) { this.accessToUnderlyingConnectionAllowed = allow; @@ -121,8 +122,8 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto //--- DataSource methods ----------------------------------------- /** - * Return a {@link java.sql.Connection} from my pool, - * according to the contract specified by {@link ObjectPool#borrowObject}. + * Return a {@link java.sql.Connection} from my pool, according to the contract specified by + * {@link ObjectPool#borrowObject}. */ @Override public Connection getConnection() throws SQLException { @@ -149,7 +150,8 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Throws {@link UnsupportedOperationException} - * @throws UnsupportedOperationException + * + * @throws UnsupportedOperationException always thrown */ @Override public Connection getConnection(final String uname, final String passwd) throws SQLException { @@ -158,6 +160,7 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Returns my log writer. + * * @return my log writer * @see DataSource#getLogWriter */ @@ -168,8 +171,9 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Throws {@link UnsupportedOperationException}. - * @throws UnsupportedOperationException As this - * implementation does not support this feature. + * + * @throws UnsupportedOperationException + * As this implementation does not support this feature. */ @Override public int getLoginTimeout() { @@ -178,8 +182,9 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Throws {@link UnsupportedOperationException}. - * @throws UnsupportedOperationException As this - * implementation does not support this feature. + * + * @throws UnsupportedOperationException + * As this implementation does not support this feature. */ @Override public void setLoginTimeout(final int seconds) { @@ -188,6 +193,7 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto /** * Sets my log writer. + * * @see DataSource#setLogWriter */ @Override @@ -205,8 +211,8 @@ public class PoolingDataSource<C extends Connection> implements DataSource, Auto } /** - * PoolGuardConnectionWrapper is a Connection wrapper that makes sure a - * closed connection cannot be used anymore. + * PoolGuardConnectionWrapper is a Connection wrapper that makes sure a closed connection cannot be used anymore. + * * @since 2.0 */ private class PoolGuardConnectionWrapper<D extends Connection>
