Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

Throwable

extends Object

java.lang.Object
↳	java.lang.Throwable

Known Direct Subclasses

Error, Exception

Known Indirect Subclasses

AnnotationFormatError, ArithmeticException, ArrayIndexOutOfBoundsException, ArrayStoreException, AuthenticateException, BufferOverflowException, BufferUnderflowException, ClassCastException, ClassNotFoundException, CloneNotSupportedException, ConcurrentModificationException, ContentException, CrossThreadException, EOFException, and 40 others.

AnnotationFormatError	A mirror of java.lang.annotation.AnnotationFormatError.
ArithmeticException	Thrown when an exceptional arithmetic condition has occurred.
ArrayIndexOutOfBoundsException	Thrown to indicate that an array has been accessed with an illegal index.
ArrayStoreException	Thrown to indicate that an attempt has been made to store the wrong type of object into an array of objects.
AuthenticateException	Authentication step has failed.
BufferOverflowException	Unchecked exception thrown when a relative put operation reaches the target buffer's limit.
BufferUnderflowException	Unchecked exception thrown when a relative get operation reaches the source buffer's limit.
ClassCastException	Thrown to indicate that the code has attempted to cast an object to a subclass of which it is not an instance.
ClassNotFoundException	Thrown when an application tries to load in a class through its string name using the `forName` method in class `Class` but no definition for the class with the specified name could be found.
CloneNotSupportedException	Thrown when a program attempts to clone an object which does not support the `Cloneable` interface.
ConcurrentModificationException	An `ConcurrentModificationException` is thrown when a Collection is modified and an existing iterator on the Collection is used to modify the Collection as well.
ContentException	Indicates that there was a network, parser, cache error when performing a query.
CrossThreadException	Exception thrown when a non Thread-safe modification is done in the wrong thread.
EOFException	Signals that an end of file or end of stream has been reached unexpectedly during input.
EmptyStackException	Thrown by methods in the `Stack` class to indicate that the stack is empty.
FileNotFoundException	Signals that an attempt to open the file denoted by a specified pathname has failed.
IOException	Signals that an I/O exception of some sort has occurred.
IllegalAccessException	Thrown when an application tries to load in a class, but the currently executing method does not have access to the definition of the specified class, because the class is not public and in another package.
IllegalArgumentException	Thrown to indicate that a method has been passed an illegal or inappropriate argument.
IllegalMonitorStateException	Thrown to indicate that a thread has attempted to wait on an object's monitor or to notify other threads waiting on an object's monitor without owning the specified monitor.
IllegalStateException	Signals that a method has been invoked at an illegal or inappropriate time.
IllegalThreadStateException	Thrown to indicate that a thread is not in an appropriate state for the requested operation.
IncompatibleClassChangeError	`IncompatibleClassChangeError` is the superclass of all classes which represent errors that occur when inconsistent class files are loaded into the same running image.
IncompleteAnnotationException	A mirror of java.lang.annotation.IncompleteAnnotationException.
IndexOutOfBoundsException	Thrown to indicate that an index of some sort (such as to an array, to a string, or to a vector) is out of range.
InstantiationException	Thrown when an application tries to create an instance of a class using the `newInstance` method in class `Class`, but the specified class object cannot be instantiated because it is an interface or is an abstract class.
InterruptedException	Thrown when a thread is waiting, sleeping, or otherwise paused for a long time and another thread interrupts it using the `interrupt` method in class `Thread`.
InterruptedIOException	Signals that an I/O operation has been interrupted.
JSONException	The JSONException is thrown by the JSON.org classes then things are amiss.
LinkageError	`LinkageError` is the superclass of all error classes that occur when loading and linking class files.
MalformedJSONException	Thrown when a reader encounters malformed JSON.
MapRequestException	Exception thrown when an error occurs during the map direction request.
MediaException	This exception is thrown by `Camera` when a requested media can not be found.
NegativeArraySizeException	Thrown if an application tries to create an array with negative size.
NetworkException	Indicates that there was a network error when performing a query.
NoClassDefFoundError	Thrown if the Java Virtual Machine tries to load in the definition of a class (as part of a normal method call or as part of creating a new instance using the new expression) and no definition of the class could be found.
NoConnectionException	The network connectivity does not exist and the device could not establish connections and pass data.
NoSuchElementException	Thrown by the `nextElement` method of an `Enumeration` to indicate that there are no more elements in the enumeration.
NoSuchFieldError	Thrown when the virtual machine notices that a program tries to reference, on a class or object, a field that does not exist.
NullPointerException	Thrown when an application attempts to use `null` in a case where an object is required.
NumberFormatException	Thrown to indicate that the application has attempted to convert a string to one of the numeric types, but that the string does not have the appropriate format.
OutOfMemoryError	Thrown when the Java Virtual Machine cannot allocate an object because it is out of memory, and no more memory could be made available by the garbage collector.
ProtocolException	Thrown to indicate that there is an error in the underlying protocol, such as a TCP error.
ResourceNotFoundException	This exception is thrown by `ResManager` when a requested resource can not be found.
RuntimeException	`RuntimeException` is the superclass of those exceptions that can be thrown during the normal operation of the Java Virtual Machine.
SecurityException	Thrown by the security manager to indicate a security violation.
ServerException	The server has sent a response that does not have a 2XX, 401 or 403 HTTP status code.
StringIndexOutOfBoundsException	Thrown by the `charAt` method in class `String` and by other `String` methods to indicate that an index is either negative or greater than or equal to the size of the string.
TimeoutException	Time out has been reached.
UTFDataFormatException	Signals that a malformed UTF-8 string has been read in a data input stream or by any class that implements the data input interface.
UnknownWifiAccessException	Exception that is thrown when the Wifi interface is required but not found.
UnsupportedEncodingException	The Character Encoding is not supported.
UnsupportedOperationException
VirtualMachineError	Thrown to indicate that the Java Virtual Machine is broken or has run out of resources necessary for it to continue operating.
XmlPullParserException	This exception is thrown to signal XML Pull Parser related faults.

