Serverless Java container

The aws-serverless-java-container makes it easy to run Java applications written with frameworks such as Spring, Spring Boot, Apache Struts, Jersey, or Spark in AWS Lambda.

Serverless Java Container natively supports API Gateway's proxy integration models for requests and responses, you can create and inject custom models for methods that use custom mappings.

Currently the following versions are maintained:

Version	Branch	Java Enterprise support	Spring versions	JAX-RS/ Jersey version	Struts support	Spark support
1.x	1.x	Java EE (javax.*)	5.x (Boot 2.x)	2.x	✅	✅
2.x	2.1.x	Jakarta EE 9-10 (jakarta.*)	6.x (Boot 3.x)	3.x	❌	❌
3.x	main	Jakarta EE 11 (jakarta.*)	7.x (Boot 4.x)	3.x	❌	❌

Follow the quick start guides in our wiki to integrate Serverless Java Container with your project:

• Spring quick start
• Spring Boot 2 quick start
• Spring Boot 3 quick start
• Spring Boot 4 quick start
• Apache Struts quick start
• Jersey quick start
• Spark quick start

Below is the most basic AWS Lambda handler example that launches a Spring application. You can also take a look at the samples in this repository, our main wiki page includes a step-by-step guide on how to deploy the various sample applications using Maven and SAM.

publicclassStreamLambdaHandlerimplementsRequestStreamHandler {
privatestaticfinalSpringLambdaContainerHandler<AwsProxyRequest, AwsProxyResponse> handler;
static {
try {
handler = SpringLambdaContainerHandler.getAwsProxyHandler(PetStoreSpringAppConfig.class);
} catch (ContainerInitializationExceptione) {
// if we fail here. We re-throw the exception to force another cold starte.printStackTrace();
thrownewRuntimeException("Could not initialize Spring framework", e);
}
}
@OverridepublicvoidhandleRequest(InputStreaminputStream, OutputStreamoutputStream, Contextcontext)
throwsIOException {
handler.proxyStream(inputStream, outputStream, context);
}
}

Public Examples

Blogs

• Re-platforming Java applications using the updated AWS Serverless Java Container

Workshops

• Java on AWS Lambda From Serverful to Serverless Java with AWS Lambda in 2 hours

Videos

• Spring on AWS Lambda YouTube Playlist from @plantpowerjames

Java samples with different frameworks

• Dagger, Micronaut, Quarkus, Spring Boot