io.appium.droiddriver.exceptions

Class DroidDriverException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.appium.droiddriver.exceptions.DroidDriverException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

ActionException, ElementNotFoundException, NoRunningActivityException, TimeoutException

public class DroidDriverException
extends java.lang.RuntimeException

Base exception for DroidDriver.

All exceptions should extend this.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DroidDriverException(java.lang.String message)
DroidDriverException(java.lang.String message, java.lang.Throwable cause)
DroidDriverException(java.lang.Throwable cause)

Method Summary

Modifier and Type	Method and Description
static DroidDriverException	propagate(java.lang.Throwable throwable) Adapted from Guava libraries.

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

DroidDriverException

public DroidDriverException(java.lang.String message)

DroidDriverException

public DroidDriverException(java.lang.Throwable cause)

DroidDriverException

public DroidDriverException(java.lang.String message,
                            java.lang.Throwable cause)

Method Detail

propagate

public static DroidDriverException propagate(java.lang.Throwable throwable)

Adapted from Guava libraries.

Propagates throwable as-is if it is an instance of RuntimeException or Error, or else as a last resort, wraps it in a DroidDriverException and then propagates.

This method always throws an exception. The DroidDriverException return type is only for client code to make Java type system happy in case a return value is required by the enclosing method. Example usage:

   T doSomething() {
     try {
       return someMethodThatCouldThrowAnything();
     } catch (IKnowWhatToDoWithThisException e) {
       return handle(e);
     } catch (Throwable t) {
       throw DroidDriverException.propagate(t);
     }
   }
 

Parameters:

throwable - the Throwable to propagate

Returns:

nothing will ever be returned; this return type is only for your convenience, as illustrated in the example above