org.junit.gen5.api.extension

Interface ExceptionHandlerExtensionPoint

All Superinterfaces:

Extension, ExtensionPoint

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
 @API(value=Experimental)
public interface ExceptionHandlerExtensionPoint
extends ExtensionPoint

ExceptionHandlerExtensionPoint defines the API for Extensions that wish to react to thrown exceptions in tests.

Common use cases include swallowing an exception if it's anticipated or rolling back a transaction in certain error scenarios.

Implementations must provide a no-args constructor.

Since:

5.0

Method Summary

Modifier and Type	Method and Description
void	handleException(TestExtensionContext context, java.lang.Throwable throwable) React to a throwable which has been thrown by a test method.

Method Detail

handleException

void handleException(TestExtensionContext context,
                     java.lang.Throwable throwable)
              throws java.lang.Throwable

React to a throwable which has been thrown by a test method.

Implementors have to decide if they

• Rethrow the incoming throwable
• Throw a newly constructed Exception or Throwable
• Swallow the incoming throwable

If the incoming throwable is swallowed, other registered exception handlers with later Position will not be called. Otherwise, the next exception handler will be called with the freshly thrown Throwable.

Throws:

java.lang.Throwable