com.googlecode.catchexception.throwable.apis

Class BDDCatchThrowable

java.lang.Object

com.googlecode.catchexception.throwable.apis.BDDCatchThrowable

public class BDDCatchThrowable
extends Object

Supports BDD-like approach to catch and verify throwables (given/when/then).

import static com.googlecode.catchexception.throwable.apis .BDDCatchThrowable.*; // given an empty list List myList = new ArrayList(); // when we try to get the first element of the list when(myList).get(1); // then we expect an IndexOutOfBoundsThrowable then(caughtThrowable()) .isInstanceOf(IndexOutOfBoundsThrowable.class) .hasMessage("Index: 1, Size: 0") .hasNoCause(); // then we expect an IndexOutOfBoundsThrowable (alternatively) thenThrown(IndexOutOfBoundsThrowable.class);

Since:

1.3.0

Author:

rwoo, mariuszs

Constructor Summary

Constructors

Constructor and Description
BDDCatchThrowable()

Method Summary

Modifier and Type	Method and Description
static Throwable	caughtThrowable() Returns the throwable caught during the last call on the proxied object in the current thread.
static <T extends Throwable> T	caughtThrowable(Class<T> caughtThrowableType)
static void	thenThrown(Class actualThrowableClazz) Throws an assertion if no throwable is thrown or if an throwable of an unexpected type is thrown.
static void	when(ThrowingCallable actor)

Methods inherited from class java.lang.Object

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

Constructor Detail

BDDCatchThrowable

public BDDCatchThrowable()

Method Detail

when

public static void when(ThrowingCallable actor)

Parameters:

actor - The instance that shall be proxied. Must not be null.

See Also:

CatchThrowable.catchThrowable(ThrowingCallable)

caughtThrowable

public static Throwable caughtThrowable()

Returns the throwable caught during the last call on the proxied object in the current thread.

Returns:

Returns the throwable caught during the last call on the proxied object in the current thread - if the call was made through a proxy that has been created via when(ThrowingCallable). Returns null the proxy has not caught an throwable. Returns null if the caught throwable belongs to a class that is no longer loaded.

caughtThrowable

public static <T extends Throwable> T caughtThrowable(Class<T> caughtThrowableType)

thenThrown

public static void thenThrown(Class actualThrowableClazz)

Throws an assertion if no throwable is thrown or if an throwable of an unexpected type is thrown.

EXAMPLE: // given a list with nine members List myList = Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9); // when we try to get the 500th member of the fellowship when(myList).get(500); // then we expect an IndexOutOfBoundsThrowable thenThrown(IndexOutOfBoundsThrowable.class);

Parameters:

actualThrowableClazz - the expected type of the caught throwable.