org.apache.commons.collections.functors
Class ConstantTransformer<T>

java.lang.Object
  extended by org.apache.commons.collections.functors.ConstantTransformer<T>
All Implemented Interfaces:
Serializable, Transformer<Object,T>

public class ConstantTransformer<T>
extends Object
implements Transformer<Object,T>, Serializable

Transformer implementation that returns the same constant each time.

No check is made that the object is immutable. In general, only immutable objects should use the constant factory. Mutable objects should use the prototype factory.

Since:
Commons Collections 3.0
Version:
$Revision: 1.1.1.1 $ $Date: 2005/05/23 04:34:17 $
Author:
Matt Hall, John Watkinson, Stephen Colebourne
See Also:
Serialized Form

Field Summary
static Transformer NULL_INSTANCE
          Returns null each time
 
Constructor Summary
ConstantTransformer(T constantToReturn)
          Constructor that performs no validation.
 
Method Summary
 T getConstant()
          Gets the constant.
static
<T> Transformer<Object,T>
getInstance(T constantToReturn)
          Transformer method that performs validation.
 T transform(Object input)
          Transforms the input by ignoring it and returning the stored constant instead.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NULL_INSTANCE

public static final Transformer NULL_INSTANCE
Returns null each time

Constructor Detail

ConstantTransformer

public ConstantTransformer(T constantToReturn)
Constructor that performs no validation. Use getInstance if you want that.

Parameters:
constantToReturn - the constant to return each time
Method Detail

getInstance

public static <T> Transformer<Object,T> getInstance(T constantToReturn)
Transformer method that performs validation.

Parameters:
constantToReturn - the constant object to return each time in the factory
Returns:
the constant factory.

transform

public T transform(Object input)
Transforms the input by ignoring it and returning the stored constant instead.

Specified by:
transform in interface Transformer<Object,T>
Parameters:
input - the input object which is ignored
Returns:
the stored constant

getConstant

public T getConstant()
Gets the constant.

Returns:
the constant
Since:
Commons Collections 3.1


Copyright © 2005-2005 Apache Software Foundation, Matt Hall, John Watkinson. All Rights Reserved.