Class Overview

The Throwable class is the superclass of all errors and exceptions in the Java language. Only objects that are instances of this class (or of one of its subclasses) are thrown by the Java Virtual Machine or can be thrown by the Java throw statement. Similarly, only this class or one of its subclasses can be the argument type in a catch clause.

Instances of two subclasses, Error and Exception, are conventionally used to indicate that exceptional situations have occurred. Typically, these instances are freshly created in the context of the exceptional situation so as to include relevant information (such as stack trace data).

By convention, class Throwable and its subclasses have two constructors, one that takes no arguments and one that takes a String argument that can be used to produce an error message.

A Throwable class contains a snapshot of the execution stack of its thread at the time it was created. It can also contain a message string that gives more information about the error.

Here is one example of catching an exception:

     try {
         int a[] = new int[2];
         a[4];
     } catch (ArrayIndexOutOfBoundsException e) {
         System.out.println("exception: " + e.getMessage());
         e.printStackTrace();
     }

Summary

Public Constructors
	Throwable() Constructs a new `Throwable` with `null` as its error message string.
	Throwable(String message) Constructs a new `Throwable` with the specified error message.

Public Methods
String	getMessage() Returns the error message string of this throwable object.
void	printStackTrace() Prints this `Throwable` and its backtrace to the standard error stream.
String	toString() Returns a short description of this throwable object.

[Expand]

Inherited Methods

From class java.lang.Object

boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
final Class<?>	getClass() Returns the runtime class of an object.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait(long timeout, int nanos) Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
final void	wait() Causes current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Public Constructors

public Throwable ()

Constructs a new Throwable with null as its error message string.

public Throwable (String message)

Constructs a new Throwable with the specified error message.

Parameters

message	the error message. The error message is saved for later retrieval by the `getMessage()` method.

Public Methods

public String getMessage ()

Returns the error message string of this throwable object.

Returns

the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message.

public void printStackTrace ()

Prints this Throwable and its backtrace to the standard error stream. This method prints a stack trace for this Throwable object on the error output stream that is the value of the field System.err. The first line of output contains the result of the toString() method for this object.

The format of the backtrace information depends on the implementation.

public String toString ()

Returns a short description of this throwable object. If this Throwable object was created with an error message string, then the result is the concatenation of three strings:

The name of the actual class of this object
": " (a colon and a space)
The result of the getMessage() method for this object

If this Throwable object was created with no error message string, then the name of the actual class of this object is returned.

Returns

a string representation of this Throwable.

Interfaces

Classes

Annotations

Exceptions

Errors

Throwable

Class Overview

Summary

Public Constructors

public Throwable ()

public Throwable (String message)

Parameters

Public Methods

public String getMessage ()

Returns

public void printStackTrace ()

public String toString ()

Returns