satin.common.assertion
Class Assert

java.lang.Object
  |
  +--satin.common.assertion.Assert

public abstract class Assert
extends java.lang.Object

Wrapper for assertion functions. Objects of this class cannot be instantiated.

Author:

Ed Stauff

Method Summary

static void	condition(boolean condition) Throws an AssertionError if the condition is false.
static void	condition(boolean condition, java.lang.String descr) Throws an AssertionError if the condition is false.
static void	inRange(long value, long min, long max) Throws an AssertionError if the value is out of range.
static void	inRange(long value, long min, long max, java.lang.String descr) Throws an AssertionError if the value is out of range.
static void	notNull(java.lang.Object obj) Throws an AssertionError if the object is null.
static void	notNull(java.lang.Object obj, java.lang.String descr) Throws an AssertionError if the object is null.
static void	notReached() Throws an AssertionError to indicate unreachable code.
static void	notReached(java.lang.String descr) Throws an AssertionError to indicate unreachable code.

Methods inherited from class java.lang.Object

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

Method Detail

notReached

public static void notReached()

Throws an AssertionError to indicate unreachable code. Use this in place of otherwise dangling "else" clauses or missing "default" statements to indicate a code path that should never happen.

Throws:

AssertionError -

notReached

public static void notReached(java.lang.String descr)

Throws an AssertionError to indicate unreachable code. Use this in place of otherwise dangling "else" clauses or missing "default" statements to indicate a code path that should never happen.

Parameters:

descr

a description of the unreachable code.

Throws:

AssertionError -

notNull

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

Throws an AssertionError if the object is null.

Parameters:

obj

the object which had better not be null.

Throws:

AssertionError -

notNull

public static void notNull(java.lang.Object obj,
                           java.lang.String descr)

Throws an AssertionError if the object is null.

Parameters:

obj

the object which had better not be null.

descr

a description of the object.

Throws:

AssertionError -

inRange

public static void inRange(long value,
                           long min,
                           long max,
                           java.lang.String descr)

Throws an AssertionError if the value is out of range.

Parameters:

value

the value to be tested.

min

the minimum legal value (inclusive).

max

the maximum legal value (inclusive).

descr

a description of the value.

Throws:

AssertionError -

inRange

public static void inRange(long value,
                           long min,
                           long max)

Throws an AssertionError if the value is out of range.

Parameters:

value

the value to be tested.

min

the minimum legal value (inclusive).

max

the maximum legal value (inclusive).

Throws:

AssertionError -

condition

public static void condition(boolean condition)

Throws an AssertionError if the condition is false. Use this only when a more specific Assert function is not appropriate.

Parameters:

condition

the condition which had better be true.

Throws:

AssertionError -

condition

public static void condition(boolean condition,
                             java.lang.String descr)

Throws an AssertionError if the condition is false. Use this only when a more specific Assert function is not appropriate.

Parameters:

condition

the condition which had better be true.

descr

a description of the condition.

Throws:

AssertionError -

Revision History

5/31/01 Ed Stauff - made changes to docs per initial code review.

20 March 2001 - reviewed by Test Automation team.