Python：Tornado 第一章：异步及协程基础：第三节：协程

上一篇文章： Python：Tornado 第一章：异步及协程基础：第二节：Python关键字yield
下一篇文章： Python：Tornado 第二章：实战演练：开发Tornado网站：第一节：网站结构：HelloWorld

使用Tornado协程能够开发出相似同步代码的异步行为。同时，由于协程自己不使用线程，因此减小了线程上下文切换的开销，是一种高效的开发模式。

一、编写协程函数

实例：用协程技术开发网页访问功能

#用协程技术开发网页访问功能
from tornado import  gen #引入协程库gen
from tornado.httpclient import AsyncHTTPClient
import time

#使用gen.coroutine修饰器
@gen.coroutine
def coroutine_visit():
    http_client=AsyncHTTPClient()
    response=yield http_client.fetch("http://www.baidu.com")
    print(response.body)

本例中任然使用了异步客户端AsyncHTTPClient进行页面访问，装饰器@gen.coroutine声明这是一个协程函数，因为yield关键字的做用，使得代码中不用再编写回调函数用于处理访问结果，而能够直接在yield语句的后面编写结果处理语句。

二、调用协程函数

因为Tornado协程基于Python的yield关键字实现，因此不能像普通函数那样直接调用。
协程函数能够经过如下三张方式调用：

• 在自己是协程的函数内经过yield关键字调用。
• 在IOLoop还没有启动时，经过IOLoop的run_sync()函数调用。
• 在IOLoop已经启动时，经过IOLoop的spawn_callback()函数调用。

实例：经过协程函数调用协程函数

代码：

#用协程技术开发网页访问功能
from tornado import  gen #引入协程库gen
from tornado.httpclient import AsyncHTTPClient
import time

#使用gen.coroutine修饰器
@gen.coroutine
def coroutine_visit():
    http_client=AsyncHTTPClient()
    response=yield http_client.fetch("http://www.baidu.com")
    print(response.body)

@gen.coroutine
def outer_coroutine():
    print("start call coroutine_visit")
    yield coroutine_visit()
    print("end call coroutine_cisit")

本例中outer_coroutine()和coroutine_visit()都是协程函数，因此他们之间能够经过yield关键字调用。_

实例：IOLoo还没有启动时，经过IOLoop的run_sync()函数调用。

IOLoop是Tornado的主事件循环对象，Tornado程序经过它监听外部客户端的访问请求，并执行相应操做。

代码：

#用协程技术开发网页访问功能
from tornado import  gen #引入协程库gen
from tornado.httpclient import AsyncHTTPClient
from tornado.ioloop import IOLoop  #引入IOLoop对象

#使用gen.coroutine修饰器
@gen.coroutine
def coroutine_visit():
    http_client=AsyncHTTPClient()
    response=yield http_client.fetch("http://www.baidu.com")
    print(response.body)

def func_normal():
    print("start call coroutine_visit")
    IOLoop.current().run_sync(lambda :coroutine_visit())
    print("end call coroutine_visit")

当程序还没有进入IOLoop的running状态时，能够经过run_sync()函数调用协程函数。

⚠️注意：run_sync()函数将阻塞当前函数的调用，直到被调用的协程执行完成。

事实上，Tornado要求协程函数在IOLoop的running状态种才能被调用，只不过run_sync函数自动完成了启动、中止IOLoop的操做步骤，他的实现逻辑是：

【启动IOLoop】》【调用被lambda封装的协程函数】》【中止IOLoop】

实例：在IOLoop启动时，经过spawn_callback()函数调用

代码：

#用协程技术开发网页访问功能
from tornado import  gen #引入协程库gen
from tornado.httpclient import AsyncHTTPClient
from tornado.ioloop import IOLoop  #引入IOLoop对象

#使用gen.coroutine修饰器
@gen.coroutine
def coroutine_visit():
    http_client=AsyncHTTPClient()
    response=yield http_client.fetch("http://www.baidu.com")
    print(response.body)

def func_normal():
    print("start call coroutine_visit")
    IOLoop.current().spawn_callback(coroutine_visit)
    print("end call coroutine_visit")

spawn_callback()函数将不会等待被调用协程执行完成，全部上下两条打印语句将立刻完成，而coroutine__visit自己将会由IOLoop在合适的时机进行调用。

⚠️注意：IOLoop的spawn_callback()函数没有为开发者提供获取协程函数调用返回值的方法，因此只能用span_callback()调用没有返回值的协程函数。

三、在协程中调用阻塞函数

在协程中直接调用阻塞函数会影响协程自己的性能，因此Tornado提供了在协程中利用线程池调度阻塞函数，从而不影响协程自己继续执行的方法。

代码实例：

from concurrent.futures import ThreadPoolExecutor
from tornado import gen

#定义线程池
thread_pool=ThreadPoolExecutor(2)

def mySleep(count):
    import time
    for x in range(count):
        time.sleep(1)

@gen.coroutine
def call_blocking():
    print("start")
    yield thread_pool.submit(mySleep,10)
    print("end")

代码中首先引用了concurrent.futures种的ThreadPoolExecutor类，实例化了一个由两个线程的线程池thread_pool。在须要调用阻塞函数的协程call_blocking种，使用thread_pool.submit调用阻塞函数，并经过yield返回。这样便不会阻塞协程所在的线程的继续执行，也保证了阻塞函数先后代码的执行顺序。

四、在协程中等待多个异步调用

到目前为止，咱们知道了协程中一个yield关键字等待一个异步调用的编程方法。其实，Tornado容许在协程中用一个yield关键字等待多个异步调用，只须要把这些调用以列表(list)或字典(dictionary)的方式传递给yield关键字便可。

实例：使用列表方式传递多个异步调用

#使用列表方式传递多个异步调用
from tornado import gen  #引入协程库gen
from tornado.httpclient import AsyncHTTPClient

@gen.coroutine   #使用gen.coroutine修饰器
def coroutine_visit():
    http_client=AsyncHTTPClient()
    list_response=yield [
        http_client.fetch("http://www.baidu.com"),
        http_client.fetch("http://www.api.jiutouxiang.com")
    ]
    for response in list_response:
        print(response.body)

在代码中仍然使用@gen.coroutine装饰器定义协程，在须要yield的地方用列表传递若干个异步调用，只有在列表种的全部调用都执行完成后，yield才会返回而且继续执行。yield以列表方式返回调用结果。

实例：用字典方式传递多个异步调用：

#使用列表方式传递多个异步调用
from tornado import gen  #引入协程库gen
from tornado.httpclient import AsyncHTTPClient

@gen.coroutine   #使用gen.coroutine修饰器
def coroutine_visit():
    http_client=AsyncHTTPClient()
    dict_response=yield {
       "baidu": http_client.fetch("http://www.baidu.com"),
        "9siliao":http_client.fetch("http://www.api.jiutouxiang.com")
    }
    print(dict_response["baidu"].body)