Powertools for AWS Lambda (Java) Preview (original) (raw)

Homepage

Warning

You are browsing the documentation for Powertools for AWS Lambda (Java) - v2. This is a snapshot release and not stable! Check out our stable v1 documentation if this is not what you wanted.
The v2 maven snapshot repository can be found here .

Powertools for AWS Lambda (Java) is a suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier.

Tip

Powertools for AWS Lambda is also available for Python, TypeScript, and .NET

Looking for a quick run through of the core utilities?

Check out this detailed blog post with a practical example. To dive deeper, the Powertools for AWS Lambda (Java) workshop is a great next step.

Tenets¶

This project separates core utilities that will be available in other runtimes vs general utilities that might not be available across all runtimes.

• AWS Lambda only – We optimise for AWS Lambda function environments and supported runtimes only. Utilities might work with web frameworks and non-Lambda environments, though they are not officially supported.
• Eases the adoption of best practices – The main priority of the utilities is to facilitate best practices adoption, as defined in the AWS Well-Architected Serverless Lens; all other functionality is optional.
• Keep it lean – Additional dependencies are carefully considered for security and ease of maintenance, and prevent negatively impacting startup time.
• We strive for backwards compatibility – New features and changes should keep backwards compatibility. If a breaking change cannot be avoided, the deprecation and migration process should be clearly defined.
• We work backwards from the community – We aim to strike a balance of what would work best for 80% of customers. Emerging practices are considered and discussed via Requests for Comment (RFCs)
• Progressive - Utilities are designed to be incrementally adoptable for customers at any stage of their Serverless journey. They follow language idioms and their community’s common practices.

Install¶

Quick hello world example using SAM CLI

You can use SAM to quickly setup a serverless project including Powertools for AWS Lambda (Java).

Manual installationPowertools for AWS Lambda (Java) dependencies are available in Maven Central. You can use your favourite dependency management tool to install it

• Maven
• Gradle

MavenGradle

Why a different configuration?

Powertools for AWS Lambda (Java) is using AspectJ internally to handle annotations. Recently, in order to support Java 17 we had to move to dev.aspectj:aspectj-maven-plugin because
org.codehaus.mojo:aspectj-maven-plugin does not support Java 17. Under the hood, org.codehaus.mojo:aspectj-maven-plugin is based on AspectJ 1.9.7, while dev.aspectj:aspectj-maven-plugin is based on AspectJ 1.9.8, compiled for Java 11+.

Java Compatibility¶

Powertools for AWS Lambda (Java) supports all Java version from 11 up to 21 as well as thecorresponding Lambda runtimes.

For the following modules, Powertools for AWS Lambda (Java) leverages the aspectj library to provide annotations: - Logging - Metrics - Tracing - Parameters - Idempotency - Validation - Large messages

You may need to add the good version of aspectjrt to your dependencies based on the jdk used for building your function:

Use the following dependency matrix between this library and the JDK:

Environment variables¶

Info

Explicit parameters take precedence over environment variables.