bitronix.tm.resource.jdbc

Class LruStatementCache

java.lang.Object

bitronix.tm.resource.jdbc.LruStatementCache

public class LruStatementCache
extends Object

Last Recently Used PreparedStatement cache with eviction listeners support implementation.

Author:

Ludovic Orban, Brett Wooldridge

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LruStatementCache.CacheKey

Constructor Summary

Constructors

Constructor and Description
LruStatementCache(int maxSize)

Method Summary

Modifier and Type	Method and Description
void	addEvictionListener(LruEvictionListener<PreparedStatement> listener)
protected void	clear() Evict all statements from the cache.
PreparedStatement	get(LruStatementCache.CacheKey key) The provided key is just a 'shell' JdbcPreparedStatementHandle, it comes in with no actual 'delegate' PreparedStatement.
PreparedStatement	put(LruStatementCache.CacheKey key, PreparedStatement statement) A statement is put into the cache.
void	removeEvictionListener(LruEvictionListener<PreparedStatement> listener)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LruStatementCache

public LruStatementCache(int maxSize)

Method Detail

get

public PreparedStatement get(LruStatementCache.CacheKey key)

The provided key is just a 'shell' JdbcPreparedStatementHandle, it comes in with no actual 'delegate' PreparedStatement. However, it contains all other pertinent information such as SQL statement, autogeneratedkeys flag, cursor holdability, etc. See the equals() method in the JdbcPreparedStatementHandle class. It is a complete key for a cached statement. If there is a matching cached PreparedStatement, it will be set as the delegate in the provided JdbcPreparedStatementHandle.

Parameters:

key - the cache key

Returns:

the cached JdbcPreparedStatementHandle statement, or null

put

public PreparedStatement put(LruStatementCache.CacheKey key,
                             PreparedStatement statement)

A statement is put into the cache. This is called when a statement is first prepared and also when a statement is closed (by the client). A "closed" statement has it's usage counter decremented in the cache.

Parameters:

key - a cache key

statement - a prepared statement handle

Returns:

a prepared statement

addEvictionListener

public void addEvictionListener(LruEvictionListener<PreparedStatement> listener)

removeEvictionListener

public void removeEvictionListener(LruEvictionListener<PreparedStatement> listener)

clear

protected void clear()

Evict all statements from the cache. This likely happens on connection close.