com.amazonaws.serverless.proxy.internal

Class LambdaContainerHandler<RequestType,ResponseType,ContainerRequestType,ContainerResponseType>

java.lang.Object

com.amazonaws.serverless.proxy.internal.LambdaContainerHandler<RequestType,ResponseType,ContainerRequestType,ContainerResponseType>

Type Parameters:

RequestType - The expected request object. This is the model class that the event JSON is de-serialized to

ResponseType - The expected Lambda function response object. Responses from the container will be written to this model object

ContainerRequestType - The request type for the wrapped Java container

ContainerResponseType - The response or response writer type for the wrapped Java container

Direct Known Subclasses:

AwsLambdaServletContainerHandler

public abstract class LambdaContainerHandler<RequestType,ResponseType,ContainerRequestType,ContainerResponseType>
extends java.lang.Object

Abstract class that declares the basic methods and objects for implementations of LambdaContainerHandler.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.amazonaws.services.lambda.runtime.Context	lambdaContext
static java.lang.String	SERVER_INFO

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LambdaContainerHandler(RequestReader<RequestType,ContainerRequestType> requestReader, ResponseWriter<ContainerResponseType,ResponseType> responseWriter, SecurityContextWriter<RequestType> securityContextWriter, ExceptionHandler<ResponseType> exceptionHandler)

Method Summary

Modifier and Type	Method and Description
static ContainerConfig	getContainerConfig() Returns the current container configuration object.
protected abstract ContainerResponseType	getContainerResponse(ContainerRequestType request, java.util.concurrent.CountDownLatch latch)
protected abstract void	handleRequest(ContainerRequestType containerRequest, ContainerResponseType containerResponse, com.amazonaws.services.lambda.runtime.Context lambdaContext)
ResponseType	proxy(RequestType request, com.amazonaws.services.lambda.runtime.Context context) Proxies requests to the underlying container given the incoming Lambda request.
void	stripBasePath(java.lang.String basePath) Configures the library to strip a base path from incoming requests before passing them on to the wrapped framework.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERVER_INFO

public static final java.lang.String SERVER_INFO

See Also:

Constant Field Values

lambdaContext

protected com.amazonaws.services.lambda.runtime.Context lambdaContext

Constructor Detail

LambdaContainerHandler

protected LambdaContainerHandler(RequestReader<RequestType,ContainerRequestType> requestReader,
                                 ResponseWriter<ContainerResponseType,ResponseType> responseWriter,
                                 SecurityContextWriter<RequestType> securityContextWriter,
                                 ExceptionHandler<ResponseType> exceptionHandler)

Method Detail

getContainerResponse

protected abstract ContainerResponseType getContainerResponse(ContainerRequestType request,
                                                              java.util.concurrent.CountDownLatch latch)

handleRequest

protected abstract void handleRequest(ContainerRequestType containerRequest,
                                      ContainerResponseType containerResponse,
                                      com.amazonaws.services.lambda.runtime.Context lambdaContext)
                               throws java.lang.Exception

Throws:

java.lang.Exception

stripBasePath

public void stripBasePath(java.lang.String basePath)

Configures the library to strip a base path from incoming requests before passing them on to the wrapped framework. This was added in response to issue #34 (https://github.com/awslabs/aws-serverless-java-container/issues/34). When creating a base path mapping for custom domain names in API Gateway we want to be able to strip the base path from the request - the underlying service may not recognize this path.

Parameters:

basePath - The base path to be stripped from the request

proxy

public ResponseType proxy(RequestType request,
                          com.amazonaws.services.lambda.runtime.Context context)

Proxies requests to the underlying container given the incoming Lambda request. This method returns a populated return object for the Lambda function.

Parameters:

request - The incoming Lambda request

context - The execution context for the Lambda function

Returns:

A valid response type

getContainerConfig

public static ContainerConfig getContainerConfig()

Returns the current container configuration object.

Returns:

The container configuration object