com.thinkaurelius.titan.diskstorage.cassandra.thrift.thriftpool

Class CTConnectionPool

java.lang.Object

org.apache.commons.pool.BaseKeyedObjectPool<K,V>

org.apache.commons.pool.impl.GenericKeyedObjectPool<String,CTConnection>

com.thinkaurelius.titan.diskstorage.cassandra.thrift.thriftpool.CTConnectionPool

Type Parameters:

K - Key type

V - Pooled object type

All Implemented Interfaces:

org.apache.commons.pool.KeyedObjectPool<String,CTConnection>

public class CTConnectionPool
extends org.apache.commons.pool.impl.GenericKeyedObjectPool<String,CTConnection>

This class extends Apache Commons Pool's GenericKeyedObjectPool, adding two methods that support Java 5 generic type safety. However, a programmer can still cause RuntimeExceptions related to type errors by mixing calls to these additional methods with calls to the legacy "Object"-typed methods.

Unfortunately, GenericKeyedObjectPool is not actually generic in the type-system sense. All of its methods are typed to Object, forcing the client programmer to sprinkle code with casts. This class centralizes that casting to a single method.

As a corollary, this class is slightly less flexible than GenericKeyedObjectPool, as this class can only store keys and pooled objects each of a single type, whereas GenericKeyedObjectPool could theoretically contain heterogeneous types of each. However, I do not need the flexibility of heterogeneous types for pooling Thrift connections, the original work that precipitated writing this class.

Author:

Dan LaRocque

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.commons.pool.impl.GenericKeyedObjectPool

org.apache.commons.pool.impl.GenericKeyedObjectPool.Config

Field Summary

Fields inherited from class org.apache.commons.pool.impl.GenericKeyedObjectPool

DEFAULT_LIFO, DEFAULT_MAX_ACTIVE, DEFAULT_MAX_IDLE, DEFAULT_MAX_TOTAL, DEFAULT_MAX_WAIT, DEFAULT_MIN_EVICTABLE_IDLE_TIME_MILLIS, DEFAULT_MIN_IDLE, DEFAULT_NUM_TESTS_PER_EVICTION_RUN, DEFAULT_TEST_ON_BORROW, DEFAULT_TEST_ON_RETURN, DEFAULT_TEST_WHILE_IDLE, DEFAULT_TIME_BETWEEN_EVICTION_RUNS_MILLIS, DEFAULT_WHEN_EXHAUSTED_ACTION, WHEN_EXHAUSTED_BLOCK, WHEN_EXHAUSTED_FAIL, WHEN_EXHAUSTED_GROW

Constructor Summary

Constructors

Constructor and Description
CTConnectionPool(org.apache.commons.pool.KeyedPoolableObjectFactory<String,CTConnection> factory)

Method Summary

Modifier and Type	Method and Description
void	returnObjectUnsafe(String keyspace, CTConnection conn) If conn is non-null and is still open, then call {@link GenericKeyedObjectPool#returnObject(String, CTConnection), catching and logging and Exception that method might generate.

Methods inherited from class org.apache.commons.pool.impl.GenericKeyedObjectPool

addObject, borrowObject, clear, clear, clearOldest, close, evict, getLifo, getMaxActive, getMaxIdle, getMaxTotal, getMaxWait, getMinEvictableIdleTimeMillis, getMinIdle, getNumActive, getNumActive, getNumIdle, getNumIdle, getNumTestsPerEvictionRun, getTestOnBorrow, getTestOnReturn, getTestWhileIdle, getTimeBetweenEvictionRunsMillis, getWhenExhaustedAction, invalidateObject, preparePool, returnObject, setConfig, setFactory, setLifo, setMaxActive, setMaxIdle, setMaxTotal, setMaxWait, setMinEvictableIdleTimeMillis, setMinIdle, setNumTestsPerEvictionRun, setTestOnBorrow, setTestOnReturn, setTestWhileIdle, setTimeBetweenEvictionRunsMillis, setWhenExhaustedAction, startEvictor

Methods inherited from class org.apache.commons.pool.BaseKeyedObjectPool

assertOpen, isClosed

Methods inherited from class java.lang.Object

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

Constructor Detail

CTConnectionPool

public CTConnectionPool(org.apache.commons.pool.KeyedPoolableObjectFactory<String,CTConnection> factory)

Method Detail

returnObjectUnsafe

public void returnObjectUnsafe(String keyspace,
                               CTConnection conn)

If conn is non-null and is still open, then call {@link GenericKeyedObjectPool#returnObject(String, CTConnection), catching and logging and Exception that method might generate. This method does not emit any exceptions.

Parameters:

keyspace - The key of the pooled object being returned

conn - The pooled object being returned, or null to do nothing