org.chrisjaehnen.openlib.testutils.exception

Class ExpectedThrownException

java.lang.Object

org.chrisjaehnen.openlib.testutils.exception.ExpectedThrownException

public abstract class ExpectedThrownException
extends Object

The ExpectedThrownException class provides a testing framework for validating expected exceptions are thrown. This prevents expected exception limitations in JUnit 4.x as described in Be careful when using JUnit expected exceptions

Constructor Summary

Constructors

Constructor and Description
ExpectedThrownException(Class<? extends Exception> clazz) Required constructor that initializes a new instance of the ExpectedThrownException type with a reference to the class type of the expected exception.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	execute() Defines an abstract method to implement in subclasses that executes code for a test that throws an expected exception.
void	executeTest() Executes test code defined in the specified ExpectedThrownException and asserts if the exception was thrown as expected.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExpectedThrownException

public ExpectedThrownException(Class<? extends Exception> clazz)

Required constructor that initializes a new instance of the ExpectedThrownException type with a reference to the class type of the expected exception.

Parameters:

clazz - The class type of the expected exception.

Method Detail

execute

protected abstract void execute()

Defines an abstract method to implement in subclasses that executes code for a test that throws an expected exception.

executeTest

public void executeTest()

Executes test code defined in the specified ExpectedThrownException and asserts if the exception was thrown as expected. This method catches a generic Exception and verifies if the expected exception class type was actually thrown. Otherwise, TestCase.fail(String) is called that fails the test when the expected exception was not thrown.