npm 包 aws-lambda-middlewares 使用教程

阅读时长 6 分钟读完

在 AWS Lambda 开发中,使用中间件可以更方便地处理请求和响应。aws-lambda-middlewares 是一个优秀的 Lambda 中间件库,它提供了多种可以用于 Lambda 函数的中间件,包括错误处理、日志记录、参数验证、跨域资源共享等等。在本篇文章中,我们将详细介绍如何使用这个 npm 包来实现 Lambda 函数中间件的使用。

安装

在使用时,我们首先需要安装 aws-lambda-middlewares 。安装过程可以通过以下命令完成:

引入

aws-lambda-middlewares 的中间件需要按照一个设置完成,在使用之前,我们需要先引入它:

上面的代码同时引入了三个常用的中间件,其中:

  • errorHandler 中间件处理错误,可以帮助我们更好地处理异常和错误。
  • jsonBodyParser 中间件用于解析 POST 请求的 JSON 数据。
  • cors 中间件解决跨域请求问题。

使用

在引入中间件之后,我们需要通过 middy() 方法创建一个 middleware 实例:

中间件包装的函数就是 handler() ,这个函数是 AWS Lambda 执行的主函数,可以直接进行业务逻辑的编写。中间件则会在该函数前后执行,对执行结果进行包装。

使用中间件很简单,只需要将实例化的中间件以数组方式传递给 middy() 即可:

-- -------------------- ---- -------
----- ------- - ------------- -------- --------- -- -
    -- ---- ---- ---- ----
---

-------------
    -----------------
    -------
    ---------------
---

中间件按照传递的顺序执行,也就是说,以上代码会先执行 jsonBodyParser() ,再执行 cors() ,最后执行 errorHandler() 。当然,你也可以针对不同的函数使用不同的中间件。

下面,我们来介绍一些常用的中间件及其使用方法。

errorLogger

这个中间件可以把 Lambda 函数发生的错误信息记录下来,供后续排查问题使用:

validator

这个中间件用于参数验证,它会根据传入的配置对参数进行检查,并在参数不符合要求时抛出错误:

-- -------------------- ---- -------
----- - --------- - - -----------------------------

-----------------------
    ------------ -
        ----- ---------
        ----------- -
            ----- - ----- --------- ---------- - --
            ---- - ----- --------- -------- -- --
        --
        --------- -------- -------
    --
----

上述配置中,定义了一个检查对象必须包含 name 和 age 两个属性,name 必须是字符串并且长度不能小于 2,age 必须是数字并且不能小于 18。

doNotWaitForEmptyEventLoop

这个中间件可以避免在处理完请求后等待事件循环被清空。这在一些特殊场景下可能会带来额外的性能开销:

httpHeaderNormalizer

这个中间件用于对 HTTP 头进行规范化处理,以便更好地适应不同的客户端:

通过以上中间件的使用,我们可以更加方便地处理 Lambda 函数请求和响应,提高应用的可维护性和开发效率。

示例代码

下面是一个使用了 validator 中间件的示例代码:

-- -------------------- ---- -------
----- ----- - -----------------
----- - --------- - - -----------------------------

----- ------- - ------------- -------- --------- -- -
    ----- ---- - ----------------
    ----- --- - ---------------

    -------------- -
        ----------- ----
        ----- ---------------- -------- ------ -------- ---- --- -- -------- ---
    ---
---

-----------------------
    ------------ -
        ----- ---------
        ----------- -
            ----- - ----- --------- ---------- - --
            ---- - ----- --------- -------- -- --
        --
        --------- -------- -------
    --
----

-------------- - - ------- --

在上面的代码中,validator 中间件规定了请求中必须包含 name 和 age 两个属性,并且这两个属性的值都必须符合一定的规则。当使用者传入的参数与规定不符时,validator 会抛出错误,避免了开发者在处理请求时频繁手动校验参数,提高了代码的可读性和可维护性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005601281e8991b448de0e2

纠错
反馈