java.lang.Object | |
↳ | org.apache.commons.collections.TransformerUtils |
TransformerUtils
provides reference implementations and
utilities for the Transformer functor interface. The supplied transformers are:
java.lang.String
representation of the input object
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This class is not normally instantiated.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a Transformer that calls a Predicate each time the transformer is used.
| |||||||||||
Creates a Transformer that calls a Factory each time the transformer is used.
| |||||||||||
Creates a Transformer that calls a Closure each time the transformer is used.
| |||||||||||
Create a new Transformer that calls each transformer in turn, passing the
result into the next transformer.
| |||||||||||
Create a new Transformer that calls two transformers, passing the result of
the first into the second.
| |||||||||||
Create a new Transformer that calls each transformer in turn, passing the
result into the next transformer.
| |||||||||||
Gets a transformer that returns a clone of the input
object.
| |||||||||||
Creates a Transformer that will return the same object each time the
transformer is used.
| |||||||||||
Gets a transformer that always throws an exception.
| |||||||||||
Gets a Transformer that expects an input Class object that it will instantiate.
| |||||||||||
Creates a Transformer that expects an input Class object that it will
instantiate.
| |||||||||||
Gets a Transformer that invokes a method on the input object.
| |||||||||||
Gets a Transformer that invokes a method on the input object.
| |||||||||||
Creates a Transformer that uses the passed in Map to transform the input
object (as a simple lookup).
| |||||||||||
Gets a transformer that returns the input object.
| |||||||||||
Gets a transformer that always returns null.
| |||||||||||
Gets a transformer that returns a
java.lang.String
representation of the input object. | |||||||||||
Create a new Transformer that uses the input object as a key to find the
transformer to call.
| |||||||||||
Create a new Transformer that calls one of two transformers depending
on the specified predicate.
| |||||||||||
Create a new Transformer that calls one of the transformers depending
on the predicates.
| |||||||||||
Create a new Transformer that calls one of the transformers depending
on the predicates.
| |||||||||||
Create a new Transformer that calls one of the transformers depending
on the predicates.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
This class is not normally instantiated.
Creates a Transformer that calls a Predicate each time the transformer is used. The transformer will return either Boolean.TRUE or Boolean.FALSE.
predicate | the predicate to run each time in the transformer, not null |
---|
IllegalArgumentException | if the predicate is null |
---|
Creates a Transformer that calls a Factory each time the transformer is used. The transformer will return the value returned by the factory.
factory | the factory to run each time in the transformer, not null |
---|
IllegalArgumentException | if the factory is null |
---|
Creates a Transformer that calls a Closure each time the transformer is used. The transformer returns the input object.
closure | the closure to run each time in the transformer, not null |
---|
IllegalArgumentException | if the closure is null |
---|
Create a new Transformer that calls each transformer in turn, passing the result into the next transformer. The ordering is that of the iterator() method on the collection.
transformers | a collection of transformers to chain |
---|
IllegalArgumentException | if the transformers collection is null |
---|---|
IllegalArgumentException | if any transformer in the collection is null |
Create a new Transformer that calls two transformers, passing the result of the first into the second.
transformer1 | the first transformer |
---|---|
transformer2 | the second transformer |
IllegalArgumentException | if either transformer is null |
---|
Create a new Transformer that calls each transformer in turn, passing the result into the next transformer.
transformers | an array of transformers to chain |
---|
IllegalArgumentException | if the transformers array is null |
---|---|
IllegalArgumentException | if any transformer in the array is null |
Gets a transformer that returns a clone of the input object. The input object will be cloned using one of these techniques (in order):
Creates a Transformer that will return the same object each time the transformer is used.
constantToReturn | the constant object to return each time in the transformer |
---|
Gets a transformer that always throws an exception. This could be useful during testing as a placeholder.
Gets a Transformer that expects an input Class object that it will instantiate.
Creates a Transformer that expects an input Class object that it will instantiate. The constructor used is determined by the arguments specified to this method.
paramTypes | parameter types for the constructor, can be null |
---|---|
args | the arguments to pass to the constructor, can be null |
IllegalArgumentException | if the paramTypes and args don't match |
---|
Gets a Transformer that invokes a method on the input object. The method must have no parameters. If the input object is null, null is returned.
For example, TransformerUtils.invokerTransformer("getName");
will call the getName/code> method on the input object to
determine the transformer result.
methodName | the method name to call on the input object, may not be null |
---|
IllegalArgumentException | if the methodName is null. |
---|
Gets a Transformer that invokes a method on the input object. The method parameters are specified. If the input object is null, null is returned.
methodName | the name of the method |
---|---|
paramTypes | the parameter types |
args | the arguments |
IllegalArgumentException | if the method name is null |
---|---|
IllegalArgumentException | if the paramTypes and args don't match |
Creates a Transformer that uses the passed in Map to transform the input object (as a simple lookup).
map | the map to use to transform the objects |
---|
IllegalArgumentException | if the map is null |
---|
Gets a transformer that returns the input object. The input object should be immutable to maintain the contract of Transformer (although this is not checked).
Gets a transformer that returns a java.lang.String
representation of the input object. This is achieved via the
toString
method, null
returns 'null'.
Create a new Transformer that uses the input object as a key to find the transformer to call.
The Map consists of object keys and Transformer values. A transformer is called if the input object equals the key. If there is no match, the default transformer is called. The default transformer is set in the map using a null key. If no default is set, null will be returned in a default case.
objectsAndTransformers | a map of objects to transformers |
---|
IllegalArgumentException | if the map is null |
---|---|
IllegalArgumentException | if the map is empty |
IllegalArgumentException | if any transformer in the map is null |
Create a new Transformer that calls one of two transformers depending on the specified predicate.
predicate | the predicate to switch on |
---|---|
trueTransformer | the transformer called if the predicate is true |
falseTransformer | the transformer called if the predicate is false |
IllegalArgumentException | if the predicate is null |
---|---|
IllegalArgumentException | if either transformer is null |
Create a new Transformer that calls one of the transformers depending on the predicates. The transformer at array location 0 is called if the predicate at array location 0 returned true. Each predicate is evaluated until one returns true. If no predicates evaluate to true, null is returned.
predicates | an array of predicates to check |
---|---|
transformers | an array of transformers to call |
IllegalArgumentException | if the either array is null |
---|---|
IllegalArgumentException | if the either array has 0 elements |
IllegalArgumentException | if any element in the arrays is null |
IllegalArgumentException | if the arrays are different sizes |
Create a new Transformer that calls one of the transformers depending on the predicates. The transformer at array location 0 is called if the predicate at array location 0 returned true. Each predicate is evaluated until one returns true. If no predicates evaluate to true, the default transformer is called. If the default transformer is null, null is returned.
predicates | an array of predicates to check |
---|---|
transformers | an array of transformers to call |
defaultTransformer | the default to call if no predicate matches, null means return null |
IllegalArgumentException | if the either array is null |
---|---|
IllegalArgumentException | if the either array has 0 elements |
IllegalArgumentException | if any element in the arrays is null |
IllegalArgumentException | if the arrays are different sizes |
Create a new Transformer that calls one of the transformers depending on the predicates.
The Map consists of Predicate keys and Transformer values. A transformer is called if its matching predicate returns true. Each predicate is evaluated until one returns true. If no predicates evaluate to true, the default transformer is called. The default transformer is set in the map with a null key. If no default transformer is set, null will be returned in a default case. The ordering is that of the iterator() method on the entryset collection of the map.
predicatesAndTransformers | a map of predicates to transformers |
---|
IllegalArgumentException | if the map is null |
---|---|
IllegalArgumentException | if the map is empty |
IllegalArgumentException | if any transformer in the map is null |
ClassCastException | if the map elements are of the wrong type |