首页 > 代码库 > Python——eventlet.hubs

Python——eventlet.hubs

 

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 hubshubs.use_hub("pyevent")

  Hubs的实现是线程内的,eventlet.hubs.use_hub() 只在当前线程内起作用。当使用多线程且这些线程都有自己的 hub 时,需要在每个需要特定 hub 的线程函数前调用该函数。实际上不一定需要为每个线程指定一个hub,可以为主线程指定一个特定的hub,而让其他的线程使用默认的 hub。这种混合的配置方式也能正常工作。

  也可以使用第三方的 hub 模块来取代内置的,只要将木块本身传给 eventlet.hubs.use_hub() 即可。比如:

from eventlet import hubsfrom mypackage import myhubhubs.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)
        
  暂停当前的协程直到给定的套接字或文件描述字准备好了 readwrite 或 指定的 timeout 已经过去。要等待 fd 准备好读就传入 read =True,要等待 fd 准备好写就传入 write =True;要指定一个超时限制,就传入参数timeout(秒)
  如果在套接字准备好读或写之前超时限制达到,会抛出 timeout_exc 异常而不是正常返回。
  注:
  这被认为是一个内部API,因此可能会未经弃用就发生意外的改变。

Python——eventlet.hubs