org.jasig.portlet.spring

Class DoubleCheckedCreator<T>

java.lang.Object

org.jasig.portlet.spring.DoubleCheckedCreator<T>

Direct Known Subclasses:

SingletonDoubleCheckedCreator

public abstract class DoubleCheckedCreator<T>
extends java.lang.Object

Implementation of double-checked locking for object creation using a ReadWriteLock

Version:

$Revision$

Author:

Eric Dalquist

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger
protected java.util.concurrent.locks.Lock	readLock
protected java.util.concurrent.locks.Lock	writeLock

Constructor Summary

Constructors

Constructor and Description
DoubleCheckedCreator()
DoubleCheckedCreator(java.util.concurrent.locks.ReadWriteLock readWriteLock)

Method Summary

Modifier and Type	Method and Description
protected abstract T	create(java.lang.Object... args)
T	get(java.lang.Object... args) Double checking retrieval/creation of an object
protected boolean	invalid(T value, java.lang.Object... args) The default impl returns true if value is null.
protected abstract T	retrieve(java.lang.Object... args)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

readLock

protected final java.util.concurrent.locks.Lock readLock

writeLock

protected final java.util.concurrent.locks.Lock writeLock

Constructor Detail

DoubleCheckedCreator

public DoubleCheckedCreator()

DoubleCheckedCreator

public DoubleCheckedCreator(java.util.concurrent.locks.ReadWriteLock readWriteLock)

Method Detail

create

protected abstract T create(java.lang.Object... args)

Parameters:

args - Arguments to use when creating the object

Returns:

A newly created object

retrieve

protected abstract T retrieve(java.lang.Object... args)

Parameters:

args - Arguments to use when retrieving the object

Returns:

An existing object if available

invalid

protected boolean invalid(T value,
                          java.lang.Object... args)

The default impl returns true if value is null.

Parameters:

value - The object to validate

args - Arguments to use when validating the object

Returns:

true if the object is invalid and should be created, false if not.

get

public final T get(java.lang.Object... args)

Double checking retrieval/creation of an object

Parameters:

args - Optional arguments to pass to retrieve(Object...), create(Object...), and invalid(Object, Object...).

Returns:

A retrieved or created object.