org.kuali.common.jute.base

Class Precondition

java.lang.Object

org.kuali.common.jute.base.Precondition

public final class Precondition
extends Object

Strongly mimic's Guava's Preconditions class with a sensible default error message for common situations

 Guava:
 checkArgument(StringUtils.isNotBlank(foo), "'foo' cannot be blank");
 this.foo = foo;

 Kuali:
 this.foo = checkNotBlank(foo, "foo");
 

Method Summary

Methods

Modifier and Type	Method and Description
static int	checkEquals(int arg, int expected, String argName)
static long	checkEquals(long arg, long expected, String argName)
static <T> T	checkEquals(T arg, T expected, String argName)
static File	checkExists(File arg, String argName) Ensures that a File passed as an argument exists
static File	checkIsDir(File arg, String argName) Ensures that a File passed as an argument is an existing directory
static File	checkIsFile(File arg, String argName) Ensures that a File passed as an argument is a normal file
static int	checkMax(int arg, int max, String argName) Check that arg is less than or equal to max
static long	checkMax(long arg, long max, String argName) Check that arg is less than or equal to max
static int	checkMin(int arg, int min, String argName) Check that arg is greater than or equal to min.
static long	checkMin(long arg, long min, String argName) Check that arg is greater than or equal to min.
static com.google.common.base.Optional<Integer>	checkMin(com.google.common.base.Optional<Integer> arg, int min, String argName) If arg.isPresent(), check that the Integer it contains is greater than or equal to min
static com.google.common.base.Optional<Long>	checkMin(com.google.common.base.Optional<Long> arg, long min, String argName) If arg.isPresent(), check that the Long it contains is greater than or equal to min
static com.google.common.base.Optional<String>	checkNotBlank(com.google.common.base.Optional<String> arg, String argName) Ensures that an Optional<String> passed as an argument does not contain a string that is whitespace or empty ("").
static String	checkNotBlank(String arg, String argName) Ensures that a String passed as an argument is not whitespace, empty ("") or null
static com.google.common.base.Optional<String>	checkNotEmpty(com.google.common.base.Optional<String> arg, String argName) Ensures that an Optional<String> passed as an argument is not the empty string ("").
static String	checkNotEmpty(String arg, String argName) Ensures that a String passed as an argument is not the empty string ("") or null
static <T> T	checkNotEquals(T arg, T illegal, String argName)
static <T> T	checkNotNull(T arg, String argName) Ensures that an object reference passed as an argument is not null
static <C extends Comparable> C	checkRange(C arg, com.google.common.collect.Range<C> range, String argName)
static int	checkRange(int arg, int min, int max, String argName)
static <I extends Iterable<T>,T> I	checkSize(I iterable, int expected)
static void	checkTruths(int expected, boolean... expressions)

Methods inherited from class java.lang.Object

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

Method Detail

checkExists

public static File checkExists(File arg,
               String argName)

Ensures that a File passed as an argument exists

Parameters:

arg - a File passed as an argument

argName - the name of the argument

Returns:

the non-null File that was validated

Throws:

NullPointerException - If arg is null. The exception message contains the name of the argument that was null

IllegalArgumentException - If arg does not exist or argName is blank

checkIsDir

public static File checkIsDir(File arg,
              String argName)

Ensures that a File passed as an argument is an existing directory

Parameters:

arg - a File passed as an argument

argName - the name of the argument

Returns:

the non-null File that was validated

Throws:

NullPointerException - If arg is null. The exception message contains the name of the argument that was null

IllegalArgumentException - If arg does not exist, is not a directory, or argName is blank

checkIsFile

public static File checkIsFile(File arg,
               String argName)

Ensures that a File passed as an argument is a normal file

Parameters:

arg - a File passed as an argument

argName - the name of the argument

Returns:

the non-null File that was validated

Throws:

NullPointerException - If arg is null. The exception message contains the name of the argument that was null

