Package com.cedarsoftware.util

Class Convention

java.lang.Object

com.cedarsoftware.util.Convention

public class Convention
extends Object

Utility class containing common defensive programming helpers.

Convention offers a set of static convenience methods for validating method arguments such as null checks or ensuring that a string is not empty. The class is not intended to be instantiated.

Method Summary

Modifier and Type	Method	Description
static void	throwIfClassNotFound(String fullyQualifiedClassName, ClassLoader loader)	Verify that the supplied class can be loaded.
static void	throwIfFalse(boolean logic, String message)	Throws an exception if the logic is false.
static <K, V> void	throwIfKeyExists(Map<K,V> map, K key, String message)
static void	throwIfNull(Object value, String message)	Throws an exception if null
static void	throwIfNullOrEmpty(String value, String message)	Throws an exception if null or empty

Methods inherited from class java.lang.Object

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

Method Details

throwIfNull

public static void throwIfNull(Object value,
 String message)

Throws an exception if null

Parameters:

value - object to check if null

message - message to use when thrown

Throws:

IllegalArgumentException - if the string passed in is null or empty

throwIfNullOrEmpty

public static void throwIfNullOrEmpty(String value,
 String message)

Throws an exception if null or empty

Parameters:

value - string to check

message - message to use when thrown

Throws:

IllegalArgumentException - if the string passed in is null or empty

throwIfClassNotFound

public static void throwIfClassNotFound(String fullyQualifiedClassName,
 ClassLoader loader)

Verify that the supplied class can be loaded.

Parameters:

fullyQualifiedClassName - fully qualified name of the class to look up

loader - the ClassLoader used to locate the class

Throws:

IllegalArgumentException - if the class cannot be resolved

throwIfKeyExists

public static <K,
V> void throwIfKeyExists(Map<K,V> map,
 K key,
 String message)

throwIfFalse

public static void throwIfFalse(boolean logic,
 String message)

Throws an exception if the logic is false.

Parameters:

logic - test to see if we need to throw the exception.

message - to include in the exception explaining why the the assertion failed