Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)

Summary: Ctors | Inherited Methods | [Expand All]

Added in API level 1

public class

IOException

extends Exception

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	java.io.IOException

Known Direct Subclasses

Base64DataException , CharConversionException , CharacterCodingException , ClientProtocolException , ClosedChannelException , ConnectionClosedException , EOFException , FileLockInterruptionException , FileNotFoundException , HttpRetryException , InterruptedIOException , InvalidPropertiesFormatException , MalformedChunkCodingException , MalformedJsonException , MalformedURLException , and 13 others.

Base64DataException	This exception is thrown by `Base64InputStream` or `Base64OutputStream` when an error is detected in the data being decoded.
CharConversionException	The top level class for character conversion exceptions.
CharacterCodingException	A `CharacterCodingException` is thrown when an encoding or decoding error occurs.
ClientProtocolException	Signals an error in the HTTP protocol.
ClosedChannelException	A `ClosedChannelException` is thrown when a channel is closed for the type of operation attempted.
ConnectionClosedException	Indicates that a connection has been closed.
EOFException	Thrown when a program encounters the end of a file or stream during an input operation.
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.
HttpRetryException	If a HTTP request has to be retried, this exception will be thrown if the request cannot be retried automatically.
InterruptedIOException	Signals that a blocking I/O operation has been interrupted.
InvalidPropertiesFormatException	An `InvalidPropertiesFormatException` is thrown if loading the XML document defining the properties does not follow the `Properties` specification.
MalformedChunkCodingException	Signals a malformed chunked stream.
MalformedJsonException	Thrown when a reader encounters malformed JSON.
MalformedURLException	This exception is thrown when a program attempts to create an URL from an incorrect specification.
NoHttpResponseException	Signals that the target server failed to respond with a valid HTTP response.
ObjectStreamException	Signals some sort of problem during either serialization or deserialization of objects.
ParcelFileDescriptor.FileDescriptorDetachedException	Exception that indicates that the file descriptor was detached.
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.
SSLException	The base class for all SSL related exceptions.
SocketException	This `SocketException` may be thrown during socket creation or setting options, and is the superclass of all other socket related exceptions.
SyncFailedException	Signals that the `sync()` method has failed to complete.
TagLostException
UTFDataFormatException	Signals that an incorrectly encoded UTF-8 string has been encountered, most likely while reading some `DataInputStream` .
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.
UnsupportedEncodingException	Thrown when a program asks for a particular character converter that is unavailable.
ZipException	This runtime exception is thrown by `ZipFile` and `ZipInputStream` when the file or stream is not a valid zip file.

Known Indirect Subclasses

AsynchronousCloseException , BindException , ClosedByInterruptException , ConnectException , ConnectTimeoutException , ConnectionPoolTimeoutException , HttpHostConnectException , HttpResponseException , InvalidClassException , InvalidObjectException , JarException , MalformedInputException , NoRouteToHostException , NotActiveException , NotSerializableException , and 10 others.

AsynchronousCloseException	An `AsynchronousCloseException` is thrown when the underlying channel for an I/O operation is closed by another thread.
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.
ClosedByInterruptException	A `ClosedByInterruptException` is thrown when a thread is interrupted in a blocking I/O operation.
ConnectException	A `ConnectException` is thrown if a connection cannot be established to a remote host on a specific port.
ConnectTimeoutException	A timeout while connecting to an HTTP server or waiting for an available connection from an HttpConnectionManager.
ConnectionPoolTimeoutException	A timeout while waiting for an available connection from a connection manager.
HttpHostConnectException	A `ConnectException` that specifies the `HttpHost` that was being connected to.
HttpResponseException	Signals a non 2xx HTTP response.
InvalidClassException	Signals a problem during the serialization or or deserialization of an object.
InvalidObjectException	Signals that, during deserialization, the validation of an object has failed.
JarException	This runtime exception is thrown when a problem occurs while reading a JAR file.
MalformedInputException	A `MalformedInputException` is thrown when a malformed input is encountered, for example if a byte sequence is illegal for the given charset.
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.
NotActiveException	Signals that a serialization-related method has been invoked in the wrong place.
NotSerializableException	Signals that an object that is not serializable has been passed into the `ObjectOutput.writeObject()` method.
OptionalDataException	Signals that the `ObjectInputStream` class encountered a primitive type ( `int` , `char` etc.) instead of an object instance in the input stream.
PortUnreachableException	This `PortUnreachableException` will be thrown if an `ICMP_Port_Unreachable` message has been received.
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.
SocketTimeoutException	This exception is thrown when a timeout expired on a socket `read` or `accept` operation.
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).
UnmappableCharacterException	An `UnmappableCharacterException` is thrown when an unmappable character for the given charset is encountered.
WriteAbortedException	Signals that the `readObject()` method has detected an exception marker in the input stream.

Class Overview

Signals a general, I/O-related error. Error details may be specified when calling the constructor, as usual. Note there are also several subclasses of this class for more specific error situations, such as FileNotFoundException or EOFException .

Summary

Public Constructors
	IOException () Constructs a new `IOException` with its stack trace filled in.
	IOException ( String detailMessage) Constructs a new `IOException` with its stack trace and detail message filled in.
	IOException ( String message, Throwable cause) Constructs a new instance of this class with detail message and cause filled in.
	IOException ( Throwable cause) Constructs a new instance of this class with its detail cause filled in.

[Expand]

Inherited Methods

From class java.lang.Throwable

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.

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 IOException ()

Added in API level 1

Constructs a new IOException with its stack trace filled in.

public IOException ( String detailMessage)

Added in API level 1

Constructs a new IOException with its stack trace and detail message filled in.

Parameters

detailMessage	the detail message for this exception.

public IOException ( String message, Throwable cause)

Added in API level 9

Constructs a new instance of this class with detail message and cause filled in.

Parameters

message	The detail message for the exception.
cause	The detail cause for the exception.

public IOException ( Throwable cause)

Added in API level 9

Constructs a new instance of this class with its detail cause filled in.

Parameters

cause	The detail cause for the exception.

Results

Interfaces

Classes

Exceptions

Errors

IOException

Class Overview

Summary

Public Constructors

public IOException ()

public IOException ( String detailMessage)

Parameters

public IOException ( String message, Throwable cause)

Parameters

public IOException ( Throwable cause)

Parameters