oracle.ide.util
Class Assert

java.lang.Object
  oracle.ide.util.Assert

public final class Assert

extends java.lang.Object

The Assert class provides basic assertion and tracing support. All of the methods in this class are static and return void; this allows the OJC compiler to optionally exclude calls to these methods made from other classes. Thus, Assert method calls can be present in debug builds and not in release builds.

The check and precondition methods will throw exceptions if checking is enabled. Checking is enabled by default. To disable checking, pass the flag

-Dide.AssertCheckingDisabled=true

to the VM when starting up by using an AddVMOption entry in the jdev.conf file or passing the flag on the command line if invoking directly.

Since:

5.0

See Also:

precondition(boolean, java.lang.String), check(boolean, java.lang.String)

Method Summary

static void	check(boolean condition) Check a condition within a method body.
static void	check(boolean condition, java.lang.String description) Check a condition within a method body.
static void	checkAWTThread() Checks that the current thread is the AWT event dispatcher.
static void	execute(java.lang.Runnable runnable)
static void	exit(int code) Exit the IDE with an error code.
static void	fail() Shorthand for causing a check exception if the code reaches an unexpected location.
static void	fail(java.lang.Exception ex) Shorthand for causing a check exception if the code reaches an unexpected location.
static void	fail(java.lang.String description) Shorthand for causing a check exception if the code reaches an unexpected location.
static void	precondition(boolean condition) Assert a precondition before a method body run.
static void	precondition(boolean condition, java.lang.String description) Assert a precondition before a method body run.
static void	print(boolean condition, java.lang.String s) Print a string to standard error if a condition is true.
static void	print(boolean condition, java.lang.String trueString, java.lang.String falseString) Print a string to standard error based on the evaluation of a condition.
static void	print(java.lang.String s) Print a string to standard error.
static void	println(boolean condition, java.lang.String s) Print a string and a newline to standard error if a condition is true
static void	println(boolean condition, java.lang.String trueString, java.lang.String falseString) Print a string and a newline to standard error based on the evaluation of a condition.
static void	println(java.lang.String s) Print a string and a newline to standard error.
static void	println(java.lang.String pattern, java.lang.Object param) Print a one parameter formatted message string and a newline to standard error.
static void	println(java.lang.String pattern, java.lang.Object[] params) Print a multiple parameter formatted message string and a newline to standard error.
static void	println(java.lang.String pattern, java.lang.Object param1, java.lang.Object param2) Print a two parameter formatted message string and a newline to standard error.
static void	println(java.lang.String pattern, java.lang.Object param1, java.lang.Object param2, java.lang.Object param3) Print a three parameter formatted message string and a newline to standard error.
static void	printStackTrace() Print a diagnostic stack trace of the current thread.
static void	printStackTrace(boolean condition, java.lang.String s) Print a diagnostic stack trace if the specified condition is true.
static void	printStackTrace(java.lang.Throwable ex) Print the stack trace of a Throwable.

Methods inherited from class java.lang.Object

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

Method Detail

precondition

public static void precondition(boolean condition,
                                java.lang.String description)
                         throws oracle.ide.util.Assert.PreconditionException

Assert a precondition before a method body run. Use this to describe assumed state and parameter values. A precondition is raised if the given condition is not true. An error here usually indicates a problem with the use of the class.

Parameters:

condition - The condition being asserted.

description - The description of the failed assertion

Throws:

oracle.ide.util.Assert.PreconditionException

precondition

public static void precondition(boolean condition)
                         throws oracle.ide.util.Assert.PreconditionException

Assert a precondition before a method body run. Use this to describe assumed state and parameter values. A precondition is raised if the given condition is not true. An error here usually indicates a problem with the use of the class.

Parameters:

condition - The condition being asserted.

Throws:

oracle.ide.util.Assert.PreconditionException

check

public static void check(boolean condition,
                         java.lang.String description)
                  throws oracle.ide.util.Assert.CheckException

Check a condition within a method body. Use this to describe assumed results and state after internal operations. A check is raised if the given condition is not true. An error here usually indicates an internal problem with the class.

