fc.util
Class Argcheck

java.lang.Object
  fc.util.Argcheck

public final class Argcheck
extends java.lang.Object

This class is intended primarily for checking whether method paramaters meet various pre-conditions. Throws a IllegalArgumentException in case of failure.

ThreadSafety: This class is thread safe and can be used by multiple threads concurrently.

Version:

1.0

Method Summary

static void	isequal(java.lang.Object a, java.lang.Object b) Checks that the specified arguments are equal to each other by using Object.equals().
static void	isequal(java.lang.Object a, java.lang.Object b, java.lang.String message) Checks that the specified arguments are equal to each other by using Object.equals().
static void	isfalse(boolean val) Checks that the specified argument is false.
static void	isfalse(boolean val, java.lang.String message) Checks that the specified argument is false.
static void	isnull(java.lang.Object obj) Checks that the specified argument is null.
static void	isnull(java.lang.Object obj, java.lang.String message) Checks that the specified argument is null.
static void	issame(java.lang.Object a, java.lang.Object b) Checks to see if specified objects are the same object, that is, the references are identical.
static void	issame(java.lang.Object a, java.lang.Object b, java.lang.String message) Checks to see if specified objects are the same object, that is, the references are identical.
static void	istrue(boolean val) Checks that the specified argument is true.
static void	istrue(boolean val, java.lang.String message) Checks that the specified argument is true.
static void	notequal(java.lang.Object a, java.lang.Object b) Checks that the specified arguments are not equal to each other by using Object.equals().
static void	notequal(java.lang.Object a, java.lang.Object b, java.lang.String message) Checks that the specified arguments are not equal to each other by using Object.equals().
static void	notnull(java.lang.Object obj) Checks that the specified argument is not null.
static void	notnull(java.lang.Object obj, java.lang.String message) Checks that the specified argument is not null.
static void	notsame(java.lang.Object a, java.lang.Object b) Checks to see if specified objects are not the same object, that is, the references are not identical.
static void	notsame(java.lang.Object a, java.lang.Object b, java.lang.String message) Checks to see if specified objects are not the same object, that is, the references are not identical.
static boolean	setHandler(IArgcheckFailHandler thehandler) Sets a different error handler.

Methods inherited from class java.lang.Object

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

Method Detail

isfalse

public static void isfalse(boolean val)

Checks that the specified argument is false.

Parameters:

val - value to be tested

isfalse

public static void isfalse(boolean val,
                           java.lang.String message)

Checks that the specified argument is false.

Parameters:

val - value to be tested

message - message for the exception

istrue

public static void istrue(boolean val)

Checks that the specified argument is true.

Parameters:

val - value to be tested

istrue

public static void istrue(boolean val,
                          java.lang.String message)

Checks that the specified argument is true.

Parameters:

val - value to be tested

message - message for the exception

notnull

public static void notnull(java.lang.Object obj)

Checks that the specified argument is not null.

Parameters:

obj - value to be tested

notnull

public static void notnull(java.lang.Object obj,
                           java.lang.String message)

Checks that the specified argument is not null.

Parameters:

obj - value to be tested

message - message for the exception

isnull

public static void isnull(java.lang.Object obj)

Checks that the specified argument is null.

Parameters:

obj - value to be tested

isnull

public static void isnull(java.lang.Object obj,
                          java.lang.String message)

Checks that the specified argument is null.

Parameters:

obj - value to be tested

message - message for the exception

isequal

public static void isequal(java.lang.Object a,
                           java.lang.Object b)

Checks that the specified arguments are equal to each other by using Object.equals().

Parameters:

a - first value to be tested

b - second value to be tested

isequal

public static void isequal(java.lang.Object a,
                           java.lang.Object b,
                           java.lang.String message)

Checks that the specified arguments are equal to each other by using Object.equals().

Parameters:

a - first value to be tested

b - second value to be tested

message - message message for the exception

notequal

public static void notequal(java.lang.Object a,
                            java.lang.Object b)

Checks that the specified arguments are not equal to each other by using Object.equals().

Parameters:

a - first value to be tested

b - second value to be tested

notequal

public static void notequal(java.lang.Object a,
                            java.lang.Object b,
                            java.lang.String message)

Checks that the specified arguments are not equal to each other by using Object.equals().

Parameters:

a - first value to be tested

b - second value to be tested

message - message message for the exception

issame

public static void issame(java.lang.Object a,
                          java.lang.Object b)

Checks to see if specified objects are the same object, that is, the references are identical. This provides a stronger notion of equality than the Object.equals() method.

Parameters:

a - first value to be tested

b - second value to be tested

issame

public static void issame(java.lang.Object a,
                          java.lang.Object b,
                          java.lang.String message)

Checks to see if specified objects are the same object, that is, the references are identical. This provides a stronger notion of equality than the Object.equals() method.

Parameters:

a - first value to be tested

b - second value to be tested

message - message message for the exception

notsame

public static void notsame(java.lang.Object a,
                           java.lang.Object b)

Checks to see if specified objects are not the same object, that is, the references are not identical.

Parameters:

a - first value to be tested

b - second value to be tested

notsame

public static void notsame(java.lang.Object a,
                           java.lang.Object b,
                           java.lang.String message)

Checks to see if specified objects are not the same object, that is, the references are not identical.

Parameters:

a - first value to be tested

b - second value to be tested

message - message message for the exception

setHandler

public static boolean setHandler(IArgcheckFailHandler thehandler)

Sets a different error handler.

Parameters:

thehandler - the new error handler

Returns:

true is successful, false otherwise