Throwable - Android SDK

Annotations
Interfaces
Classes
- Boolean
- Byte
- Character
- Character.Subset
- Character.UnicodeBlock
- Class
- ClassLoader
- Compiler
- Double
- Enum
- Float
- InheritableThreadLocal
- Integer
- Long
- Math
- Number
- Object
- Package
- Process
- ProcessBuilder
- Runtime
- RuntimePermission
- SecurityManager
- Short
- StackTraceElement
- StrictMath
- String
- StringBuffer
- StringBuilder
- System
- Thread
- ThreadGroup
- ThreadLocal
- Throwable
- Void
Enums
- Thread.State
Exceptions
Errors

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

Added in API level 1

public class

Throwable

extends Object
implements Serializable

java.lang.Object
↳	java.lang.Throwable

Known Direct Subclasses

Error, Exception

Known Indirect Subclasses

AEADBadTagException, AbstractMethodError, AccessControlException, AccountsException, AclNotFoundException, ActivityNotFoundException, AlreadyConnectedException, AndroidException, AndroidRuntimeException, AnnotationFormatError, AnnotationTypeMismatchException, ArithmeticException, ArrayIndexOutOfBoundsException, ArrayStoreException, and 292 others.

AEADBadTagException	Thrown by a `Cipher` that is using an Authenticated Encryption with Additional Data (AEAD) mode such as Galois/Counter Mode (GCM) and the tag failed verification.
AbstractMethodError	Thrown by the VM when an abstract method is called.
AccessControlException	`AccessControlException` is thrown if the access control infrastructure denies protected access due to missing permissions.
AccountsException
AclNotFoundException	The exception, that is thrown when a reference to a non-existent Access Control List (ACL) is made.
ActivityNotFoundException	This exception is thrown when a call to `startActivity(Intent)` or one of its variants fails because an Activity can not be found to execute the given Intent.
AlreadyConnectedException	An `AlreadyConnectedException` is thrown when an attempt is made to connect a SocketChannel that is already connected.
AndroidException	Base class for all checked exceptions thrown by the Android frameworks.
AndroidRuntimeException	Base class for all unchecked exceptions thrown by the Android frameworks.
AnnotationFormatError	Indicates that an annotation in the binary representation of a class is syntactically incorrect and the annotation parser is unable to process it.
AnnotationTypeMismatchException	Indicates that an annotation type has changed since it was compiled or serialized.
ArithmeticException	Thrown when the an invalid arithmetic operation is attempted.
ArrayIndexOutOfBoundsException	Thrown when the an array is indexed with a value less than zero, or greater than or equal to the size of the array.
ArrayStoreException	Thrown when a program attempts to store an element of an incompatible type in an array.
AssertionError	Thrown when an assertion has failed.
AssertionFailedError	Thrown when an assertion failed.
AsynchronousCloseException	An `AsynchronousCloseException` is thrown when the underlying channel for an I/O operation is closed by another thread.
AuthenticatorException
BackingStoreException	An exception to indicate that an error was encountered while accessing the backing store.
BadPaddingException	The exception that is thrown when a padding mechanism is expected for the input data, but the input data does not have the proper padding bytes.
BadParcelableException	The object you are calling has died, because its hosting process no longer exists.
Base64DataException	This exception is thrown by `Base64InputStream` or `Base64OutputStream` when an error is detected in the data being decoded.
BatchUpdateException	This exception is thrown if a problem occurs during a batch update operation.
BindException	A `BindException` is thrown when a process cannot bind a local address/port, either because it is already bound or reserved by the OS.
BrokenBarrierException	Exception thrown when a thread tries to wait upon a barrier that is in a broken state, or which enters the broken state while the thread is waiting.
BufferOverflowException	A `BufferOverflowException` is thrown when elements are written to a buffer but there is not enough remaining space in the buffer.
BufferUnderflowException	A `BufferUnderflowException` is thrown when elements are read from a buffer but there are not enough remaining elements in the buffer.
CRLException	The exception that is thrown if errors occur during handling of `CRL`s.
CameraAccessException	`CameraAccessException` is thrown if a camera device could not be queried or opened by the `CameraManager`, or if the connection to an opened `CameraDevice` is no longer valid.
CancellationException	Exception indicating that the result of a value-producing task, such as a `FutureTask`, cannot be retrieved because the task was cancelled.
CancelledKeyException	A `CancelledKeyException` is thrown when an invalid selection key is used.
CertPathBuilderException	The exception that is thrown when a `CertPathBuilder` method fails.
CertPathValidatorException	The exception that is thrown when a certification path (or certificate chain) cannot be validated.
CertStoreException	The exception that is thrown when an access to a `CertStore` fails.
CertificateEncodingException	The exception that is thrown when an error occurs while a `Certificate` is being encoded.
CertificateException	The base class for all `Certificate` related exceptions.
CertificateExpiredException	The exception that is thrown when a `Certificate` has expired.
CertificateNotYetValidException	The exception that is thrown when a `Certificate` is not yet valid.
CertificateParsingException	The exception that is thrown when a `Certificate` can not be parsed.
CharConversionException	The top level class for character conversion exceptions.
CharacterCodingException	A `CharacterCodingException` is thrown when an encoding or decoding error occurs.
ClassCastException	Thrown when a program attempts to cast a an object to a type with which it is not compatible.
ClassCircularityError	Thrown when the VM notices that an attempt is made to load a class which would directly or indirectly inherit from one of its subclasses.
ClassFormatError	Thrown by a class loader when a class file has an illegal format or if the data that it contains can not be interpreted as a class.
ClassNotFoundException	Thrown when a class loader is unable to find a class.
CloneNotSupportedException	Thrown when a program attempts to clone an object which does not support the `Cloneable` interface.
ClosedByInterruptException	A `ClosedByInterruptException` is thrown when a thread is interrupted in a blocking I/O operation.
ClosedChannelException	A `ClosedChannelException` is thrown when a channel is closed for the type of operation attempted.
ClosedSelectorException	A `ClosedSelectorException` is thrown when a `selector` is closed and an I/O operation is attempted.
CoderMalfunctionError	A `CoderMalfunctionError` is thrown when the encoder/decoder is malfunctioning.
ComparisonFailure	Thrown when an assert equals for Strings failed.
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.
ConnectException	A `ConnectException` is thrown if a connection cannot be established to a remote host on a specific port.
ConnectTimeoutException	This class was deprecated in API level 22. Please use `openConnection()` instead. Please visit this webpage for further details.
ConnectionPendingException	A `ConnectionPendingException` is thrown when an attempt is made to connect a `SocketChannel` that has a non-blocking connection already underway.
CursorIndexOutOfBoundsException	An exception indicating that a cursor is out of bounds.
DOMException	DOM operations only raise exceptions in "exceptional" circumstances, i.e., when an operation is impossible to perform (either for logical reasons, because data is lost, or because the implementation has become unstable).
DataFormatException	`DataFormatException` is used to indicate an error in the format of a particular data stream which is to be uncompressed.
DataTruncation	An exception which is thrown when a JDBC driver unexpectedly truncates a data value either when reading (resulting in warning), or when writing data (resulting in an error).
DatatypeConfigurationException	Indicates a serious configuration error.
DeadObjectException	The object you are calling has died, because its hosting process no longer exists.
DeniedByServerException	Exception thrown when the provisioning server or key server denies a certficate or license for a device.
DestroyFailedException	Signals that the `destroy()` method failed.
DigestException	`DigestException` is a general message digest exception.
DuplicateFormatFlagsException	The unchecked exception will be thrown out if there are duplicate flags given out in the format specifier.
EOFException	Thrown when a program encounters the end of a file or stream during an input operation.
EmptyStackException	An `EmptyStackException` is thrown if the pop/peek method of a stack is executed on an empty stack.
EnumConstantNotPresentException	Thrown if an `enum` constant does not exist for a particular name.
ErrnoException	A checked exception thrown when `Os` methods fail.
ExceptionInInitializerError	Thrown when an exception occurs during class initialization.
ExecutionException	Exception thrown when attempting to retrieve the result of a task that aborted by throwing an exception.
ExemptionMechanismException	This is the base class for `ExemptionMechanismException`.
FactoryConfigurationError	Thrown when a problem with configuration with the Parser Factories exists.
FileLockInterruptionException	A `FileLockInterruptionException` is thrown when a thread is interrupted while waiting to acquire a file lock.
FileNotFoundException	Thrown when a file specified by a program cannot be found.
FormatException
FormatFlagsConversionMismatchException	A `FormatFlagsConversionMismatchException` will be thrown if a conversion and the flags are incompatible.
FormatterClosedException	A `FormatterClosedException` will be thrown if the formatter has been closed.
Fragment.InstantiationException	Thrown by `instantiate(Context, String, Bundle)` when there is an instantiation failure.
GLException	An exception class for OpenGL errors.
GeneralSecurityException	`GeneralSecurityException` is a general security exception and the superclass for all security specific exceptions.
GenericSignatureFormatError	Indicates that a malformed signature has been encountered via a reflective method.
HttpRetryException	If a HTTP request has to be retried, this exception will be thrown if the request cannot be retried automatically.
IOError	This error is thrown when a severe I/O error has happened.
IOException	Signals a general, I/O-related error.
IllegalAccessError	Thrown when the runtime notices that a program tries to access a class or member which is not accessible from where it is referenced.
IllegalAccessException	Thrown when a program attempts to access a field or method which is not accessible from the location where the reference is made.
IllegalArgumentException	Thrown when a method is invoked with an argument which it can not reasonably deal with.
IllegalBlockSizeException	The exception, that is thrown when the data length provided to a block cipher does not match the block size of the cipher.
IllegalBlockingModeException	An `IllegalBlockingModeException` is thrown when an operation that requires a specific blocking mode is invoked on a channel that is in a different blocking mode.
IllegalCharsetNameException	An `IllegalCharsetNameException` is thrown when an illegal charset name is encountered.
IllegalFormatCodePointException	An `IllegalFormatCodePointException` will be thrown if an invalid Unicode code point (defined by `isValidCodePoint(int)`) is passed as a parameter to a Formatter.
IllegalFormatConversionException	An `IllegalFormatConversionException` will be thrown when the parameter is incompatible with the corresponding format specifier.
IllegalFormatException	An `IllegalFormatException` is thrown when a format string that contains either an illegal syntax or format specifier is transferred as a parameter.
IllegalFormatFlagsException	An `IllegalFormatFlagsException` will be thrown if the combination of the format flags is illegal.
IllegalFormatPrecisionException	An `IllegalFormatPrecisionException` will be thrown if the precision is a negative other than -1 or in other cases where precision is not supported.
IllegalFormatWidthException	An `IllegalFormatWidthException` will be thrown if the width is a negative value other than -1 or in other cases where a width is not supported.
IllegalMonitorStateException	Thrown when a monitor operation is attempted when the monitor is not in the correct state, for example when a thread attempts to exit a monitor which it does not own.
IllegalSelectorException	An `IllegalSelectorException` is thrown when a call is made to register a channel on a selector that has been created by a different provider.
IllegalStateException	Thrown when an action is attempted at a time when the VM is not in the correct state.
IllegalThreadStateException	Thrown when an operation is attempted which is not possible given the state that the executing thread is in.
IllformedLocaleException	Thrown when a locale subtag or field is not well formed.
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	Indicates that an element of an annotation type was accessed that was added after the type was compiled or serialized.
IndexOutOfBoundsException	Thrown when a program attempts to access a value in an indexable collection using a value which is outside of the range of valid indices.
InflateException	This exception is thrown by an inflater on error conditions.
InputMismatchException	An `InputMismatchException` is thrown by a scanner to indicate that the next token does not match or is out of range for the type specified in the pattern.
InstantiationError	Thrown when the VM notices that a program tries to create a new instance of a class which has no visible constructors from the location where `new` is invoked.
InstantiationException	Thrown when a program attempts to access a constructor which is not accessible from the location where the reference is made.
IntentFilter.MalformedMimeTypeException	This exception is thrown when a given MIME type does not have a valid syntax.
IntentSender.SendIntentException	Exception thrown when trying to send through a PendingIntent that has been canceled or is otherwise no longer able to execute the request.
InternalError	Thrown when the VM notices that it has gotten into an undefined state.
InterruptedException	Thrown when a waiting thread is activated before the condition it was waiting for has been satisfied.
InterruptedIOException	Signals that a blocking I/O operation has been interrupted.
InvalidAlgorithmParameterException	`InvalidAlgorithmParameterException` indicates the occurrence of invalid algorithm parameters.
InvalidClassException	Signals a problem during the serialization or or deserialization of an object.
InvalidKeyException	`InvalidKeyException` indicates exceptional conditions, caused by an invalid key.
InvalidKeySpecException	The exception that is thrown when an invalid key specification is encountered.
InvalidMarkException	An `InvalidMarkException` is thrown when `reset()` is called on a buffer, but no mark has been set previously.
InvalidObjectException	Signals that, during deserialization, the validation of an object has failed.
InvalidParameterException	`InvalidParameterException` indicates exceptional conditions, caused by invalid parameters.
InvalidParameterSpecException	The exception that is thrown when an invalid parameter specification is encountered.
InvalidPreferencesFormatException	An exception to indicate that the input XML file is not well-formed or could not be validated against the appropriate document type (specified by in the `Preferences`).
InvalidPropertiesFormatException	An `InvalidPropertiesFormatException` is thrown if loading the XML document defining the properties does not follow the `Properties` specification.
InvocationTargetException	This class provides a wrapper for an exception thrown by a `Method` or `Constructor` invocation.
JSONException	Thrown to indicate a problem with the JSON API.
JarException	This runtime exception is thrown when a problem occurs while reading a JAR file.
KeyChainException	Thrown on problems accessing the `KeyChain`.
KeyCharacterMap.UnavailableException	Thrown by `load(int)` when a key character map could not be loaded.
KeyException	`KeyException` is the common superclass of all key related exceptions.
KeyExpiredException	Indicates that a cryptographic operation failed because the employed key's validity end date is in the past.
KeyManagementException	`KeyManagementException` is a general exception, thrown to indicate an exception during processing an operation concerning key management.
KeyNotYetValidException	Indicates that a cryptographic operation failed because the employed key's validity start date is in the future.
KeyPermanentlyInvalidatedException	Indicates that the key can no longer be used because it has been permanently invalidated.
KeyStoreException	`KeyStoreException` is a general `KeyStore` exception.
LSException	Parser or write operations may throw an `LSException` if the processing is stopped.
LastOwnerException	The exception that is thrown when an attempt is made to remove the the last `Owner` from an `Owner`.
LinkageError	`LinkageError` is the superclass of all error classes that occur when loading and linking class files.
LoginException	Base class for exceptions that are thrown when a login error occurs.
MalformedInputException	A `MalformedInputException` is thrown when a malformed input is encountered, for example if a byte sequence is illegal for the given charset.
MalformedJsonException	Thrown when a reader encounters malformed JSON.
MalformedParameterizedTypeException	Indicates that a malformed parameterized type has been encountered by a reflective method.
MalformedURLException	This exception is thrown when a program attempts to create an URL from an incorrect specification.
MediaCodec.CodecException	Thrown when an internal codec error occurs.
MediaCodec.CryptoException	Thrown when a crypto error occurs while queueing a secure input buffer.
MediaCryptoException	Exception thrown if MediaCrypto object could not be instantiated or if unable to perform an operation on the MediaCrypto object.
MediaDrm.MediaDrmStateException	Thrown when an unrecoverable failure occurs during a MediaDrm operation.
MediaDrmException	Base class for MediaDrm exceptions
MediaDrmResetException	This exception is thrown when the MediaDrm instance has become unusable due to a restart of the mediaserver process.
MissingFormatArgumentException	A `MissingFormatArgumentException` will be thrown if there is no corresponding argument with the specified conversion or an argument index that refers to a missing argument.
MissingFormatWidthException	A `MissingFormatWidthException` will be thrown if the format width is missing but is required.
MissingResourceException	A `MissingResourceException` is thrown by ResourceBundle when a resource bundle cannot be found or a resource is missing from a resource bundle.
NegativeArraySizeException	Thrown when an attempt is made to create an array with a size of less than zero.
NetworkErrorException
NetworkOnMainThreadException	The exception that is thrown when an application attempts to perform a networking operation on its main thread.
NoClassDefFoundError	Thrown when the VM is unable to locate a class which it has been asked to load.
NoConnectionPendingException	A `NoConnectionPendingException` is thrown if `SocketChannel`'s `finishConnect` method is called before the `SocketChannel`'s `connect(java.net.SocketAddress)` connect} method completed without error.
NoRouteToHostException	The `NoRouteToHostException` will be thrown while attempting to connect to a remote host but the host cannot be reached for instance because of a badly configured router or a blocking firewall.
NoSuchAlgorithmException	`NoSuchAlgorithmException` indicates that a requested algorithm could not be found.
NoSuchElementException	Thrown when trying to retrieve an element past the end of an Enumeration or Iterator.
NoSuchFieldError	Thrown when the VM notices that a program tries to reference, on a class or object, a field that does not exist.
NoSuchFieldException	Thrown when the VM notices that a program tries to reference, on a class or object, a field that does not exist.
NoSuchMethodError	Thrown when the VM notices that a program tries to reference, on a class or object, a method that does not exist.
NoSuchMethodException	Thrown when the VM notices that a program tries to reference, on a class or object, a method that does not exist.
NoSuchPaddingException	The exception that is thrown when the requested padding mechanism is not supported.
NoSuchPropertyException	Thrown when code requests a `Property` on a class that does not expose the appropriate method or field.
NoSuchProviderException	`NoSuchProviderException` indicates that a requested security provider could not be found.
NonReadableChannelException	A `NonReadableChannelException` is thrown when attempting to read from a channel that is not open for reading.
NonWritableChannelException	A `NonWritableChannelException` is thrown when attempting to write to a channel that is not open for writing.
NotActiveException	Signals that a serialization-related method has been invoked in the wrong place.
NotOwnerException	The exception that is thrown when an action that requires ownership is attempted by a principal that is not an owner of the object for which ownership is required.
NotProvisionedException	Exception thrown when an operation on a MediaDrm object is attempted and the device does not have a certificate.
NotSerializableException	Signals that an object that is not serializable has been passed into the `ObjectOutput.writeObject()` method.
NotYetBoundException	A `NotYetBoundException` is thrown if the server socket channel is not bound before an I/O operation is made.
NotYetConnectedException	A `NotYetConnectedException` is thrown if the socket channel is not connected before an I/O operation is invoked.
NullPointerException	Thrown when a program tries to access a field or method of an object or an element of an array when there is no instance or array to use, that is if the object or array points to `null`.
NumberFormatException	Thrown when an invalid value is passed to a string-to-number conversion method.
ObjectStreamException	Signals some sort of problem during either serialization or deserialization of objects.
OperationApplicationException	Thrown when an application of a `ContentProviderOperation` fails due the specified constraints.
OperationCanceledException	An exception type that is thrown when an operation in progress is canceled.
OptionalDataException	Signals that the `ObjectInputStream` class encountered a primitive type (`int`, `char` etc.) instead of an object instance in the input stream.
OutOfMemoryError	Thrown when a request for memory is made that can not be satisfied using the available platform resources.
OverlappingFileLockException	An `OverlappingFileLockException` is thrown when attempting to acquire a lock that overlaps an existing or pending lock held by this process.
PackageManager.NameNotFoundException	This exception is thrown when a given package, application, or component name cannot be found.
ParcelFileDescriptor.FileDescriptorDetachedException	Exception that indicates that the file descriptor was detached.
ParcelFormatException	The contents of a Parcel (usually during unmarshalling) does not contain the expected data.
ParseException	Thrown when the string being parsed is not in the correct form.
ParserConfigurationException	Indicates a serious configuration error.
PatternSyntaxException	Encapsulates a syntax error that occurred during the compilation of a `Pattern`.
PendingIntent.CanceledException	Exception thrown when trying to send through a PendingIntent that has been canceled or is otherwise no longer able to execute the request.
PortUnreachableException	This `PortUnreachableException` will be thrown if an `ICMP_Port_Unreachable` message has been received.
PrivilegedActionException	Legacy security code; do not use.
ProtocolException	Signals that either a connection attempt to a socket of the wrong type, the application of an unsupported operation or that a general error in the underlying protocol has occurred.
ProviderException	`ProviderException` is a general exception, thrown by security `Providers`.
RSDriverException	Base class for all exceptions thrown by the Android RenderScript
RSIllegalArgumentException	Base class for all exceptions thrown by the Android RenderScript
RSInvalidStateException	Base class for all exceptions thrown by the Android RenderScript
RSRuntimeException	Base class for all exceptions thrown by the Android RenderScript
ReadOnlyBufferException	A `ReadOnlyBufferException` is thrown when some write operation is called on a read-only buffer.
ReceiverCallNotAllowedException	This exception is thrown from `registerReceiver(BroadcastReceiver, IntentFilter)` and `bindService(Intent, ServiceConnection, int)` when these methods are being used from an `BroadcastReceiver` component.
ReflectiveOperationException	Superclass of exceptions related to reflection.
RejectedExecutionException	Exception thrown by an `Executor` when a task cannot be accepted for execution.
RemoteException	Parent exception for all Binder remote-invocation errors
RemoteViews.ActionException	Exception to send when something goes wrong executing an action
ResourceBusyException	Exception thrown when an operation on a MediaDrm object is attempted and hardware resources are not available, due to being in use.
Resources.NotFoundException	This exception is thrown by the resource APIs when a requested resource can not be found.
RuntimeException	`RuntimeException` is the superclass of all classes that represent exceptional conditions which occur as a result of executing an application in the VM.
SAXException	Encapsulate a general SAX error or warning.
SAXNotRecognizedException	Exception class for an unrecognized identifier.
SAXNotSupportedException	Exception class for an unsupported operation.
SAXParseException	Encapsulate an XML parse error or warning.
SQLClientInfoException	An exception, which is subclass of SQLException, is thrown when one or more client info properties could not be set on a Connection.
SQLDataException	An exception, which is subclass of SQLException, is thrown when various data errors arise.
SQLException	An exception that indicates a failed JDBC operation.
SQLFeatureNotSupportedException	An exception, which is subclass of SQLNonTransientException, is thrown when various the JDBC driver does not support an optional JDBC feature.
SQLIntegrityConstraintViolationException	An exception, which is subclass of SQLNonTransientException, is thrown when various the an integrity constraint (foreign key, primary key or unique key) has been violated.
SQLInvalidAuthorizationSpecException	An exception, which is subclass of SQLNonTransientException, is thrown when the authorization credentials presented during connection establishment are not valid.
SQLNonTransientConnectionException	An exception, which is subclass of SQLException, is thrown when the connection operation that failed will not succeed when the operation is retried without the cause of the failure being corrected.
SQLNonTransientException
SQLRecoverableException
SQLSyntaxErrorException
SQLTimeoutException
SQLTransactionRollbackException
SQLTransientConnectionException
SQLTransientException
SQLWarning	An exception class that holds information about Database access warnings.
SQLiteAbortException	An exception that indicates that the SQLite program was aborted.
SQLiteAccessPermException	This exception class is used when sqlite can't access the database file due to lack of permissions on the file.
SQLiteBindOrColumnIndexOutOfRangeException	Thrown if the the bind or column parameter index is out of range
SQLiteBlobTooBigException
SQLiteCantOpenDatabaseException
SQLiteConstraintException	An exception that indicates that an integrity constraint was violated.
SQLiteDatabaseCorruptException	An exception that indicates that the SQLite database file is corrupt.
SQLiteDatabaseLockedException	Thrown if the database engine was unable to acquire the database locks it needs to do its job.
SQLiteDatatypeMismatchException
SQLiteDiskIOException	An exception that indicates that an IO error occured while accessing the SQLite database file.
SQLiteDoneException	An exception that indicates that the SQLite program is done.
SQLiteException	A SQLite exception that indicates there was an error with SQL parsing or execution.
SQLiteFullException	An exception that indicates that the SQLite database is full.
SQLiteMisuseException	This error can occur if the application creates a SQLiteStatement object and allows multiple threads in the application use it at the same time.
SQLiteOutOfMemoryException
SQLiteReadOnlyDatabaseException
SQLiteTableLockedException
SSLException	The base class for all SSL related exceptions.
SSLHandshakeException	The exception that is thrown when a handshake could not be completed successfully.
SSLKeyException	The exception that is thrown when an invalid SSL key is encountered.
SSLPeerUnverifiedException	The exception that is thrown when the identity of a peer has not been verified.
SSLProtocolException	The exception that is thrown when an error in the operation of the SSL protocol is encountered.
SecurityException	Thrown when a security manager check fails.
ServiceConfigurationError	Thrown when a service provider can't be loaded by `ServiceLoader`.
Settings.SettingNotFoundException
ShortBufferException	The exception that is thrown when the result of an operation is attempted to store in a user provided buffer that is too small.
SignatureException	`SignatureException` is a general `Signature` exception.
SipException	Indicates a general SIP-related exception.
SocketException	This `SocketException` may be thrown during socket creation or setting options, and is the superclass of all other socket related exceptions.
SocketTimeoutException	This exception is thrown when a timeout expired on a socket `read` or `accept` operation.
StackOverflowError	Thrown when the depth of the stack of the running program exceeds some platform or VM specific limit.
StaleDataException	This exception is thrown when a Cursor contains stale data and must be requeried before being used again.
StreamCorruptedException	Signals that the `readObject()` method could not read an object due to missing information (for example, a cyclic reference that doesn't match a previous instance, or a missing class descriptor for the object to be loaded).
StringIndexOutOfBoundsException	Thrown when the a string is indexed with a value less than zero, or greater than or equal to the size of the array.
Surface.OutOfResourcesException	Exception thrown when a Canvas couldn't be locked with `lockCanvas(Rect)`, or when a SurfaceTexture could not successfully be allocated.
SurfaceHolder.BadSurfaceTypeException	Exception that is thrown from `lockCanvas()` when called on a Surface whose type is SURFACE_TYPE_PUSH_BUFFERS.
SurfaceTexture.OutOfResourcesException	This class was deprecated in API level 19. No longer thrown. `Surface.OutOfResourcesException` is used instead.
SyncFailedException	Signals that the `sync()` method has failed to complete.
TagLostException
ThreadDeath	ThreadDeath is thrown when a thread stops executing.
TimeFormatException
TimeoutException	Exception thrown when a blocking operation times out.
TooManyListenersException	A `TooManyListenersException` is thrown when an attempt is made to add more than one listener to an event source which only supports a single listener.
TransactionTooLargeException	The Binder transaction failed because it was too large.
TransformerConfigurationException	Indicates a serious configuration error.
TransformerException	This class specifies an exceptional condition that occurred during the transformation process.
TransformerFactoryConfigurationError	Thrown when a problem with configuration with the Transformer Factories exists.
TypeNotPresentException	Thrown when a program tries to access a class, interface, enum or annotation type through a string that contains the type's name and the type cannot be found.
URISyntaxException	A `URISyntaxException` will be thrown if some information could not be parsed while creating a URI.
UTFDataFormatException	Signals that an incorrectly encoded UTF-8 string has been encountered, most likely while reading some `DataInputStream`.
UndeclaredThrowableException	This class provides a wrapper for an undeclared, checked exception thrown by an InvocationHandler.
UnknownError	Thrown when the VM must throw an error which does not match any known exceptional condition.
UnknownFormatConversionException	An `UnknownFormatConversionException` will be thrown if the format conversion is unknown.
UnknownFormatFlagsException	An `UnknownFormatFlagsException` will be thrown if there is an unknown flag.
UnknownHostException	Thrown when a hostname can not be resolved.
UnknownServiceException	Is thrown if no appropriate `ContentHandler` could be found for a particular service requested by the URL connection.
UnmappableCharacterException	An `UnmappableCharacterException` is thrown when an unmappable character for the given charset is encountered.
UnrecoverableEntryException	`UnrecoverableEntryException` indicates, that a `KeyStore.Entry` cannot be recovered from a `KeyStore`.
UnrecoverableKeyException	`UnrecoverableKeyException` indicates, that a key cannot be recovered from a `KeyStore`.
UnresolvedAddressException	An `UnresolvedAddressException` is thrown when trying to use an unresolved network address in a network operation.
UnsatisfiedLinkError	Thrown when an attempt is made to invoke a native for which an implementation could not be found.
UnsupportedAddressTypeException	An `UnsupportedAddressTypeException` is thrown when connecting or binding to an unsupported address type.
UnsupportedCallbackException	Thrown when a `CallbackHandler` does not support a particular `Callback`.
UnsupportedCharsetException	An `UnsupportedCharsetException` is thrown when an unsupported charset name is encountered.
UnsupportedClassVersionError	Thrown when an attempt is made to load a class with a format version that is not supported by the VM.
UnsupportedEncodingException	Thrown when a program asks for a particular character converter that is unavailable.
UnsupportedOperationException	Thrown when an unsupported operation is attempted.
UnsupportedSchemeException	Exception thrown when an attempt is made to construct a MediaDrm object using a crypto scheme UUID that is not supported by the device
UserNotAuthenticatedException	Indicates that a cryptographic operation could not be performed because the user has not been authenticated recently enough.
VerifyError	Thrown when the VM notices that an attempt is made to load a class which does not pass the class verification phase.
VirtualMachineError	`VirtualMachineError` is the superclass of all error classes that occur during the operation of the VM.
WindowManager.BadTokenException	Exception that is thrown when trying to add view whose `WindowManager.LayoutParams` `token` is invalid.
WindowManager.InvalidDisplayException	Exception that is thrown when calling `addView(View, ViewGroup.LayoutParams)` to a secondary display that cannot be found.
WriteAbortedException	Signals that the `readObject()` method has detected an exception marker in the input stream.
XPathException	`XPathException` represents a generic XPath exception.
XPathExpressionException	`XPathExpressionException` represents an error in an XPath expression.
XPathFactoryConfigurationException	`XPathFactoryConfigurationException` represents a configuration error in a `XPathFactory` environment.
XPathFunctionException	`XPathFunctionException` represents an error with an XPath function.
XmlPullParserException	This exception is thrown to signal XML Pull Parser related faults.
ZipError	Thrown when an unrecoverable zip error has occurred.
ZipException	This runtime exception is thrown by `ZipFile` and `ZipInputStream` when the file or stream is not a valid zip file.

Class Overview

The superclass of all classes which can be thrown by the VM. The two direct subclasses are recoverable exceptions (Exception) and unrecoverable errors (Error). This class provides common methods for accessing a string message which provides extra information about the circumstances in which the Throwable was created (basically an error message in most cases), and for saving a stack trace (that is, a record of the call stack at a particular point in time) which can be printed later.

A Throwable can also include a cause, which is a nested Throwable that represents the original problem that led to this Throwable. It is often used for wrapping various types of errors into a common Throwable without losing the detailed original error information. When printing the stack trace, the trace of the cause is included.

Summary

Public Constructors
	Throwable() Constructs a new `Throwable` that includes the current stack trace.
	Throwable(String detailMessage) Constructs a new `Throwable` with the current stack trace and the given detail message.
	Throwable(String detailMessage, Throwable cause) Constructs a new `Throwable` with the current stack trace, the given detail message and cause.
	Throwable(Throwable cause) Constructs a new `Throwable` with the current stack trace and the given cause.

Protected Constructors
	Throwable(String detailMessage, Throwable cause, boolean enableSuppression, boolean writableStackTrace) Constructs a new `Throwable` with the current stack trace, the specified detail message and the specified cause.

Public Methods
final void	addSuppressed(Throwable throwable) Adds `throwable` to the list of throwables suppressed by this.
Throwable	fillInStackTrace() Records the stack trace from the point where this method has been called to this `Throwable`.
Throwable	getCause() Returns the cause of this `Throwable`, or `null` if there is no cause.
String	getLocalizedMessage() Returns the detail message which was provided when this `Throwable` was created.
String	getMessage() Returns the detail message which was provided when this `Throwable` was created.
StackTraceElement[]	getStackTrace() Returns a clone of the array of stack trace elements of this `Throwable`.
final Throwable[]	getSuppressed() Returns the throwables suppressed by this.
Throwable	initCause(Throwable throwable) Initializes the cause of this `Throwable`.
void	printStackTrace(PrintStream err) Writes a printable representation of this `Throwable`'s stack trace to the given print stream.
void	printStackTrace(PrintWriter err) Writes a printable representation of this `Throwable`'s stack trace to the specified print writer.
void	printStackTrace() Writes a printable representation of this `Throwable`'s stack trace to the `System.err` stream.
void	setStackTrace(StackTraceElement[] trace) Sets the array of stack trace elements.
String	toString() Returns a string containing a concise, human-readable description of this object.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public Throwable ()

Added in API level 1

Constructs a new Throwable that includes the current stack trace.

public Throwable (String detailMessage)

Added in API level 1

Constructs a new Throwable with the current stack trace and the given detail message.

public Throwable (String detailMessage, Throwable cause)

Added in API level 1

Constructs a new Throwable with the current stack trace, the given detail message and cause.

public Throwable (Throwable cause)

Added in API level 1

Constructs a new Throwable with the current stack trace and the given cause.

Protected Constructors

protected Throwable (String detailMessage, Throwable cause, boolean enableSuppression, boolean writableStackTrace)

Added in API level 19

Constructs a new Throwable with the current stack trace, the specified detail message and the specified cause.

Parameters

enableSuppression	if false, `addSuppressed(Throwable)` will be a no-op.
writableStackTrace	if false, `fillInStackTrace()` will not be called, this object's `stackTrace` will be null, calls to `fillInStackTrace()` and `setStackTrace(StackTraceElement[])` will be no-ops, and `getStackTrace()` will return a zero-length array.

Public Methods

public final void addSuppressed (Throwable throwable)

Added in API level 19

Adds throwable to the list of throwables suppressed by this. The throwable will included when this exception's stack trace is printed.

Throws

IllegalArgumentException	if `throwable == this`.
NullPointerException	if `throwable == null`.

public Throwable fillInStackTrace ()

Added in API level 1

Records the stack trace from the point where this method has been called to this Throwable. This method is invoked by the Throwable constructors.

This method is public so that code (such as an RPC system) which catches a Throwable and then re-throws it can replace the construction-time stack trace with a stack trace from the location where the exception was re-thrown, by calling fillInStackTrace.

This method is non-final so that non-Java language implementations can disable VM stack traces for their language. Filling in the stack trace is relatively expensive. Overriding this method in the root of a language's exception hierarchy allows the language to avoid paying for something it doesn't need.

Returns

this Throwable instance.

public Throwable getCause ()

Added in API level 1

Returns the cause of this Throwable, or null if there is no cause.

public String getLocalizedMessage ()

Added in API level 1

Returns the detail message which was provided when this Throwable was created. Returns null if no message was provided at creation time. Subclasses may override this method to return localized text for the message. Android returns the regular detail message.

public String getMessage ()

Added in API level 1

Returns the detail message which was provided when this Throwable was created. Returns null if no message was provided at creation time.

public StackTraceElement[] getStackTrace ()

Added in API level 1

Returns a clone of the array of stack trace elements of this Throwable. Each StackTraceElement represents an entry in the call stack. The element at position 0 is the top of the stack, that is, the stack frame where this Throwable is thrown.

public final Throwable[] getSuppressed ()

Added in API level 19

Returns the throwables suppressed by this.

public Throwable initCause (Throwable throwable)

Added in API level 1

Initializes the cause of this Throwable. The cause can only be initialized once.

Parameters

throwable	the cause of this `Throwable`.

Returns

this Throwable instance.

Throws

IllegalArgumentException	if `Throwable` is this object.
IllegalStateException	if the cause has already been initialized.

public void printStackTrace (PrintStream err)

Added in API level 1

Writes a printable representation of this Throwable's stack trace to the given print stream. If the Throwable contains a cause, the method will be invoked recursively for the nested Throwable.

public void printStackTrace (PrintWriter err)

Added in API level 1

Writes a printable representation of this Throwable's stack trace to the specified print writer. If the Throwable contains a cause, the method will be invoked recursively for the nested Throwable.

Parameters

err	the writer to write the stack trace on.

public void printStackTrace ()

Added in API level 1

Writes a printable representation of this Throwable's stack trace to the System.err stream.

public void setStackTrace (StackTraceElement[] trace)

Added in API level 1

Sets the array of stack trace elements. Each StackTraceElement represents an entry in the call stack. A copy of the specified array is stored in this Throwable. will be returned by getStackTrace() and printed by printStackTrace().

Parameters

trace	the new array of `StackTraceElement`s. A copy of the array is stored in this `Throwable`, so subsequent changes to `trace` will not change the call stack stored in this `Throwable`.

Throws

NullPointerException	if any element in `trace` is `null`.

public String toString ()

Added in API level 1

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Returns

a printable representation of this object.

Results

Annotations

Interfaces

Classes

Enums

Exceptions

Errors

Throwable

Class Overview

See Also

Summary

Public Constructors

public Throwable ()

public Throwable (String detailMessage)

public Throwable (String detailMessage, Throwable cause)

public Throwable (Throwable cause)

Protected Constructors

protected Throwable (String detailMessage, Throwable cause, boolean enableSuppression, boolean writableStackTrace)

Parameters

Public Methods

public final void addSuppressed (Throwable throwable)

Throws

public Throwable fillInStackTrace ()

Returns

public Throwable getCause ()

public String getLocalizedMessage ()

public String getMessage ()

public StackTraceElement[] getStackTrace ()

See Also

public final Throwable[] getSuppressed ()

public Throwable initCause (Throwable throwable)

Parameters

Returns

Throws

public void printStackTrace (PrintStream err)

public void printStackTrace (PrintWriter err)

Parameters

public void printStackTrace ()

public void setStackTrace (StackTraceElement[] trace)

Parameters

Throws

See Also

public String toString ()

Returns