Parameters:

condition - The condition being asserted.

description - The description of the failed assertion

Throws:

oracle.ide.util.Assert.CheckException

check

public static void check(boolean condition)
                  throws oracle.ide.util.Assert.CheckException

Check a condition within a method body. Use this to describe assumed results and state after internal operations. A check is raised if the given condition is not true. An error here usually indicates an internal problem with the class.

Parameters:

condition - The condition being asserted.

Throws:

oracle.ide.util.Assert.CheckException

checkAWTThread

public static void checkAWTThread()
                           throws oracle.ide.util.Assert.CheckException

Checks that the current thread is the AWT event dispatcher.

Throws:

oracle.ide.util.Assert.CheckException

fail

public static void fail(java.lang.String description)
                 throws oracle.ide.util.Assert.CheckException

Shorthand for causing a check exception if the code reaches an unexpected location.

Parameters:

description - The description of the failure

Throws:

oracle.ide.util.Assert.CheckException

fail

public static void fail()
                 throws oracle.ide.util.Assert.CheckException

Shorthand for causing a check exception if the code reaches an unexpected location.

Throws:

oracle.ide.util.Assert.CheckException

fail

public static void fail(java.lang.Exception ex)
                 throws oracle.ide.util.Assert.CheckException

Shorthand for causing a check exception if the code reaches an unexpected location.

Parameters:

ex - An exception encapsulating the failure

Throws:

oracle.ide.util.Assert.CheckException

exit

public static void exit(int code)

Exit the IDE with an error code.

Parameters:

code - the Exit code.

printStackTrace

public static void printStackTrace()

Print a diagnostic stack trace of the current thread.

printStackTrace

public static void printStackTrace(java.lang.Throwable ex)

Print the stack trace of a Throwable.

Parameters:

ex - The Throwable with the stack trace info.

printStackTrace

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

Print a diagnostic stack trace if the specified condition is true.

Parameters:

condition - the condition that determines whether to print the stack trace.

s - the string to print before the stack trace.

print

public static void print(java.lang.String s)

Print a string to standard error.

Parameters:

s - the string to print.

print

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

Print a string to standard error if a condition is true.

Parameters:

condition - the condition to evaluate

s - the string to print.

print

public static void print(boolean condition,
                         java.lang.String trueString,
                         java.lang.String falseString)

Print a string to standard error based on the evaluation of a condition.

Parameters:

condition - the condition to evaluate

trueString - the string to print if condition is true.

falseString - the string to print if condition is false.

println

public static void println(java.lang.String s)

Print a string and a newline to standard error.

Parameters:

s - the string to print

println

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

Print a string and a newline to standard error if a condition is true

Parameters:

condition - the condition to evaluate

s - the string to print.

println

public static void println(boolean condition,
                           java.lang.String trueString,
                           java.lang.String falseString)

Print a string and a newline to standard error based on the evaluation of a condition.

Parameters:

condition - the condition to evaluate

trueString - the string to print if condition is true.

falseString - the string to print if condition is false.

println

public static void println(java.lang.String pattern,
                           java.lang.Object param)

Print a one parameter formatted message string and a newline to standard error. Convenience wrapper for println(String,Object[]).

println

public static void println(java.lang.String pattern,
                           java.lang.Object param1,
                           java.lang.Object param2)

Print a two parameter formatted message string and a newline to standard error. Convenience wrapper for println(String,Object[]).

println

public static void println(java.lang.String pattern,
                           java.lang.Object param1,
                           java.lang.Object param2,
                           java.lang.Object param3)

Print a three parameter formatted message string and a newline to standard error. Convenience wrapper for println(String,Object[]).

println

public static void println(java.lang.String pattern,
                           java.lang.Object[] params)

Print a multiple parameter formatted message string and a newline to standard error.

Parameters:

pattern - the format pattern for the message.

params - an array of objects to be formatted and substituted into the result string.

See Also:

MessageFormat.format(String,Object[])

execute

public static void execute(java.lang.Runnable runnable)