IllegalArgumentException - If arg does not exist, is not a normal file, or argName is blank

checkNotNull

public static <T> T checkNotNull(T arg,
                 String argName)

Ensures that an object reference passed as an argument is not null

Parameters:

arg - an object reference passed as an argument

argName - the name of the argument

Returns:

the non-null object reference that was validated

Throws:

NullPointerException - If arg is null. The exception message contains the name of the argument that was null

IllegalArgumentException - If argName is blank

checkNotBlank

public static String checkNotBlank(String arg,
                   String argName)

Ensures that a String passed as an argument is not whitespace, empty ("") or null

Parameters:

arg - a String passed as an argument

argName - the name of the argument

Returns:

the non-blank String that was validated

Throws:

IllegalArgumentException - If arg is blank. The exception message contains the name of the argument that was blank

IllegalArgumentException - If argName is blank

checkNotEmpty

public static String checkNotEmpty(String arg,
                   String argName)

Ensures that a String passed as an argument is not the empty string ("") or null

Parameters:

arg - a String passed as an argument

argName - the name of the argument

Returns:

the non-blank String that was validated

Throws:

IllegalArgumentException - If arg is blank. The exception message contains the name of the argument that was blank

IllegalArgumentException - If argName is blank

checkNotBlank

public static com.google.common.base.Optional<String> checkNotBlank(com.google.common.base.Optional<String> arg,
                                                    String argName)

Ensures that an Optional<String> passed as an argument does not contain a string that is whitespace or empty ("").

Parameters:

arg - an Optional<String> passed as an argument

argName - the name of the argument

Returns:

the non-blank Optional<String> that was validated

Throws:

IllegalArgumentException - If arg is blank. The exception message contains the name of the argument that was blank

IllegalArgumentException - If argName is blank

checkNotEmpty

public static com.google.common.base.Optional<String> checkNotEmpty(com.google.common.base.Optional<String> arg,
                                                    String argName)

Ensures that an Optional<String> passed as an argument is not the empty string ("").

Parameters:

arg - an Optional<String> passed as an argument

argName - the name of the argument

Returns:

the non-empty string Optional<String> that was validated

Throws:

IllegalArgumentException - If arg is blank. The exception message contains the name of the argument that was blank

IllegalArgumentException - If argName is blank

checkMin

public static com.google.common.base.Optional<Integer> checkMin(com.google.common.base.Optional<Integer> arg,
                                                int min,
                                                String argName)

If arg.isPresent(), check that the Integer it contains is greater than or equal to min

checkMin

public static com.google.common.base.Optional<Long> checkMin(com.google.common.base.Optional<Long> arg,
                                             long min,
                                             String argName)

If arg.isPresent(), check that the Long it contains is greater than or equal to min

checkMax

public static int checkMax(int arg,
           int max,
           String argName)

Check that arg is less than or equal to max

checkMax

public static long checkMax(long arg,
            long max,
            String argName)

Check that arg is less than or equal to max

checkRange

public static <C extends Comparable> C checkRange(C arg,
                                  com.google.common.collect.Range<C> range,
                                  String argName)

checkRange

public static int checkRange(int arg,
             int min,
             int max,
             String argName)

checkMin

public static int checkMin(int arg,
           int min,
           String argName)

Check that arg is greater than or equal to min.

checkMin

public static long checkMin(long arg,
            long min,
            String argName)

Check that arg is greater than or equal to min.

checkNotEquals

public static <T> T checkNotEquals(T arg,
                   T illegal,
                   String argName)

checkEquals

public static <T> T checkEquals(T arg,
                T expected,
                String argName)

checkEquals

public static long checkEquals(long arg,
               long expected,
               String argName)

checkEquals

public static int checkEquals(int arg,
              int expected,
              String argName)

checkTruths

public static void checkTruths(int expected,
               boolean... expressions)

checkSize

public static <I extends Iterable<T>,T> I checkSize(I iterable,
                                    int expected)