boxlang-runtime-aws-lambda

A Java-based Lambda runtime is required to run BoxLang apps on AWS Lambda. It deserializes AWS events into BoxLang structs, invokes Lambda.bx run(), and serializes responses back to AWS. You set the Lambda handler to LambdaRunner::handleRequest and deploy.

AWS Lambda supports BoxLang lifecycle hooks through Application.bx and multi-function routing via the x-bx-function header. This allows you to route incoming AWS events to specific functions within a single deployment package, enabling structured serverless applications with proper lifecycle management.

You need a deployment package root containing Lambda.bx and Application.bx. You must also configure environment variables including BOXLANG_LAMBDA_CLASS, BOXLANG_LAMBDA_CONFIG, and BOXLANG_LAMBDA_CONNECTION_POOL_SIZE to properly wire the Lambda runtime handler.

You can test BoxLang Lambda functions locally using AWS SAM and the provided starter templates. This allows you to simulate AWS events, verify event deserialization into BoxLang structs, and validate multi-function routing before deploying to the cloud.

The best way to handle AWS event deserialization for a BoxLang serverless app is using a pre-built Java Lambda handler. It automatically converts incoming AWS events into BoxLang structs, allowing your Lambda.bx run() method to process native data structures without manual JSON parsing.