com.mongodb.util

Class SimplePool<T>

java.lang.Object

com.mongodb.util.SimplePool<T>

Direct Known Subclasses:

DBPortPool, StringBuilderPool

Deprecated.

This class is NOT a part of public API and will be dropped in 3.x versions.

@Deprecated
public abstract class SimplePool<T>
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<T>	_avail Deprecated.
private boolean	_closed Deprecated.
protected java.lang.String	_name Deprecated.
protected java.util.Set<T>	_out Deprecated.
private java.util.concurrent.Semaphore	_sem Deprecated.
protected int	_size Deprecated.

Constructor Summary

Constructors

Constructor and Description
SimplePool(java.lang.String name, int size) Deprecated. Initializes a new pool of objects.

Method Summary

Modifier and Type	Method and Description
private void	assertConditions() Deprecated.
void	cleanup(T t) Deprecated. Override this if you need to do any cleanup
protected void	close() Deprecated. Clears the pool of all objects.
protected abstract T	createNew() Deprecated. Creates a new object of this pool's type.
private T	createNewAndReleasePermitIfFailure() Deprecated.
void	done(T t) Deprecated. Call done when you are done with an object form the pool.
T	get() Deprecated. Gets an object from the pool - will block if none are available
T	get(long waitTime) Deprecated. Gets an object from the pool - will block if none are available
int	getAvailable() Deprecated.
int	getInUse() Deprecated.
int	getMaxSize() Deprecated.
java.lang.String	getName() Deprecated.
int	getTotal() Deprecated.
private boolean	permitAcquired(long waitTime) Deprecated.
protected int	pick(int recommended, boolean couldCreate) Deprecated. Pick a member of _avail.
void	remove(T t) Deprecated.
java.lang.String	toString() Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

_name

protected final java.lang.String _name

Deprecated.

_size

protected final int _size

Deprecated.

_avail

protected final java.util.List<T> _avail

Deprecated.

_out

protected final java.util.Set<T> _out

Deprecated.

_sem

private final java.util.concurrent.Semaphore _sem

Deprecated.

_closed

private boolean _closed

Deprecated.

Constructor Detail

SimplePool

public SimplePool(java.lang.String name,
                  int size)

Deprecated.

Initializes a new pool of objects.

Parameters:

name - name for the pool

size - max to hold to at any given time. if < 0 then no limit

Method Detail

createNew

protected abstract T createNew()

Deprecated.

Creates a new object of this pool's type. Implementations should throw a runtime exception if unable to create.

Returns:

the new object.

cleanup

public void cleanup(T t)

Deprecated.

Override this if you need to do any cleanup

Parameters:

t - the object that was added

pick

protected int pick(int recommended,
                   boolean couldCreate)

Deprecated.

Pick a member of _avail. This method is called with a lock held on _avail, so it may be used safely.

Parameters:

recommended - the recommended member to choose.

couldCreate - true if there is room in the pool to create a new object

Returns:

>= 0 the one to use, -1 create a new one

done

public void done(T t)

Deprecated.

Call done when you are done with an object form the pool. If there is room and the object is ok will get added

Parameters:

t - Object to add

assertConditions

private void assertConditions()

Deprecated.

remove

public void remove(T t)

Deprecated.

get

public T get()
      throws java.lang.InterruptedException

Deprecated.

Gets an object from the pool - will block if none are available

Returns:

An object from the pool

Throws:

java.lang.InterruptedException

get

public T get(long waitTime)
      throws java.lang.InterruptedException

Deprecated.

Gets an object from the pool - will block if none are available

Parameters:

waitTime - negative - forever 0 - return immediately no matter what positive ms to wait

Returns:

An object from the pool, or null if can't get one in the given waitTime

Throws:

java.lang.InterruptedException

createNewAndReleasePermitIfFailure

private T createNewAndReleasePermitIfFailure()

Deprecated.

permitAcquired

private boolean permitAcquired(long waitTime)
                        throws java.lang.InterruptedException

Deprecated.

Throws:

java.lang.InterruptedException

close

protected void close()

Deprecated.

Clears the pool of all objects.

getName

public java.lang.String getName()

Deprecated.

getTotal

public int getTotal()

Deprecated.

getInUse

public int getInUse()

Deprecated.

getAvailable

public int getAvailable()

Deprecated.

getMaxSize

public int getMaxSize()

Deprecated.

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object