io.github.glytching.junit.extension.exception

Annotation Type ExpectedException

@Retention(value=RUNTIME)
 @Target(value={METHOD,ANNOTATION_TYPE})
 @Documented
 @ExtendWith(value=ExpectedExceptionExtension.class)
public @interface ExpectedException

Describes the expectations for an exception, including:

• The exception class
• Case sensitive matchers on the exception message in the form of:
  • Message matches exactly
  • Message starts with
  • Message contains

Usage example:

  // match an exception of type Exception containing the message "Boom!"
  @ExpectedException(type = RuntimeException.class, messageIs = "Boom!")

  // match an exception of type RuntimeException containing a message which starts with "Bye"
  @ExpectedException(type = RuntimeException.class, messageStartsWith = "Bye")

  // match an exception of type MyDomainException having a message which contains "ouch"
  @ExpectedException(type = MyDomainException.class, messageContains = "ouch")
 

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
Class<? extends Throwable>	type

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	messageContains
String	messageIs
String	messageStartsWith

Element Detail

type

public abstract Class<? extends Throwable> type

messageIs

public abstract String messageIs

Default:

""

messageStartsWith

public abstract String messageStartsWith

Default:

""

messageContains

public abstract String messageContains

Default:

""