com.github.fge.fs.dropbox.misc

Class DropBoxIOException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

com.github.fge.fs.dropbox.misc.DropBoxIOException

All Implemented Interfaces:

Serializable

public final class DropBoxIOException
extends IOException

Class used as a wrapper over the DropBox API's unchecked exceptions when an IOException is needed

The problem mainly comes from DbxClient.Uploader and DbxClient.Uploader. Both of these methods define a close() method but none of them implement Closeable. Worse than that, at least as far as the uploader is concerned, this method is not even idempotent, and all exceptions it throws are unchecked.

The file system API, however, needs "correct" IOExceptions to be thrown. We therefore capture all RuntimeExceptions thrown by either a downloader or an uploader, and wrap it into such an exception.

See Also:

DropBoxInputStream, DropBoxOutputStream, Serialized Form

Constructor Summary

Constructors

Constructor and Description
DropBoxIOException() Constructs an IOException with null as its error detail message.
DropBoxIOException(String message) Constructs an IOException with the specified detail message.
DropBoxIOException(String message, Throwable cause) Constructs an IOException with the specified detail message and cause.
DropBoxIOException(Throwable cause) Constructs an IOException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

Method Summary

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

DropBoxIOException

public DropBoxIOException()

Constructs an IOException with null as its error detail message.

DropBoxIOException

public DropBoxIOException(String message)

Constructs an IOException with the specified detail message.

Parameters:

message - The detail message (which is saved for later retrieval by the Throwable.getMessage() method)

DropBoxIOException

public DropBoxIOException(String message,
                  Throwable cause)

Constructs an IOException with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated into this exception's detail message.

Parameters:

message - The detail message (which is saved for later retrieval by the Throwable.getMessage() method)

cause - The cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Since:

1.6

DropBoxIOException

public DropBoxIOException(Throwable cause)

Constructs an IOException with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for IO exceptions that are little more than wrappers for other throwables.

Parameters:

cause - The cause (which is saved for later retrieval by the Throwable.getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Since:

1.6