Package org.apache.commons.pool2.impl
Class BaseObjectPoolConfig<T>
java.lang.Object
org.apache.commons.pool2.BaseObject
org.apache.commons.pool2.impl.BaseObjectPoolConfig<T>
- Type Parameters:
T
- Type of element pooled.
- All Implemented Interfaces:
Cloneable
- Direct Known Subclasses:
GenericKeyedObjectPoolConfig
,GenericObjectPoolConfig
Provides the implementation for the common attributes shared by the sub-classes. New instances of this class will be created using the defaults defined by
the public constants.
This class is not thread-safe.
- Since:
- 2.0
-
Field Summary
Modifier and TypeFieldDescriptionstatic final boolean
The default value for theblockWhenExhausted
configuration attribute.static final Duration
The default value for thetimeBetweenEvictionRuns
configuration attribute.static final String
The default value for theevictionPolicyClassName
configuration attribute.static final Duration
The default value forevictorShutdownTimeout
configuration attribute.static final long
Deprecated.static final boolean
The default value for thefairness
configuration attribute.static final boolean
The default value for enabling JMX for pools created with a configuration instance.static final String
The default value for the base name to use to name JMX enabled pools created with a configuration instance.static final String
The default value for the prefix used to name JMX enabled pools created with a configuration instance.static final boolean
The default value for thelifo
configuration attribute.static final Duration
The default value for themaxWait
configuration attribute.static final long
Deprecated.UseDEFAULT_MAX_WAIT
.static final Duration
The default value for theminEvictableIdleDuration
configuration attribute.static final Duration
Deprecated.static final long
Deprecated.static final int
The default value for thenumTestsPerEvictionRun
configuration attribute.static final Duration
The default value for thesoftMinEvictableIdleTime
configuration attribute.static final Duration
Deprecated.static final long
Deprecated.static final boolean
The default value for thetestOnBorrow
configuration attribute.static final boolean
The default value for thetestOnCreate
configuration attribute.static final boolean
The default value for thetestOnReturn
configuration attribute.static final boolean
The default value for thetestWhileIdle
configuration attribute.static final Duration
Deprecated.static final long
Deprecated. -
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionboolean
Gets the value for theblockWhenExhausted
configuration attribute for pools created with this configuration instance.Gets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.Gets the value for theevictionPolicyClass
configuration attribute for pools created with this configuration instance.Gets the value for theevictionPolicyClassName
configuration attribute for pools created with this configuration instance.Deprecated.Gets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.long
Deprecated.boolean
Gets the value for thefairness
configuration attribute for pools created with this configuration instance.boolean
Gets the value of the flag that determines if JMX will be enabled for pools created with this configuration instance.Gets the value of the JMX name base that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.Gets the value of the JMX name prefix that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.boolean
getLifo()
Gets the value for thelifo
configuration attribute for pools created with this configuration instance.Gets the value for themaxWait
configuration attribute for pools created with this configuration instance.long
Deprecated.UsegetMaxWaitDuration()
.Gets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.Deprecated.long
Deprecated.int
Gets the value for thenumTestsPerEvictionRun
configuration attribute for pools created with this configuration instance.Gets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.Deprecated.long
Deprecated.boolean
Gets the value for thetestOnBorrow
configuration attribute for pools created with this configuration instance.boolean
Gets the value for thetestOnCreate
configuration attribute for pools created with this configuration instance.boolean
Gets the value for thetestOnReturn
configuration attribute for pools created with this configuration instance.boolean
Gets the value for thetestWhileIdle
configuration attribute for pools created with this configuration instance.Deprecated.long
Deprecated.void
setBlockWhenExhausted
(boolean blockWhenExhausted) Sets the value for theblockWhenExhausted
configuration attribute for pools created with this configuration instance.void
setEvictionPolicy
(EvictionPolicy<T> evictionPolicy) Sets the value for theevictionPolicyClass
configuration attribute for pools created with this configuration instance.void
setEvictionPolicyClassName
(String evictionPolicyClassName) Sets the value for theevictionPolicyClassName
configuration attribute for pools created with this configuration instance.void
setEvictorShutdownTimeout
(Duration evictorShutdownTimeoutDuration) Sets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.void
setEvictorShutdownTimeoutMillis
(long evictorShutdownTimeoutMillis) Deprecated.void
setEvictorShutdownTimeoutMillis
(Duration evictorShutdownTimeout) Deprecated.void
setFairness
(boolean fairness) Sets the value for thefairness
configuration attribute for pools created with this configuration instance.void
setJmxEnabled
(boolean jmxEnabled) Sets the value of the flag that determines if JMX will be enabled for pools created with this configuration instance.void
setJmxNameBase
(String jmxNameBase) Sets the value of the JMX name base that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.void
setJmxNamePrefix
(String jmxNamePrefix) Sets the value of the JMX name prefix that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.void
setLifo
(boolean lifo) Sets the value for thelifo
configuration attribute for pools created with this configuration instance.void
setMaxWait
(Duration maxWaitDuration) Sets the value for themaxWait
configuration attribute for pools created with this configuration instance.void
setMaxWaitMillis
(long maxWaitMillis) Deprecated.UsesetMaxWait(Duration)
.void
setMinEvictableIdleDuration
(Duration minEvictableIdleTime) Sets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.void
setMinEvictableIdleTime
(Duration minEvictableIdleTime) Deprecated.void
setMinEvictableIdleTimeMillis
(long minEvictableIdleTimeMillis) Deprecated.void
setNumTestsPerEvictionRun
(int numTestsPerEvictionRun) Sets the value for thenumTestsPerEvictionRun
configuration attribute for pools created with this configuration instance.void
setSoftMinEvictableIdleDuration
(Duration softMinEvictableIdleTime) Sets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.void
setSoftMinEvictableIdleTime
(Duration softMinEvictableIdleTime) Deprecated.void
setSoftMinEvictableIdleTimeMillis
(long softMinEvictableIdleTimeMillis) Deprecated.void
setTestOnBorrow
(boolean testOnBorrow) Sets the value for thetestOnBorrow
configuration attribute for pools created with this configuration instance.void
setTestOnCreate
(boolean testOnCreate) Sets the value for thetestOnCreate
configuration attribute for pools created with this configuration instance.void
setTestOnReturn
(boolean testOnReturn) Sets the value for thetestOnReturn
configuration attribute for pools created with this configuration instance.void
setTestWhileIdle
(boolean testWhileIdle) Sets the value for thetestWhileIdle
configuration attribute for pools created with this configuration instance.void
setTimeBetweenEvictionRuns
(Duration timeBetweenEvictionRuns) Sets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.void
setTimeBetweenEvictionRunsMillis
(long timeBetweenEvictionRunsMillis) Deprecated.protected void
toStringAppendFields
(StringBuilder builder) Used by sub-classes to include the fields defined by the sub-class in theBaseObject.toString()
output.Methods inherited from class org.apache.commons.pool2.BaseObject
toString
-
Field Details
-
DEFAULT_LIFO
The default value for thelifo
configuration attribute. -
DEFAULT_FAIRNESS
The default value for thefairness
configuration attribute. -
DEFAULT_MAX_WAIT_MILLIS
Deprecated.UseDEFAULT_MAX_WAIT
.The default value for themaxWait
configuration attribute. -
DEFAULT_MAX_WAIT
The default value for themaxWait
configuration attribute.- Since:
- 2.10.0
- See Also:
-
DEFAULT_MIN_EVICTABLE_IDLE_TIME_MILLIS
Deprecated.The default value for theminEvictableIdleDuration
configuration attribute. -
DEFAULT_MIN_EVICTABLE_IDLE_DURATION
The default value for theminEvictableIdleDuration
configuration attribute. -
DEFAULT_MIN_EVICTABLE_IDLE_TIME
Deprecated.The default value for theminEvictableIdleDuration
configuration attribute. -
DEFAULT_SOFT_MIN_EVICTABLE_IDLE_TIME_MILLIS
Deprecated.The default value for thesoftMinEvictableIdleTime
configuration attribute. -
DEFAULT_SOFT_MIN_EVICTABLE_IDLE_TIME
Deprecated.The default value for thesoftMinEvictableIdleTime
configuration attribute. -
DEFAULT_SOFT_MIN_EVICTABLE_IDLE_DURATION
The default value for thesoftMinEvictableIdleTime
configuration attribute. -
DEFAULT_EVICTOR_SHUTDOWN_TIMEOUT_MILLIS
Deprecated.The default value forevictorShutdownTimeout
configuration attribute. -
DEFAULT_EVICTOR_SHUTDOWN_TIMEOUT
The default value forevictorShutdownTimeout
configuration attribute. -
DEFAULT_NUM_TESTS_PER_EVICTION_RUN
The default value for thenumTestsPerEvictionRun
configuration attribute. -
DEFAULT_TEST_ON_CREATE
The default value for thetestOnCreate
configuration attribute. -
DEFAULT_TEST_ON_BORROW
The default value for thetestOnBorrow
configuration attribute. -
DEFAULT_TEST_ON_RETURN
The default value for thetestOnReturn
configuration attribute. -
DEFAULT_TEST_WHILE_IDLE
The default value for thetestWhileIdle
configuration attribute. -
DEFAULT_TIME_BETWEEN_EVICTION_RUNS_MILLIS
Deprecated.The default value for thetimeBetweenEvictionRuns
configuration attribute. -
DEFAULT_DURATION_BETWEEN_EVICTION_RUNS
The default value for thetimeBetweenEvictionRuns
configuration attribute. -
DEFAULT_TIME_BETWEEN_EVICTION_RUNS
Deprecated.The default value for thetimeBetweenEvictionRuns
configuration attribute. -
DEFAULT_BLOCK_WHEN_EXHAUSTED
The default value for theblockWhenExhausted
configuration attribute. -
DEFAULT_JMX_ENABLE
The default value for enabling JMX for pools created with a configuration instance.- See Also:
-
DEFAULT_JMX_NAME_PREFIX
The default value for the prefix used to name JMX enabled pools created with a configuration instance. -
DEFAULT_JMX_NAME_BASE
The default value for the base name to use to name JMX enabled pools created with a configuration instance. The default isnull
which means the pool will provide the base name to use. -
DEFAULT_EVICTION_POLICY_CLASS_NAME
The default value for theevictionPolicyClassName
configuration attribute.
-
-
Constructor Details
-
BaseObjectPoolConfig
public BaseObjectPoolConfig()
-
-
Method Details
-
getBlockWhenExhausted
Gets the value for theblockWhenExhausted
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
blockWhenExhausted
for this configuration instance - See Also:
-
getDurationBetweenEvictionRuns
Gets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
timeBetweenEvictionRuns
for this configuration instance - Since:
- 2.11.0
- See Also:
-
getEvictionPolicy
Gets the value for theevictionPolicyClass
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
evictionPolicyClass
for this configuration instance - Since:
- 2.6.0
- See Also:
-
getEvictionPolicyClassName
Gets the value for theevictionPolicyClassName
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
evictionPolicyClassName
for this configuration instance - See Also:
-
getEvictorShutdownTimeout
Deprecated.Gets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
evictorShutdownTimeout
for this configuration instance - Since:
- 2.10.0
- See Also:
-
getEvictorShutdownTimeoutDuration
Gets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
evictorShutdownTimeout
for this configuration instance - Since:
- 2.11.0
- See Also:
-
getEvictorShutdownTimeoutMillis
Deprecated.Gets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
evictorShutdownTimeout
for this configuration instance - See Also:
-
getFairness
Gets the value for thefairness
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
fairness
for this configuration instance - See Also:
-
getJmxEnabled
Gets the value of the flag that determines if JMX will be enabled for pools created with this configuration instance.- Returns:
- The current setting of
jmxEnabled
for this configuration instance
-
getJmxNameBase
Gets the value of the JMX name base that will be used as part of the name assigned to JMX enabled pools created with this configuration instance. A value ofnull
means that the pool will define the JMX name base.- Returns:
- The current setting of
jmxNameBase
for this configuration instance
-
getJmxNamePrefix
Gets the value of the JMX name prefix that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.- Returns:
- The current setting of
jmxNamePrefix
for this configuration instance
-
getLifo
Gets the value for thelifo
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
lifo
for this configuration instance - See Also:
-
getMaxWaitDuration
Gets the value for themaxWait
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
maxWait
for this configuration instance - Since:
- 2.11.0
- See Also:
-
getMaxWaitMillis
Deprecated.UsegetMaxWaitDuration()
.Gets the value for themaxWait
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
maxWait
for this configuration instance - See Also:
-
getMinEvictableIdleDuration
Gets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
minEvictableIdleTime
for this configuration instance - Since:
- 2.11.0
- See Also:
-
getMinEvictableIdleTime
Deprecated.Gets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
minEvictableIdleTime
for this configuration instance - Since:
- 2.10.0
- See Also:
-
getMinEvictableIdleTimeMillis
Deprecated.Gets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
minEvictableIdleTime
for this configuration instance - See Also:
-
getNumTestsPerEvictionRun
Gets the value for thenumTestsPerEvictionRun
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
numTestsPerEvictionRun
for this configuration instance - See Also:
-
getSoftMinEvictableIdleDuration
Gets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
softMinEvictableIdleTime
for this configuration instance - Since:
- 2.11.0
- See Also:
-
getSoftMinEvictableIdleTime
Deprecated.Gets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
softMinEvictableIdleTime
for this configuration instance - Since:
- 2.10.0
- See Also:
-
getSoftMinEvictableIdleTimeMillis
Deprecated.Gets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
softMinEvictableIdleTime
for this configuration instance - See Also:
-
getTestOnBorrow
Gets the value for thetestOnBorrow
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
testOnBorrow
for this configuration instance - See Also:
-
getTestOnCreate
Gets the value for thetestOnCreate
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
testOnCreate
for this configuration instance - Since:
- 2.2
- See Also:
-
getTestOnReturn
Gets the value for thetestOnReturn
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
testOnReturn
for this configuration instance - See Also:
-
getTestWhileIdle
Gets the value for thetestWhileIdle
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
testWhileIdle
for this configuration instance - See Also:
-
getTimeBetweenEvictionRuns
Deprecated.Gets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
timeBetweenEvictionRuns
for this configuration instance - Since:
- 2.10.0
- See Also:
-
getTimeBetweenEvictionRunsMillis
Deprecated.Gets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.- Returns:
- The current setting of
timeBetweenEvictionRuns
for this configuration instance - See Also:
-
setBlockWhenExhausted
Sets the value for theblockWhenExhausted
configuration attribute for pools created with this configuration instance.- Parameters:
blockWhenExhausted
- The new setting ofblockWhenExhausted
for this configuration instance- See Also:
-
setEvictionPolicy
Sets the value for theevictionPolicyClass
configuration attribute for pools created with this configuration instance.- Parameters:
evictionPolicy
- The new setting ofevictionPolicyClass
for this configuration instance- Since:
- 2.6.0
- See Also:
-
setEvictionPolicyClassName
Sets the value for theevictionPolicyClassName
configuration attribute for pools created with this configuration instance.- Parameters:
evictionPolicyClassName
- The new setting ofevictionPolicyClassName
for this configuration instance- See Also:
-
setEvictorShutdownTimeout
Sets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Parameters:
evictorShutdownTimeoutDuration
- The new setting ofevictorShutdownTimeout
for this configuration instance- Since:
- 2.11.0
- See Also:
-
setEvictorShutdownTimeoutMillis
Deprecated.Sets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Parameters:
evictorShutdownTimeout
- The new setting ofevictorShutdownTimeout
for this configuration instance- Since:
- 2.10.0
- See Also:
-
setEvictorShutdownTimeoutMillis
Deprecated.Sets the value for theevictorShutdownTimeout
configuration attribute for pools created with this configuration instance.- Parameters:
evictorShutdownTimeoutMillis
- The new setting ofevictorShutdownTimeout
for this configuration instance- See Also:
-
setFairness
Sets the value for thefairness
configuration attribute for pools created with this configuration instance.- Parameters:
fairness
- The new setting offairness
for this configuration instance- See Also:
-
setJmxEnabled
Sets the value of the flag that determines if JMX will be enabled for pools created with this configuration instance.- Parameters:
jmxEnabled
- The new setting ofjmxEnabled
for this configuration instance
-
setJmxNameBase
Sets the value of the JMX name base that will be used as part of the name assigned to JMX enabled pools created with this configuration instance. A value ofnull
means that the pool will define the JMX name base.- Parameters:
jmxNameBase
- The new setting ofjmxNameBase
for this configuration instance
-
setJmxNamePrefix
Sets the value of the JMX name prefix that will be used as part of the name assigned to JMX enabled pools created with this configuration instance.- Parameters:
jmxNamePrefix
- The new setting ofjmxNamePrefix
for this configuration instance
-
setLifo
Sets the value for thelifo
configuration attribute for pools created with this configuration instance.- Parameters:
lifo
- The new setting oflifo
for this configuration instance- See Also:
-
setMaxWait
Sets the value for themaxWait
configuration attribute for pools created with this configuration instance.- Parameters:
maxWaitDuration
- The new setting ofmaxWaitDuration
for this configuration instance- Since:
- 2.11.0
- See Also:
-
setMaxWaitMillis
Deprecated.UsesetMaxWait(Duration)
.Sets the value for themaxWait
configuration attribute for pools created with this configuration instance.- Parameters:
maxWaitMillis
- The new setting ofmaxWaitMillis
for this configuration instance- See Also:
-
setMinEvictableIdleDuration
Sets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
minEvictableIdleTime
- The new setting ofminEvictableIdleTime
for this configuration instance- Since:
- 2.12.0
- See Also:
-
setMinEvictableIdleTime
Deprecated.Sets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
minEvictableIdleTime
- The new setting ofminEvictableIdleTime
for this configuration instance- Since:
- 2.10.0
- See Also:
-
setMinEvictableIdleTimeMillis
Deprecated.Sets the value for theminEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
minEvictableIdleTimeMillis
- The new setting ofminEvictableIdleTime
for this configuration instance- See Also:
-
setNumTestsPerEvictionRun
Sets the value for thenumTestsPerEvictionRun
configuration attribute for pools created with this configuration instance.- Parameters:
numTestsPerEvictionRun
- The new setting ofnumTestsPerEvictionRun
for this configuration instance- See Also:
-
setSoftMinEvictableIdleDuration
Sets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
softMinEvictableIdleTime
- The new setting ofsoftMinEvictableIdleTime
for this configuration instance- Since:
- 2.12.0
- See Also:
-
setSoftMinEvictableIdleTime
Deprecated.Sets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
softMinEvictableIdleTime
- The new setting ofsoftMinEvictableIdleTime
for this configuration instance- Since:
- 2.10.0
- See Also:
-
setSoftMinEvictableIdleTimeMillis
Deprecated.Sets the value for thesoftMinEvictableIdleTime
configuration attribute for pools created with this configuration instance.- Parameters:
softMinEvictableIdleTimeMillis
- The new setting ofsoftMinEvictableIdleTime
for this configuration instance- See Also:
-
setTestOnBorrow
Sets the value for thetestOnBorrow
configuration attribute for pools created with this configuration instance.- Parameters:
testOnBorrow
- The new setting oftestOnBorrow
for this configuration instance- See Also:
-
setTestOnCreate
Sets the value for thetestOnCreate
configuration attribute for pools created with this configuration instance.- Parameters:
testOnCreate
- The new setting oftestOnCreate
for this configuration instance- Since:
- 2.2
- See Also:
-
setTestOnReturn
Sets the value for thetestOnReturn
configuration attribute for pools created with this configuration instance.- Parameters:
testOnReturn
- The new setting oftestOnReturn
for this configuration instance- See Also:
-
setTestWhileIdle
Sets the value for thetestWhileIdle
configuration attribute for pools created with this configuration instance.- Parameters:
testWhileIdle
- The new setting oftestWhileIdle
for this configuration instance- See Also:
-
setTimeBetweenEvictionRuns
Sets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.- Parameters:
timeBetweenEvictionRuns
- The new setting oftimeBetweenEvictionRuns
for this configuration instance- Since:
- 2.10.0
- See Also:
-
setTimeBetweenEvictionRunsMillis
Deprecated.Sets the value for thetimeBetweenEvictionRuns
configuration attribute for pools created with this configuration instance.- Parameters:
timeBetweenEvictionRunsMillis
- The new setting oftimeBetweenEvictionRuns
for this configuration instance- See Also:
-
toStringAppendFields
Description copied from class:BaseObject
Used by sub-classes to include the fields defined by the sub-class in theBaseObject.toString()
output.- Overrides:
toStringAppendFields
in classBaseObject
- Parameters:
builder
- Field names and values are appended to this object
-
DEFAULT_EVICTOR_SHUTDOWN_TIMEOUT
.