You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ps...@apache.org on 2007/01/28 00:33:47 UTC
svn commit: r500687 - in
/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp: ./
cpdsadapter/ datasources/
Author: psteitz
Date: Sat Jan 27 15:33:47 2007
New Revision: 500687
URL: http://svn.apache.org/viewvc?view=rev&rev=500687
Log:
Javadoc. Added @since tags for methods added in 1.2.2.
Modified:
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingConnection.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingPreparedStatement.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingStatement.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/PoolingDriver.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/cpdsadapter/DriverAdapterCPDS.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/InstanceKeyDataSource.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/PerUserPoolDataSource.java
jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/SharedPoolDataSource.java
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingConnection.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingConnection.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingConnection.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingConnection.java Sat Jan 27 15:33:47 2007
@@ -80,6 +80,12 @@
_conn = c;
}
+ /**
+ * Returns a string representation of the metadata associated with
+ * the innnermost delegate connection.
+ *
+ * @since 1.2.2
+ */
public String toString() {
String s = null;
@@ -122,6 +128,13 @@
return _conn;
}
+ /**
+ * Compares innermost delegate to the given connection.
+ *
+ * @param c connection to compare innermost delegate with
+ * @return true if innermost delegate equals <code>c</code>
+ * @since 1.2.2
+ */
public boolean innermostDelegateEquals(Connection c) {
Connection innerCon = getInnermostDelegate();
if (innerCon == null) {
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingPreparedStatement.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingPreparedStatement.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingPreparedStatement.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingPreparedStatement.java Sat Jan 27 15:33:47 2007
@@ -204,7 +204,8 @@
/**
* Returns a String representation of this object.
*
- * @return String
+ * @return String
+ * @since 1.2.2
*/
public String toString() {
return _stmt.toString();
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingStatement.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingStatement.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingStatement.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/DelegatingStatement.java Sat Jan 27 15:33:47 2007
@@ -300,6 +300,7 @@
* Returns a String representation of this object.
*
* @return String
+ * @since 1.2.2
*/
public String toString() {
return _stmt.toString();
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/PoolingDriver.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/PoolingDriver.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/PoolingDriver.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/PoolingDriver.java Sat Jan 27 15:33:47 2007
@@ -193,6 +193,15 @@
}
}
+ /**
+ * Invalidates the given connection.
+ *
+ * @param conn connection to invalidate
+ * @throws SQLException if the connection is not a
+ * <code>PoolGuardConnectionWrapper</code> or an error occurs invalidating
+ * the connection
+ * @since 1.2.2
+ */
public void invalidateConnection(Connection conn) throws SQLException {
if (conn instanceof PoolGuardConnectionWrapper) { // normal case
PoolGuardConnectionWrapper pgconn = (PoolGuardConnectionWrapper) conn;
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/cpdsadapter/DriverAdapterCPDS.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/cpdsadapter/DriverAdapterCPDS.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/cpdsadapter/DriverAdapterCPDS.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/cpdsadapter/DriverAdapterCPDS.java Sat Jan 27 15:33:47 2007
@@ -577,11 +577,25 @@
assertInitializationAllowed();
_minEvictableIdleTimeMillis = minEvictableIdleTimeMillis;
}
+
+ /**
+ * Returns the maximun number of prepared statements.
+ *
+ * @return maxPrepartedStatements value
+ * @since 1.2.2
+ */
public int getMaxPreparedStatements()
{
return _maxPreparedStatements;
}
+ /**
+ * Sets the maximum number of prepared statements.
+ * @param maxPreparedStatements the new maximum number of prepared
+ * statements
+ *
+ * @since 1.2.2
+ */
public void setMaxPreparedStatements(int maxPreparedStatements)
{
_maxPreparedStatements = maxPreparedStatements;
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/InstanceKeyDataSource.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/InstanceKeyDataSource.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/InstanceKeyDataSource.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/InstanceKeyDataSource.java Sat Jan 27 15:33:47 2007
@@ -616,6 +616,10 @@
* Whether a rollback will be issued after executing the SQL query
* that will be used to validate connections from this pool
* before returning them to the caller.
+ *
+ * @return true if a rollback will be issued after executing the
+ * validation query
+ * @since 1.2.2
*/
public boolean isRollbackAfterValidation() {
return (this.rollbackAfterValidation);
@@ -626,7 +630,10 @@
* that will be used to validate connections from this pool
* before returning them to the caller. Default behavior is NOT
* to issue a rollback. The setting will only have an effect
- * if a validation query is set.
+ * if a validation query is set
+ *
+ * @param rollbackAfterValidation new property value
+ * @since 1.2.2
*/
public void setRollbackAfterValidation(boolean rollbackAfterValidation) {
assertInitializationAllowed();
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/PerUserPoolDataSource.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/PerUserPoolDataSource.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/PerUserPoolDataSource.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/PerUserPoolDataSource.java Sat Jan 27 15:33:47 2007
@@ -422,6 +422,11 @@
con.setReadOnly(defaultReadOnly);
}
+ /**
+ * Returns a <code>PerUserPoolDataSource</code> {@link Reference}.
+ *
+ * @since 1.2.2
+ */
public Reference getReference() throws NamingException {
Reference ref = new Reference(getClass().getName(),
PerUserPoolDataSourceFactory.class.getName(), null);
Modified: jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/SharedPoolDataSource.java
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/SharedPoolDataSource.java?view=diff&rev=500687&r1=500686&r2=500687
==============================================================================
--- jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/SharedPoolDataSource.java (original)
+++ jakarta/commons/proper/dbcp/trunk/src/java/org/apache/commons/dbcp/datasources/SharedPoolDataSource.java Sat Jan 27 15:33:47 2007
@@ -174,6 +174,11 @@
return info;
}
+ /**
+ * Returns a <code>SharedPoolDataSource</code> {@link Reference}.
+ *
+ * @since 1.2.2
+ */
public Reference getReference() throws NamingException {
Reference ref = new Reference(getClass().getName(),
SharedPoolDataSourceFactory.class.getName(), null);
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org