org.josef.util

Class Util

java.lang.Object

org.josef.util.Util

@Status(stage=PRODUCTION,
        unitTests=COMPLETE)
 @Review(by="Kees Schotanus",
        at="2009-09-28")
public final class Util
extends Object

Generic utility class.

Version:

1.0 $Revision: 5812 $

Author:

Kees Schotanus

Method Summary

Modifier and Type	Method and Description
static Throwable	getDeepestNestedCause(Throwable throwable) Gets the deepest nested cause of the supplied throwable.
static <T> T	useDefaultValueWhenValueIsNull(T value, T defaultValue) Convenience method to use a default value when the actual value is null.

Methods inherited from class java.lang.Object

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

Method Detail

getDeepestNestedCause

public static Throwable getDeepestNestedCause(Throwable throwable)

Gets the deepest nested cause of the supplied throwable.

Parameters:

throwable - The throwable to search for the deepest nested cause.

Returns:

The deepest nested cause of the supplied throwable.

Throws:

NullPointerException - When the supplied throwable is null.

useDefaultValueWhenValueIsNull

public static <T> T useDefaultValueWhenValueIsNull(T value,
                                                   T defaultValue)

Convenience method to use a default value when the actual value is null.
This method can be used in places where data needs to be copied from one object to another, but only when the data is not null. For example:

 if (valueOne != null) {
     o.setValueOne(valueOne);
 }
 if (valueTwo != null) {
     o.setValueTwo(valueTwo);
 }
 // Can be replaced with
 o.setValueOne(useDefaultValueWhenValueIsNull(valueOne, o.getValueOne()));
 o.setValueTwo(useDefaultValueWhenValueIsNull(valueTwo, o.getValueTwo()));
 

As you can see, this method decreases the complexity of the code (McCabe), at the expense of calling an extra setter when the supplied value is null.

Type Parameters:

T - The type of the supplied value and defaultValue.

Parameters:

value - The value.

defaultValue - The default value to use when the supplied value is null.

Returns:

The supplied value when non null and the supplied defaultValue when the supplied value is null.