giuseppe-trisciuoglio/developer-kit / plugins/developer-kit-java/skills/aws-sdk-java-v2-lambda
aws-sdk-java-v2-lambda
UnverifiedProvides AWS Lambda patterns using AWS SDK for Java 2.x. Use when invoking Lambda functions, creating/updating functions, managing function configurations, working with Lambda layers, or integrating Lambda with Spring Boot applications.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.0 KB |
| references/client-setup.md | markdown | 2.4 KB |
| references/examples.md | markdown | 16.7 KB |
| references/function-management.md | markdown | 7.3 KB |
| references/invocation-patterns.md | markdown | 7.3 KB |
| references/official-documentation.md | markdown | 4.4 KB |
| references/spring-boot-integration.md | markdown | 8.2 KB |
| references/testing.md | markdown | 8.3 KB |
references/testing.md
View on GitHub# Testing Lambda Services
## Unit Testing with Mocks
```java
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import software.amazon.awssdk.services.lambda.LambdaClient;
import software.amazon.awssdk.services.lambda.model.InvokeResponse;
import software.amazon.awssdk.core.SdkBytes;
import static org.mockito.Mockito.*;
import static org.assertj.core.api.Assertions.*;
@ExtendWith(MockitoExtension.class)
class LambdaInvokerServiceTest {
@Mock
private LambdaClient lambdaClient;
@Mock
private ObjectMapper objectMapper;
@InjectMocks
private LambdaInvokerService service;
@Test
void shouldInvokeLambdaSuccessfully() throws Exception {
// Arrange
String functionName = "test-function";
OrderRequest request = new OrderRequest("123", List.of());
String jsonPayload = "{\"orderId\":\"123\",\"items\":[]}";
String jsonResponse = "{\"status\":\"SUCCESS\"}";
when(objectMapper.writeValueAsString(request)).thenReturn(jsonPayload);
when(objectMapper.readValue(jsonResponse, OrderResponse.class))
.thenReturn(new OrderResponse("SUCCESS"));
InvokeResponse invokeResponse = InvokeResponse.builder()
.statusCode(200)
.payload(SdkBytes.fromUtf8String(jsonResponse))
.build();
when(lambdaClient.invoke(any(InvokeRequest.class))).thenReturn(invokeResponse);
// Act
OrderResponse response = service.invoke(functionName, request, OrderResponse.class);
// Assert
assertThat(response.getStatus()).isEqualTo("SUCCESS");
InvokeRequest expectedRequest = InvokeRequest.builder()
.functionName(functionName)
.payload(SdkBytes.fromUtf8String(jsonPayload))
.build();
verify(lambdaClient).invoke(expectedRequest);
}
@Test
void shouldHandleLambdaFunctionError() throws Exception {
// Arrange
String functionName = "test-function";
OrderRequest request = new OrderRequest("123", List.of());
String jsonPayload = "{\"orderId\":\"123\",\"items\":[]}";
String errorResponse = "{\"error\":\"Invalid input\"}";
when(objectMapper.writeValueAsString(request)).thenReturn(jsonPayload);
InvokeResponse invokeResponse = InvokeResponse.builder()
.statusCode(200)
.functionError("Unhandled")
.payload(SdkBytes.fromUtf8String(errorResponse))
.build();
when(lambdaClient.invoke(any(InvokeRequest.class))).thenReturn(invokeResponse);
// Act & Assert
assertThatThrownBy(() -> service.invoke(functionName, request, OrderResponse.class))
.isInstanceOf(LambdaInvocationException.class)
.hasMessageContaining("Lambda function error");
}
@Test
void shouldHandleServiceException() {
// Arrange
String functionName = "test-function";
OrderRequest request = new OrderRequest("123", List.of());
when(lambdaClient.invoke(any(InvokeRequest.class)))
.thenThrow(new LambdaException("Service unavailable"));
// Act & Assert
assertThatThrownBy(() -> service.invoke(functionName, request, OrderResponse.class))
.isInstanceOf(RuntimeException.class)
.hasMessageContaining("Failed to invoke Lambda function");
}
}
```
## Integration Testing
```java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.ActiveProfiles;
import static org.assertj.core.api.Assertions.*;
@SpringBootTest
@ActiveProfiles("test")
class LambdaInvokerServiceIntegrationTest {
@Autowired
private LambdaInvokerService lambdaInvoker;
@Test
void shouldInvokeRealLambdaFunction() {
// Arrange
String functionName = "test-function";
TestRequest request = new TestRequest("test-data");
// Act
TestResponse response = lambdaInvoker.invoke(functionName, request, TestResponse.class);
// Assert
assertThat(response).isNotNull();
assertThat(response.getStatus()).isEqualTo("SUCCESS");
}
}
```
## Testing with LocalStack
```java
import org.testcontainers.containers.localstack.LocalStackContainer;
import org.testcontainers.junit.jupiter.Container;
import org.testcontainers.junit.jupiter.Testcontainers;
import org.testcontainers.utility.DockerImageName;
import software.amazon.awssdk.auth.credentials.AwsBasicCredentials;
import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.lambda.LambdaClient;
@SpringBootTest
@Testcontainers
class LambdaLocalStackTest {
@Container
static LocalStackContainer localstack = new LocalStackContainer(
DockerImageName.parse("localstack/localstack:latest"))
.withServices(LocalStackContainer.Service.LAMBDA);
@DynamicPropertySource
static void configureProperties(DynamicPropertyRegistry registry) {
registry.add("aws.endpoint", localstack::getEndpoint);
registry.add("aws.region", () -> "us-east-1");
}
@Bean
public LambdaClient lambdaClient() {
return LambdaClient.builder()
.endpointOverride(URI.create(localstack.getEndpoint()))
.region(Region.US_EAST_1)
.credentialsProvider(StaticCredentialsProvider.create(
AwsBasicCredentials.create("test", "test")))
.build();
}
}
```
## Testing Async Invocations
```java
@ExtendWith(MockitoExtension.class)
class AsyncLambdaServiceTest {
@Mock
private LambdaAsyncClient asyncClient;
@InjectMocks
private AsyncLambdaService asyncService;
@Test
void shouldInvokeLambdaAsync() throws Exception {
// Arrange
String functionName = "test-function";
String payload = "{\"test\":\"data\"}";
CompletableFuture<InvokeResponse> future = CompletableFuture.completedFuture(
InvokeResponse.builder()
.statusCode(202)
.payload(SdkBytes.fromUtf8String("{\"status\":\"accepted\"}"))
.build()
);
when(asyncClient.invoke(any(InvokeRequest.class))).thenReturn(future);
// Act
CompletableFuture<String> result = asyncService.invokeAsync(functionName, payload);
// Assert
assertThat(result.get()).contains("accepted");
}
}
```
## Testing Error Scenarios
```java
@Test
void shouldHandleTimeout() {
// Arrange
when(lambdaClient.invoke(any(InvokeRequest.class)))
.thenAnswer(invocation -> {
Thread.sleep(5000); // Simulate timeout
return InvokeResponse.builder().build();
});
// Act & Assert
assertThatThrownBy(() -> service.invoke("function", request, Response.class))
.isInstanceOf(RuntimeException.class);
}
@Test
void shouldRetryOnTransientFailure() {
// Arrange
when(lambdaClient.invoke(any(InvokeRequest.class)))
.thenThrow(new LambdaException("Service unavailable"))
.thenReturn(InvokeResponse.builder()
.statusCode(200)
.payload(SdkBytes.fromUtf8String("{\"status\":\"ok\"}"))
.build());
// Act
Response response = service.invokeWithRetry("function", request, Response.class, 3);
// Assert
assertThat(response.getStatus()).isEqualTo("ok");
verify(lambdaClient, times(2)).invoke(any(InvokeRequest.class));
}
```
## Test Fixtures
```java
class LambdaTestFixture {
public static InvokeResponse successResponse(String payload) {
return InvokeResponse.builder()
.statusCode(200)
.payload(SdkBytes.fromUtf8String(payload))
.build();
}
public static InvokeResponse errorResponse(String error) {
return InvokeResponse.builder()
.statusCode(200)
.functionError("Handled")
.payload(SdkBytes.fromUtf8String("{\"error\":\"" + error + "\"}"))
.build();
}
public static InvokeRequest invokeRequest(String functionName, String payload) {
return InvokeRequest.builder()
.functionName(functionName)
.payload(SdkBytes.fromUtf8String(payload))
.build();
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 117k | Updated | Claude CodeCodex | Unverified | Install |