totalcross.lang

Class Throwable4D

java.lang.Object

totalcross.lang.Throwable4D

Direct Known Subclasses:

Exception4D

public class Throwable4D
extends java.lang.Object

Base class of all Exceptions.

IMPORTANT: the totalcross.lang package is the java.lang that will be used in the device. You CANNOT use nor import totalcross.lang package in desktop. When tc.Deploy is called, all references to java.lang are replaced by totalcross.lang automatically. Given this, you must use only the classes and methods that exists BOTH in java.lang and totalcross.lang. For example, you can't use java.lang.ClassLoader because there are no totalcross.lang.ClassLoader. Another example, you can't use java.lang.String.indexOfIgnoreCase because there are no totalcross.lang.String.indexOfIgnoreCase method. Trying to use a class or method from the java.lang package that has no correspondence with totalcross.lang will make the tc.Deploy program to abort, informing where the problem occured. A good idea is to always refer to this javadoc to know what is and what isn't available.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	msg Stores the message given when constructing this Throwable object
java.lang.String	trace

Constructor Summary

Constructors

Constructor and Description
Throwable4D() Constructs an empty Exception.
Throwable4D(java.lang.String msg) Constructs an exception with the given message.
Throwable4D(java.lang.String message, Throwable4D cause) Instantiate this Throwable with the given message and cause.
Throwable4D(java.lang.String message, Throwable4D cause, boolean enableSuppression, boolean writableStackTrace)
Throwable4D(Throwable4D cause) Instantiate this Throwable with the given cause.

Method Summary

Modifier and Type	Method and Description
void	addSuppressed(Throwable4D exception)
Throwable4D	getCause()
java.lang.String	getMessage() Returns the message passed on the constructor.
java.lang.StackTraceElement[]	getStackTrace()
Throwable4D[]	getSuppressed()
Throwable4D	initCause(Throwable4D cause)
void	printStackTrace() Prints the stack trace to the debug console.
void	printStackTrace(java.lang.Object o)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

msg

protected java.lang.String msg

Stores the message given when constructing this Throwable object

trace

public java.lang.String trace

Constructor Detail

Throwable4D

public Throwable4D()

Constructs an empty Exception.

Throwable4D

public Throwable4D(java.lang.String msg)

Constructs an exception with the given message.

Throwable4D

public Throwable4D(java.lang.String message,
                   Throwable4D cause)

Instantiate this Throwable with the given message and cause. Note that the message is unrelated to the message of the cause.

Parameters:

message - the message to associate with the Throwable

cause - the cause, may be null

Since:

1.4

Throwable4D

public Throwable4D(java.lang.String message,
                   Throwable4D cause,
                   boolean enableSuppression,
                   boolean writableStackTrace)

Throwable4D

public Throwable4D(Throwable4D cause)

Instantiate this Throwable with the given cause. The message is then built as cause == null ? null : cause.toString().

Parameters:

cause - the cause, may be null

Since:

1.4

Method Detail

getMessage

public java.lang.String getMessage()

Returns the message passed on the constructor. May be null.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

printStackTrace

public void printStackTrace()

Prints the stack trace to the debug console.

printStackTrace

public void printStackTrace(java.lang.Object o)

getCause

public Throwable4D getCause()

initCause

public Throwable4D initCause(Throwable4D cause)

addSuppressed

public final void addSuppressed(Throwable4D exception)

getSuppressed

public final Throwable4D[] getSuppressed()

getStackTrace

public java.lang.StackTraceElement[] getStackTrace()