Version: 2.0.0rc4

事件处理

在我们收到事件,并被某个事件响应器正确响应后,便正式开启了对于这个事件的处理流程

认识事件处理流程

就像我们在解决问题时需要遵循流程一样,处理一个事件也需要一套流程。在事件响应器对一个事件进行响应之后,会依次执行一系列的事件处理依赖(通常是函数)。简单来说,事件处理流程并不是一个函数、一个对象或一个方法,而是一整套由开发者设计的流程。

在这个流程中,我们目前只需要了解两个概念:函数形式的“事件处理依赖”(下称“事件处理函数”)和“事件响应器操作”。

事件处理函数

在事件响应器中,事件处理流程可以由一个或多个“事件处理函数”组成,这些事件处理函数将会按照顺序依次对事件进行处理,直到全部执行完成或被中断。我们可以采用事件响应器的“事件处理函数装饰器”来添加这些“事件处理函数”。

顾名思义,“事件处理函数装饰器”是一个装饰器(decorator),那么它的使用方法也同函数定义中所展示的包装用法相同。例如:

weather/__init__.py
from nonebot.rule import to_me
from nonebot.plugin import on_command

weather = on_command("天气", rule=to_me(), aliases={"weather", "查天气"}, priority=10, block=True)

@weather.handle()
async def handle_function():
pass # do something here

如上方示例所示,我们使用 weather 响应器的 handle 装饰器装饰了一个函数 handle_functionhandle_function 函数会被添加到 weather 的事件处理流程中。在 weather 响应器被触发之后,将会依次调用 weather 响应器的事件处理函数,即 handle_function 来对事件进行处理。

事件响应器操作

在事件处理流程中,我们可以使用事件响应器操作来进行一些交互或改变事件处理流程,例如向机器人用户发送消息或提前结束事件处理流程等。

事件响应器操作与事件处理函数装饰器类似,通常作为事件响应器 Matcher类方法存在,因此事件响应器操作的调用方法也是 Matcher.func() 的形式。不过不同的是,事件响应器操作并不是装饰器,因此并不需要@进行标注。

weather/__init__.py
from nonebot.plugin import on_command

weather = on_command("天气", rule=to_me(), aliases={"weather", "查天气"}, priority=10, block=True)

@weather.handle()
async def handle_function():
# await weather.send("天气是...")
await weather.finish("天气是...")

如上方示例所示,我们使用 weather 响应器的 finish 操作方法向机器人用户回复了 天气是... 并结束了事件处理流程。效果如下:

NoneBot
/天气
NoneBotNoneBot
天气是...

值得注意的是,在执行 finish 方法时,NoneBot 会在向机器人用户发送消息内容后抛出 FinishedException 异常来结束事件响应流程。也就是说,在 finish 被执行后,后续的程序是不会被执行的。如果你需要回复机器人用户消息但不想事件处理流程结束,可以使用注释的部分中展示的 send 方法。

警告

由于 finish 是通过抛出 FinishedException 异常来结束事件的,因此异常可能会被未加限制的 try-except 捕获,影响事件处理流程正确处理,导致无法正常结束此事件。请务必在异常捕获中指定错误类型或排除所有 MatcherException 类型的异常(如下所示),或将 finish 移出捕获范围进行使用。

from nonebot.exception import MatcherException

try:
await weather.finish("天气是...")
except MatcherException:
raise
except Exception as e:
pass # do something here

目前 NoneBot 提供了多种事件响应器操作,其中包括用于机器人用户交互与流程控制两大类,进阶使用方法可以查看会话控制