AWS Lambda 入口类

在 AWS Lambda 中，入口类（也叫 Handler）是 Lambda 函数的核心部分，它定义了 AWS Lambda 如何接收和处理事件。

具体来说，入口类是你应用的“门口”，AWS Lambda 会在事件发生时调用这个类，并通过它来执行你的代码逻辑。

Lambda 入口类的作用

当你将 Spring Boot 应用部署到 AWS Lambda 时，Lambda 环境并不像传统的服务器那样有一个持续运行的应用上下文（例如 Tomcat 服务器）。因此，AWS 需要一个明确的入口点来启动你的 Spring Boot 应用，并处理传入的事件。这个入口类的主要作用就是：

1. 初始化 Spring Boot 应用：当 Lambda 函数被触发时，入口类负责启动并初始化整个 Spring Boot 应用。
2. 处理请求：入口类接收来自 API Gateway 的 HTTP 请求，将其转换为 Spring MVC 或 Spring Boot 能理解的格式，然后将请求转交给 Spring Boot 的处理逻辑。
3. 返回响应：入口类处理完请求后，将结果返回给 AWS Lambda，Lambda 再将响应结果返回给调用方（比如 API Gateway）。

入口类的流程

以我们前面提到的 StreamLambdaHandler 类为例，流程如下：

1. 事件触发 Lambda：

   • 当某个 HTTP 请求通过 API Gateway 到达 AWS Lambda 时，Lambda 会调用你定义的入口类（在这个例子中是 StreamLambdaHandler），并传递事件数据和上下文信息。

2. 初始化 Spring Boot 应用：

   handler = SpringBootLambdaContainerHandler.getAwsProxyHandler(MySpringBootApplication.class);
   

   这段代码会初始化 Spring Boot 应用，类似于启动一个 Web 容器的过程。MySpringBootApplication.class 是你的 Spring Boot 应用的主类，它会加载所有的 Spring Bean、Controller 等。

3. 处理请求：

   handler.proxyStream(inputStream, outputStream, context);
   

   这个方法将 AWS Lambda 接收到的请求转换为 Spring Boot 能处理的 HttpServletRequest，然后交给 Spring MVC 来处理。在你的应用中，Spring 的 @Controller 或 @RestController 会处理这个请求。

4. 返回响应：
   Spring Boot 应用处理完请求后，入口类会将 Spring 的响应结果（如 JSON 数据、HTTP 状态码等）通过 outputStream 返回给 AWS Lambda。

5. AWS Lambda 返回结果：
   最后，AWS Lambda 将入口类处理的结果返回给调用方（比如 API Gateway）。如果这是一个 HTTP 请求，调用方会收到 HTTP 响应。

完整代码

import com.amazonaws.serverless.exceptions.ContainerInitializationException;
import com.amazonaws.serverless.proxy.model.AwsProxyRequest;
import com.amazonaws.serverless.proxy.model.AwsProxyResponse;
import com.amazonaws.serverless.proxy.spring.SpringBootLambdaContainerHandler;
import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestStreamHandler;
import java.io.InputStream;
import java.io.OutputStream;

public class StreamLambdaHandler implements RequestStreamHandler {
    private static SpringBootLambdaContainerHandler<AwsProxyRequest, AwsProxyResponse> handler;

    static {
        try {
            handler = SpringBootLambdaContainerHandler.getAwsProxyHandler(MySpringBootApplication.class);
        } catch (ContainerInitializationException e) {
            e.printStackTrace();
            throw new RuntimeException("Could not initialize Spring Boot application", e);
        }
    }

    @Override
    public void handleRequest(InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
        handler.proxyStream(inputStream, outputStream, context);
    }
}

入口类的关键点

• RequestStreamHandler 接口：StreamLambdaHandler 实现了 RequestStreamHandler 接口，AWS Lambda 会调用该接口的 handleRequest 方法。这个方法定义了如何从 Lambda 的输入流中读取事件，如何处理事件，并将结果写入输出流。

• SpringBootLambdaContainerHandler：这个类是 AWS Serverless Java Container 提供的一个工具类，专门用于在 Lambda 上运行 Spring Boot 应用。它负责将 AWS Lambda 事件和 Spring Boot 的请求/响应进行映射和转换。

为什么需要入口类

传统的 Spring Boot 应用通常会依赖一个长期运行的服务器（如 Tomcat、Jetty），它会一直监听请求并保持应用上下文活跃。而在无服务器架构（如 AWS Lambda）中，应用只会在特定的事件触发时启动并执行，执行完毕后会立即终止。因此，需要一个明确的入口类来管理应用的启动、请求处理和响应返回。

总结：
入口类是 AWS Lambda 的核心，它将 Lambda 的事件（如 HTTP 请求）转换为 Spring Boot 应用可以理解的格式，启动并执行 Spring Boot 应用，最终返回响应结果。