在 AWS Lambda 开发中,使用中间件可以更方便地处理请求和响应。aws-lambda-middlewares 是一个优秀的 Lambda 中间件库,它提供了多种可以用于 Lambda 函数的中间件,包括错误处理、日志记录、参数验证、跨域资源共享等等。在本篇文章中,我们将详细介绍如何使用这个 npm 包来实现 Lambda 函数中间件的使用。
安装
在使用时,我们首先需要安装 aws-lambda-middlewares 。安装过程可以通过以下命令完成:
npm install --save aws-lambda-middlewares
引入
aws-lambda-middlewares 的中间件需要按照一个设置完成,在使用之前,我们需要先引入它:
const middy = require('middy'); const { errorHandler, jsonBodyParser, cors } = require('middy/middlewares');
上面的代码同时引入了三个常用的中间件,其中:
- errorHandler 中间件处理错误,可以帮助我们更好地处理异常和错误。
- jsonBodyParser 中间件用于解析 POST 请求的 JSON 数据。
- cors 中间件解决跨域请求问题。
使用
在引入中间件之后,我们需要通过 middy() 方法创建一个 middleware 实例:
const handler = middy((event, context, callback) => { // your code goes here });
中间件包装的函数就是 handler() ,这个函数是 AWS Lambda 执行的主函数,可以直接进行业务逻辑的编写。中间件则会在该函数前后执行,对执行结果进行包装。
使用中间件很简单,只需要将实例化的中间件以数组方式传递给 middy() 即可:
-- -------------------- ---- ------- ----- ------- - ------------- -------- --------- -- - -- ---- ---- ---- ---- --- ------------- ----------------- ------- --------------- ---
中间件按照传递的顺序执行,也就是说,以上代码会先执行 jsonBodyParser() ,再执行 cors() ,最后执行 errorHandler() 。当然,你也可以针对不同的函数使用不同的中间件。
下面,我们来介绍一些常用的中间件及其使用方法。
errorLogger
这个中间件可以把 Lambda 函数发生的错误信息记录下来,供后续排查问题使用:
const { errorLogger } = require('middy/middlewares'); handler.use(errorLogger());
validator
这个中间件用于参数验证,它会根据传入的配置对参数进行检查,并在参数不符合要求时抛出错误:
-- -------------------- ---- ------- ----- - --------- - - ----------------------------- ----------------------- ------------ - ----- --------- ----------- - ----- - ----- --------- ---------- - -- ---- - ----- --------- -------- -- -- -- --------- -------- ------- -- ----
上述配置中,定义了一个检查对象必须包含 name 和 age 两个属性,name 必须是字符串并且长度不能小于 2,age 必须是数字并且不能小于 18。
doNotWaitForEmptyEventLoop
这个中间件可以避免在处理完请求后等待事件循环被清空。这在一些特殊场景下可能会带来额外的性能开销:
const { doNotWaitForEmptyEventLoop } = require('middy/middlewares'); handler.use(doNotWaitForEmptyEventLoop());
httpHeaderNormalizer
这个中间件用于对 HTTP 头进行规范化处理,以便更好地适应不同的客户端:
const { httpHeaderNormalizer } = require('middy/middlewares'); handler.use(httpHeaderNormalizer());
通过以上中间件的使用,我们可以更加方便地处理 Lambda 函数请求和响应,提高应用的可维护性和开发效率。
示例代码
下面是一个使用了 validator 中间件的示例代码:
-- -------------------- ---- ------- ----- ----- - ----------------- ----- - --------- - - ----------------------------- ----- ------- - ------------- -------- --------- -- - ----- ---- - ---------------- ----- --- - --------------- -------------- - ----------- ---- ----- ---------------- -------- ------ -------- ---- --- -- -------- --- --- --- ----------------------- ------------ - ----- --------- ----------- - ----- - ----- --------- ---------- - -- ---- - ----- --------- -------- -- -- -- --------- -------- ------- -- ---- -------------- - - ------- --
在上面的代码中,validator 中间件规定了请求中必须包含 name 和 age 两个属性,并且这两个属性的值都必须符合一定的规则。当使用者传入的参数与规定不符时,validator 会抛出错误,避免了开发者在处理请求时频繁手动校验参数,提高了代码的可读性和可维护性。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005601281e8991b448de0e2