WebLogic Server 8.1 API Reference

weblogic.jdbc.extensions
Interface WLConnection

public interface WLConnection

Contains methods to interact with the Statement Cache

Author:

Copyright © 2004 BEA Systems, Inc. All Rights Reserved.

Method Summary

boolean	clearCallableStatement(java.lang.String sql) Clears a callable statement from the Statement Cache
boolean	clearCallableStatement(java.lang.String sql, int resType, int resConcurrency) Clears a callable statement from the Statement Cache
boolean	clearPreparedStatement(java.lang.String sql) Clears a prepared statement from the Statement Cache
boolean	clearPreparedStatement(java.lang.String sql, int resType, int resConcurrency) Clears a prepared statement from the Statement Cache
void	clearStatementCache() Clears the statement cache.
java.lang.String	getPoolName() Returns the name of the connection pool to which this connection belongs to.
java.sql.Connection	getVendorConnection() Returns the underlying physical connection (the vendor connection) from a pooled database connection (a logical connection).

Method Detail

clearStatementCache

public void clearStatementCache()
                         throws java.sql.SQLException

Clears the statement cache.

Throws:

java.sql.SQLException - - if a database access error occurs

getVendorConnection

public java.sql.Connection getVendorConnection()
                                        throws java.sql.SQLException

Returns the underlying physical connection (the vendor connection) from a pooled database connection (a logical connection).

Returns:

java.sql.Connection

Throws:

java.sql.SQLException - - if a database access error occurs

clearCallableStatement

public boolean clearCallableStatement(java.lang.String sql)
                               throws java.sql.SQLException

Clears a callable statement from the Statement Cache

Parameters:

sql - - an SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is a JDBC function call escape string.

Returns:

true - statement found and removed from cache
false - statement not found in cache. This is not always an erroneous condition as it can happen if statement caching is diabled, or the statement got ejected from the cache to make space for another.

Throws:

java.sql.SQLException - - if a database access error occurs

clearCallableStatement

public boolean clearCallableStatement(java.lang.String sql,
                                      int resType,
                                      int resConcurrency)
                               throws java.sql.SQLException

Clears a callable statement from the Statement Cache

Parameters:

sql - - an SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is a JDBC function call escape string.

resSetType - - a result set type; one of ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE

resSetConcurrency - - a concurrency type; one of ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE

Returns:

true - statement found and removed from cache
false - statement not found in cache. This is not always an erroneous condition as it can happen if statement caching is diabled, or the statement got ejected from the cache to make space for another.

Throws:

java.sql.SQLException - - if a database access error occurs

clearPreparedStatement

public boolean clearPreparedStatement(java.lang.String sql)
                               throws java.sql.SQLException

Clears a prepared statement from the Statement Cache

Parameters:

sql - - an SQL statement that may contain one or more '?' IN parameter placeholders

Returns:

true - statement found and removed from cache
false - statement not found in cache. This is not always an erroneous condition as it can happen if statement caching is diabled, or the statement got ejected from the cache to make space for another.

Throws:

java.sql.SQLException - - if a database access error occurs

clearPreparedStatement

public boolean clearPreparedStatement(java.lang.String sql,
                                      int resType,
                                      int resConcurrency)
                               throws java.sql.SQLException

Clears a prepared statement from the Statement Cache

Parameters:

sql - - an SQL statement that may contain one or more '?' IN parameter placeholders

resSetType - - a result set type; one of ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE

resSetConcurrency - - a concurrency type; one of ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE

Returns:

true - statement found and removed from cache
false - statement not found in cache. This is not always an erroneous condition as it can happen if statement caching is diabled, or the statement got ejected from the cache to make space for another.

Throws:

java.sql.SQLException - - if a database access error occurs

getPoolName

public java.lang.String getPoolName()

Returns the name of the connection pool to which this connection belongs to.