Hub构成了 Eventlet 的事件循环,它分发 I/O 事件、调度 greenthread。Hub的存在使得协程被提升为 greenthreads。
Eventlet 有多种hub的实现,所以在使用之前应该选择最适合自己系统的实现:
- epolls
- 要求 Python 2.6 或 python-epoll 包,同时只支持 Linux。这是最快的纯Python hub。
- poll
- 所有支持它的平台均可。
- selects
- 哪都能用。
- pyevent
- 基于libevent的后端,最快!默认是不被支持的,因为它不支持原生线程,但是你可以开启pyevent。
- 如果你所选的hub不是理想的那个,可以切换成其他的hub。既可以通过环境变量 EVENTLET_HUB,又可以通过调用 use_hub() 实现。
- eventlet.hubs.use_hub(hub=None)
- 决定使用哪一个hub,使用目标hub模块的名称来调用该函数。应该在应用开始任何I/O前开始调用该函数。调用该函数将会清除任何旧的 hub,以及其管理的任何文件描述符和定时器,通常把这个函数放在主模块的第一行调用:
""" This is the main module """
from eventlet import hubs
hubs.use_hub("pyevent")
Hubs的实现是线程内的,eventlet.hubs.use_hub() 只在当前线程内起作用。当使用多线程且这些线程都有自己的 hub 时,需要在每个需要特定 hub 的线程函数前调用该函数。实际上不一定需要为每个线程指定一个hub,可以为主线程指定一个特定的hub,而让其他的线程使用默认的 hub。这种混合的配置方式也能正常工作。
也可以使用第三方的 hub 模块来取代内置的,只要将木块本身传给 eventlet.hubs.use_hub() 即可。比如:
from eventlet import hubs
from mypackage import myhub
hubs.use_hub(myhub)
Hub是怎么工作的
hub 有一个主 greenlet,MAINLOOP。当运行中的协程需要进行 I/O 操作时,它会在 hub 中注册一个 listener(这样hub就知道什么时候唤醒它),然后切换到 MAINLOOP (通过 get_hub().switch())。如果有其他准备运行的协程, MAINLOOP 会切换到他们,当他们完成执行或需要 I/O 时,又会将控制权切换给 MAINLOOP。以这样的方式,MAINLOOP 确保了每一个协程在自己有事要完成的时候都能够得到调度。
MAINLOOP 只在第一次I/O发生时执行,而且它不是 __main__ 所运行在的那个 greenlet。这种延迟运行的方式解释了为什么不需要显式地调用 dispatch() 方法,也就是说代码不需要重构就可以开始使用 Eventlet。
更多Hub相关函数
- eventlet.hubs.get_hub()
- 获得当前的event hub对象。
- 注:
- 这被认为是一个内部API,因此可能会未经弃用就发生意外的改变。
- eventlet.hubs.get_default_hub()
- Select the default hub implementation based on what multiplexing libraries are installed. The order that the hubs are tried is:
- 自动选择默认的 hub 实现,尝试的顺序是:epoll、kqueue、poll、select,这里不会自动选择 pyevent hub,因为它不是Python线程安全的。
- 注:
- 这被认为是一个内部API,因此可能会未经弃用就发生意外的改变。
eventlet.hubs.trampoline(fd, read=None, write=None, timeout=None, timeout_exc=<class 'eventlet.timeout.Timeout'>,mark_as_closed=None)
- 暂停当前的协程直到给定的套接字或文件描述字准备好了 read或 write 或 指定的 timeout 已经过去。要等待 fd 准备好读就传入 read =True,要等待 fd 准备好写就传入 write =True;要指定一个超时限制,就传入参数timeout(秒)。
- 如果在套接字准备好读或写之前超时限制达到,会抛出 timeout_exc 异常而不是正常返回。
- 注:
- 这被认为是一个内部API,因此可能会未经弃用就发生意外的改变。