com.amazonaws.services.lambda.runtime.tests.annotations

Annotation Type Events

@Documented
 @Target(value=METHOD)
 @Retention(value=RUNTIME)
 @ArgumentsSource(value=EventsArgumentsProvider.class)
public @interface Events

This annotation must be used in conjunction with ParameterizedTest.
It enables to inject multiple events (loaded from json files) of the desired type into the current test.

Several notations are possible according to what you want to do:

• Using the folder parameter is the more straightforward, and it will use all files in the folder
  

       @ParameterizedTest
       @Events(folder = "sqs", type = SQSEvent.class)
       public void testInjectEventsFromFolder(SQSEvent event) {
           assertThat(event).isNotNull();
           assertThat(event.getRecords()).hasSize(1);
       }
   

• Or you can list all the Events
  

   @ParameterizedTest
       @Events(
               events = {
                       @Event("sqs/sqs_event.json"),
                       @Event("sqs/sqs_event2.json"),
               },
               type = SQSEvent.class
       )
       public void testInjectEvents(SQSEvent event) {
           assertThat(event).isNotNull();
           assertThat(event.getRecords()).hasSize(1);
       }
  
       @ParameterizedTest
       @Events(
               events = {
                       @Event(value = "sqs/sqs_event.json", type = SQSEvent.class),
                       @Event(value = "sqs/sqs_event2.json", type = SQSEvent.class),
               }
       )
       public void testInjectEvents2(SQSEvent event) {
           assertThat(event).isNotNull();
           assertThat(event.getRecords()).hasSize(1);
       }
   

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Event[]	events Mutually exclusive with folder
java.lang.String	folder Folder where to find json files containing events
java.lang.Class<?>	type Type of the events (for example, one of the aws-lambda-java-events), or your own type

Element Detail

folder

public abstract java.lang.String folder

Folder where to find json files containing events

Returns:

the folder name

Default:

""

type

public abstract java.lang.Class<?> type

Type of the events (for example, one of the aws-lambda-java-events), or your own type

Returns:

the type of the events

Default:

java.lang.Void.class

events

public abstract Event[] events

Mutually exclusive with folder

Returns:

the array of events

Default:

{}