oracle.jbo.common
Class Diagnostic

java.lang.Object
  oracle.jbo.common.Diagnostic

public final class Diagnostic
extends java.lang.Object

Field Summary

static java.lang.Class

CLASS_INSTANCE

Method Summary

static void	ASSERT(boolean test) Conditionally raises an exception.
static void	ASSERT(boolean test, java.lang.String message) Conditionally prints a warning method and raises an exception.
static void	ASSERT(boolean test, java.lang.String msg, java.lang.Object[] param) Conditionally prints a warning method.
static boolean	isOn()
static void	print(java.lang.String msg) Deprecated. You are encouraged to pass in the calling class and calling method
static void	print(java.lang.String message, int level) print a trace line to the diagnostic stream, at the diagnostic level indicated.
static void	println(java.lang.Class clazz, java.lang.String methodName, java.lang.String msg)
static void	println(java.lang.String msg) Deprecated. You are encouraged to pass in the calling class and calling method
static void	println(java.lang.StringBuffer message) Deprecated.
static void	println(java.lang.String message, int level) print a trace line to the diagnostic stream, at the diagnostic level indicated, and terminate it.
static void	printStackTrace() Prints a stack trace for the current environment.
static void	printStackTrace(java.lang.Throwable ex) Prints a stack trace for an exception.
static void	setStopOnAssert(boolean b) Programmatic entrypoint to control program flow if an assertion fails.

Methods inherited from class java.lang.Object

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

Field Detail

CLASS_INSTANCE

public static final java.lang.Class CLASS_INSTANCE

Method Detail

isOn

public static final boolean isOn()

print

public static final void print(java.lang.String msg)

Deprecated. You are encouraged to pass in the calling class and calling method

Parameters:

msg -

println

public static final void println(java.lang.String msg)

Deprecated. You are encouraged to pass in the calling class and calling method

Parameters:

msg -

println

public static final void println(java.lang.Class clazz,
                                 java.lang.String methodName,
                                 java.lang.String msg)

ASSERT

public static void ASSERT(boolean test)

Conditionally raises an exception.

An exception is raised if enabled by setStopOnAssert().

Parameters:

test - the result of the test being asserted.

Throws:

JboAssert - if test is true.

ASSERT

public static void ASSERT(boolean test,
                          java.lang.String msg,
                          java.lang.Object[] param)

Conditionally prints a warning method.

The message is constructed from a format string and an array of parameters. An exception is raised if enabled by setStopOnAssert().

Parameters:

test - the result of the test being asserted.

msg - the message's format string.

param - the array of message parameters.

Throws:

JboAssert - if test is true.

printStackTrace

public static void printStackTrace()

Prints a stack trace for the current environment.

printStackTrace

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

Prints a stack trace for an exception.

Parameters:

ex - the exception to be traced.

ASSERT

public static void ASSERT(boolean test,
                          java.lang.String message)

Conditionally prints a warning method and raises an exception.

An exception is raised if enabled by setStopOnAssert().

Parameters:

test - the result of the test being asserted.

message - the message.

Throws:

JboAssert - if test is true.

print

public static void print(java.lang.String message,
                         int level)

print a trace line to the diagnostic stream, at the diagnostic level indicated.

Parameters:

message - the text of the message

level - the trace level to be associated with this message

setStopOnAssert

public static void setStopOnAssert(boolean b)

Programmatic entrypoint to control program flow if an assertion fails. If it is set to true, then BC4J clients will receive an exception if an ASSERT() fails, otherwise a trace message is printed.

Parameters:

b - exception throw mode true or false

See Also:

ASSERT(boolean)

println

public static void println(java.lang.String message,
                           int level)

print a trace line to the diagnostic stream, at the diagnostic level indicated, and terminate it.

Parameters:

message - the text of the message

level - the trace level to be associated with this message

println

public static void println(java.lang.StringBuffer message)

Deprecated.

Prints a trace message line to the diagnostic device.

Parameters:

message - the text to be printed.