HttpServer集成了几个常用的事件,方便我们对webapi进行一些常规的扩展。
序列 | 事件名 | 说明 | 示例 |
1 | Authentication | 权限认证,可以指定针对的webapi可以进行用户权限验证,有权的继续,没有权限的可以自定义返回内容。该事件需要返回一个逻辑类型,表示用户权限验证是否通过,如果通过则返回true,如果不通过则返回false,返回false的话,后面的webapi则不会执行。 |
Section Jwt 自定义Token |
2 | Middleware | 中间件,此事件只在webapi执行之前执行,我们可以在这里处理一些前置动作,比如记录一些访问日志,由谁在什么时间点使用什么IP访问了哪个webapi。或者做一些IP访问的控制,比如设置一些IP白名单,只有指定IP可以访问我们的webapi,或者设置指定IP一分钟之内只能访问api多少次,超过即忽略掉,可以过滤掉一些不必要的网络攻击。 |
日志记录 IP白名单 控制IP访问频率 |
3 | ExceptionHandle | 异常处理,当我们的webapi出现错误时该如何处理。比如我们可以记录一下日志信息,并返回一些信息给客户端。 |
事件的添加很简单,只需要在HttpServer事件管理模块中添加几个路径以事件名称命名的项目即可。
注意事项:
1、路径必须严格的以事件名称命名。
2、Authentication、Middleware事件必须返回一个逻辑值,指示webapi是否继续执行。这是允许我们自己管控权限。