简介
koa-joi-bouncer是一个基于Joi校验库的Koa2验证中间件，能够根据用户定义的schema自动过滤、拦截和报错处理，实现了输入的自动校验和输出的自动清洗，是Koa2应用程序常常使用的一个NPM包。本文将详细介绍koa-joi-bouncer的使用方法并提供示例代码。
安装
在使用koa-joi-bouncer前，请确保你使用了Node.js v7.6.0或更高版本，并在命令行窗口输入以下命令进行安装：
npm install koa-joi-bouncer
安装完成后，就可以在代码中使用koa-joi-bouncer。
使用
使用koa-joi-bouncer中间件非常简单，只需在Koa应用程序中导入koa-joi-bouncer，并在需要校验请求参数的路由中使用它即可。
-- -------------------- ---- -------
----- --- - ---------------
----- ------ - ----------------------
----- ---------- - --------------------------
----- ------- - ---------------------------
----- --- - --- ------
----- ------ - --- ---------
--------------------- ------------- --------------------
----- -
------ --------------------------------
--------- ------------------------------
--
--- ----- ----- -- -
-------- - - -------- ------ --
---
-------------------------
---------------- -- -- -
------------------- ------- -- ---- -------
---上面的示例代码中使用了koa-bodyparser来解析请求体参数，并使用koa-joi-bouncer中间件校验了email和password参数。如果校验失败，koa-joi-bouncer会返回一个JSON格式的错误信息，包含不合法参数的具体字段和原因。
除了校验请求体中的参数，koa-joi-bouncer也支持校验url中的query参数和header中的参数。下面是一个校验query参数的示例代码：
-- -------------------- ---- -------
----- --- - ---------------
----- ------ - ----------------------
----- ------- - ---------------------------
----- --- - --- ------
----- ------ - --- ---------
-------------------- --------------------
------ -
------- --------------------------- --------------------------
------ --------------------------------------------------
------- -----------------------------------------
--
--- ----- ----- -- -
-- --------
---
-------------------------
---------------- -- -- -
------------------- ------- -- ---- -------
---在上面的示例代码中，koa-joi-bouncer会校验query参数sortBy、limit和offset是否符合Joi定义的schema，并使用Joi的default方法给它们设置默认值。如果查询参数不符合schema定义，koa-joi-bouncer会返回一个JSON格式的错误信息。
钩子函数
koa-joi-bouncer中间件还提供了三个钩子函数，分别是before、after和cleanup。before函数在校验之前触发，可以用来处理请求的初始状态。after函数在校验之后触发，可以用来处理校验通过后的请求结果。cleanup函数在请求结束后触发，可以用来清理请求中的临时状态。
-- -------------------- ---- -------
--------------------
----- -
----- ---------------------------------------
---- --------------------------------------------------
--
----------- ------- -
-------------------
------------------------------ -- - ----- ----- ---- -- -
--
------------- ---- ------- -
-------------------
-------------------- -- - ----- ----- ---- -- -
-------------------- -- ------------ ----- ---- ---- --- --
--
------------ -
------------------
--
--总结
koa-joi-bouncer是一个非常方便的koa2验证中间件，可以根据schema自动校验请求参数并返回错误信息，也可以在校验前、校验后和请求完成时触发相应的钩子函数。使用koa-joi-bouncer能够节省开发者的很多时间，并提高应用的健壮性。感谢您阅读本教程，希望本文能够对您有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005541581e8991b448d16e8
