com.amazonaws.serverless.proxy

Class RequestReader<RequestType,ContainerRequestType>

java.lang.Object

com.amazonaws.serverless.proxy.RequestReader<RequestType,ContainerRequestType>

Type Parameters:

RequestType - The type for the AWS Lambda event

ContainerRequestType - The type for the undelying container request object

Direct Known Subclasses:

AwsProxyHttpServletRequestReader

public abstract class RequestReader<RequestType,ContainerRequestType>
extends java.lang.Object

Implementations of the RequestReader object are used by container objects to transform the incoming Lambda event into a request object that can be used by the underlying container. Developers can build custom implementation of this interface to support other container types as well as custom event types. This library provides a default implementation of this object that supports requests for the AWS_PROXY integration.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	API_GATEWAY_CONTEXT_PROPERTY The key for the API Gateway context property in the PropertiesDelegate object
static java.lang.String	API_GATEWAY_EVENT_PROPERTY The key to store the entire API Gateway event
static java.lang.String	API_GATEWAY_STAGE_VARS_PROPERTY The key for the API Gateway stage variables property in the PropertiesDelegate object
static java.lang.String	JAX_SECURITY_CONTEXT_PROPERTY The key for the JAX RS security context properties stored in the request attributes
static java.lang.String	LAMBDA_CONTEXT_PROPERTY The key for the AWS Lambda context property in the PropertiesDelegate object

Constructor Summary

Constructors

Constructor and Description
RequestReader()

Method Summary

Modifier and Type	Method and Description
protected abstract java.lang.Class<? extends RequestType>	getRequestClass()
abstract ContainerRequestType	readRequest(RequestType request, javax.ws.rs.core.SecurityContext securityContext, com.amazonaws.services.lambda.runtime.Context lambdaContext, ContainerConfig config) Reads the incoming event object and produces a populated request for the underlying container
protected java.lang.String	stripBasePath(java.lang.String requestPath, ContainerConfig config) Strips the base path from the request path if the container configuration object requires it

Methods inherited from class java.lang.Object

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

Field Detail

API_GATEWAY_CONTEXT_PROPERTY

public static final java.lang.String API_GATEWAY_CONTEXT_PROPERTY

The key for the API Gateway context property in the PropertiesDelegate object

See Also:

Constant Field Values

API_GATEWAY_STAGE_VARS_PROPERTY

public static final java.lang.String API_GATEWAY_STAGE_VARS_PROPERTY

The key for the API Gateway stage variables property in the PropertiesDelegate object

See Also:

Constant Field Values

API_GATEWAY_EVENT_PROPERTY

public static final java.lang.String API_GATEWAY_EVENT_PROPERTY

The key to store the entire API Gateway event

See Also:

Constant Field Values

LAMBDA_CONTEXT_PROPERTY

public static final java.lang.String LAMBDA_CONTEXT_PROPERTY

The key for the AWS Lambda context property in the PropertiesDelegate object

See Also:

Constant Field Values

JAX_SECURITY_CONTEXT_PROPERTY

public static final java.lang.String JAX_SECURITY_CONTEXT_PROPERTY

The key for the JAX RS security context properties stored in the request attributes

See Also:

Constant Field Values

Constructor Detail

RequestReader

public RequestReader()

Method Detail

readRequest

public abstract ContainerRequestType readRequest(RequestType request,
                                                 javax.ws.rs.core.SecurityContext securityContext,
                                                 com.amazonaws.services.lambda.runtime.Context lambdaContext,
                                                 ContainerConfig config)
                                          throws InvalidRequestEventException

Reads the incoming event object and produces a populated request for the underlying container

Parameters:

request - The incoming request object

securityContext - A jax-rs SecurityContext object (@see com.amazonaws.serverless.proxy.SecurityContextWriter)

lambdaContext - The AWS Lambda context for the request

config - The container configuration object. This is passed in by the LambdaContainerHandler.

Returns:

A valid request object for the underlying container

Throws:

InvalidRequestEventException - This exception is thrown if anything goes wrong during the creation of the request object

getRequestClass

protected abstract java.lang.Class<? extends RequestType> getRequestClass()

stripBasePath

protected java.lang.String stripBasePath(java.lang.String requestPath,
                                         ContainerConfig config)

Strips the base path from the request path if the container configuration object requires it

Parameters:

requestPath - The incoming request path

config - The container configuration object

Returns:

The final request path