Extension SDK

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 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 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

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.

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

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.

checkAWTThread

public static void checkAWTThread()
                           throws oracle.ide.util.Assert.CheckException
Checks that the current thread is the AWT event dispatcher.

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

fail

public static void fail()
                 throws oracle.ide.util.Assert.CheckException
Shorthand for causing a check exception if the code reaches an unexpected location.

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

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.

Extension SDK