Sanic教程：快速开始

时间  2019-11-10
标签 sanic 教程 快速 开始 繁體版
原文   原文链接

快速开始

在安装Sanic以前，让咱们一块儿来看看Python在支持异步的过程当中，都经历了哪些比较重大的更新。html

首先是Python3.4版本引入了asyncio，这让Python有了支持异步IO的标准库，然后3.5版本又提供了两个新的关键字 async/await，目的是为了更好地标识异步IO，让异步编程看起来更加友好，最后3.6版本更进一步，推出了稳定版的asyncio，从这一系列的更新能够看出，Python社区正迈着坚决且稳重的步伐向异步编程靠近。node

安装

Sanic是一个支持 async/await 语法的异步无阻塞框架，这意味着咱们能够依靠其处理异步请求的新特性来提高服务性能，若是你有Flask框架的使用经验，那么你能够迅速地使用Sanic来构建出心中想要的应用，而且性能会提高很多，我将同一服务分别用Flask和Sanic编写，再将压测的结果进行对比，发现Sanic编写的服务大概是Falsk的1.5倍。python

仅仅是Sanic的异步特性就让它的速度获得这么大的提高么？是的，但这个答案并不标准，更为关键的是Sanic使用了uvloop做为asyncio的事件循环，uvloop由Cython编写，它的出现让asyncio更快，快到什么程度？这篇文章中有介绍，其中提出速度至少比 nodejs、gevent 和其余Python异步框架要快两倍，而且性能接近于用Go编写的程序，顺便一提，Sanic的做者就是受这篇文章影响，这才有了Sanic。git

怎么样？有没有激起你学习Sanic的兴趣，若是有，就让咱们一块儿开始学习吧，在开始以前，你只须要有一台安装了Python的电脑便可。github

说明：因为Windows下暂不支持安装uvloop，故在此建议使用Mac或Linux

虚拟环境

程序世界一部分是对应着现实的，在生活中，咱们会在不一样的环境完成不一样的任务，好比在厨房作饭、卧室休息，分工极其明确。web

其实用Python编写应用服务也是如此，它们一样但愿应用服务与开发环境是一对一的关系，这样作的好处在于，每一个独立的环境均可以简洁高效地管理自身对应服务所依赖的第三方库，如若否则，各个服务都安排在同一环境，这样不只会形成管理上的麻烦，还会使第三方库之间产生冲突。shell

经过上面的叙述，咱们是否是能够得出这样一个核心观点：应该在不一样的环境下作不一样的事 ，以此类推，写项目的时候，咱们也须要为每一个不一样的项目构建一个无干扰的的环境，发散思惟，总结一下：编程

不一样的项目，须要为其构建不一样的虚拟环境，以避免互相干扰

构建虚拟环境的工具不少，以下：json

…...api

以上三个工具均可以快速地帮助咱们构建当前须要的Python环境，若是你以前没有使用过，可直接点开连接进行下载，若是你正在使用其它的环境管理工具，也没关系，由于不论你使用哪种方式，咱们最终目的都是针对一个新项目构建一个新的环境。

安装配置好以后，简单看看官方提供的使用方法，就能够开始了，好比我本机使用的是anaconda ，安装完成后能够很方便地建立一个虚拟环境，好比这里使用Python3.6来做为本书项目的默认环境：

# 新建一个python3.6环境
conda create --name python36 python=3.6
# 安装好以后 输入下面命令进入名为python36的环境
source activate python36

若安装速度比较慢，能够考虑换国内源，好比 国内镜像 ，至于为何选择python3.6做为默认环境，一是由于Sanic只支持Python3.5+，二则是咱们构建的项目最终是要在生产环境下运行的，因此建议最好安装Python3.6下稳定版本的asyncio。

安装Sanic

Python安装第三方模块都是利用pip工具进行安装，这里也不例外，首先进入上一步咱们新建的 python3.6 虚拟环境，而后安装：

# 安装Sanic，请先使用 source activate python36 进入虚拟环境
pip install sanic
# 若是不想使用uvloop和ujson 能够这样安装
SANIC_NO_UVLOOP=true SANIC_NO_UJSON=true pip install sanic

经过上面的命令，你就能够在 python3.6 虚拟环境中安装Sanic以及其依赖的第三方库了，若想查看Sanic是否已经正确安装，能够进入终端下对应的虚拟环境，启动Python解释器，导入Sanic库：

# 启动Python解释器
python
>>> import sanic
>>>

若是没有出现错误，就说明你已经正确地安装了Sanic，请继续阅读下一节，了解下如何利用Sanic来构建一个Web项目吧。

踏出第一步

咱们将正式使用Sanic来构建一个web项目，让咱们踏出第一步，利用Sanic来编写一个返回Hello World!字符串的服务程序。

新建一个文件，名为 run.py :

#!/usr/bin/env python
from sanic import Sanic
from sanic.response import text

app = Sanic()


@app.route("/")
async def test(request):
    return text('Hello World!')


if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

Sanic的目标是让编写服务更加简单易用，请看上面仅用不到10行的代码，就编写好了一个简单的Web服务，运行此文件，在浏览器输入 http://0.0.0.0:8000 ，出现的字符会让你回想起当年学c的恐惧^_^。

若是你是第一次使用Sanic，上面的代码可能会让你产生一些困扰，不用担忧，接下来，咱们将一块儿用Sanic编写一个简单的资讯阅读的web服务，在这过程当中，你将逐渐地了解到Sanic的一些基本用法，如路由的构建、接受请求数据以及返回响应的内容等。

本次示例的源代码所有在github上，见examples/demo01/news.py。

编写一个资讯阅读项目

在开始编写以前，第一步最好写一下需求，哪怕是个简单不过的玩具项目也不能略过这个步骤，好比如今编写的资讯阅读项目，需求就一个，在页面中展现一些资讯新闻。

既然是展现资讯新闻，那么解决数据来源的问题最为重要，对于这个问题你也不用担忧，由于在本次示例的源码中我编写了一个名为get_news()的函数专门用来返回资讯新闻数据，简化代码以下:

async def get_news(size=10):
    """
    Sanic是一个异步框架，为了更好的发挥它的性能，有些操做最好也要用异步的
    好比这里发起请求就必需要用异步请求框架aiohttp
    因此使用本服务的时候请先执行: pip install aiohttp
    数据使用的是readhub网站的api接口
    为了使这个数据获取函数正常运行，我会保持更新，因此具体代码：examples/demo01/news.py
    """
    async with aiohttp.ClientSession() as client:
        async with client.get(readhub_api, params=params, headers=headers) as response:
            assert response.status == 200
            text = await response.json()
        return text

这样各位就能够只专一于Sanic的代码实现，而没必要考虑其余问题，我会一直维护这个数据获取函数，以保证数据正常输出，各位请放心使用。

构建路由

数据的问题解决以后，咱们能够开始着手于需求的实现了，根据前面的描述，此时的需求是当客户端（Web浏览器）访问http://0.0.0.0:8000/的时候，浏览器会立马展现服务端响应返回的10条资讯新闻（假设内容由index()函数返回），若浏览器访问的是http://0.0.0.0:8000/2，此时返回的就是第二页的10条资讯新闻，以此类推......

当Sanic程序实例接收到一个请求，好比前面提到的http://0.0.0.0:8000/，它是怎么知道这个URL能够对应到index()函数呢？

Sanic有一个机制来保存URL和函数（通常称之为视图函数）之间的映射关系，就像dict中key和value，这样当服务端接收到请求http://0.0.0.0:8000/，就会立马知道，接下来须要调用index()函数了，咱们将其称之为路由。

Sanic中能够用app.route修饰器来定义路由，当Sanic服务启动的时候，app.route就会将其中传入的参数与装饰的函数自动注册好，好比下面这段代码：

@app.route("/")
async def index(request):
    """当服务端接收到客户端的/请求时，就会调用此函数"""
    return text('Hello World!')

此时请求http://0.0.0.0:8000/就会返回Hello World!，很显然，这不是咱们想要的需求，咱们的需求是展现10条资讯新闻，数据怎么来？你只须要调用get_news()函数，就会获取到你想要的资讯数据：

@app.route("/")
async def index(request):
    # html页面模板
    html_tem = """
    <div style="width: 80%; margin-left: 10%">
        <p><a href="{href}" target="_blank">{title}</a></p>
        <p>{summary}</p>
         <p>{updated_at}</p>
    </div>
    """
    html_list = []
    # 获取数据
    all_news = await get_news()
    # 生成在浏览器展现的html页面
    for each_news in all_news:
        html_list.append(html_tem.format(
            href=each_news.get('news_info', [{}])[0].get('url', '#'),
            title=each_news.get('title'),
            summary=each_news.get('summary'),
            updated_at=each_news.get('updated_at'),
        ))

    return html('<hr>'.join(html_list))

运行此服务：

python run news.py

此时，访问http://0.0.0.0:8000/，你就会得到Sanic服务程序返回的资讯新闻，以下图，能够看到返回服务端提供的最新资讯：

图片描述

页面成功地呈现出咱们想要的结果，实在是使人兴奋，等等，不能高兴太早，咱们还有一个需求，要根据浏览器输入的页数来展现内容，如：http://0.0.0.0:8000/2，思考一下，应该怎样优雅地完成这个需求，或许你会想，再构建一对URL与视图函数的映射关系，像下面这样：

@app.route("/2")
async def page_2(request):

不得不说，这是一个糟糕的解决方案，这样无法解决接下来的第3页、第4页、甚至第n页（虽然目前这个服务程序只展现到第2页），最佳实践应该是把页数当作变量来获取，Sanic的路由机制天然提供了获取动态请求参数的功能，以下：

@app.route("/<page:int>")
@app.route("/")
async def index(request, page=1):
    """
    支持/请求与/page请求方式
    具体的代码逻辑也会有一点改变，可参考：examples/demo01/news.py
    """

再次运行此服务：

python run news.py

不管是请求http://0.0.0.0:8000/或者http://0.0.0.0:8000/2，都是咱们想要的结果。

请求数据

细心的你可能会发现，每次编写一个视图函数的时候，老是有一个request参数：

async def index(request, page=1):

为何必须定义这个参数，它从哪来？它有什么做用，下面我将一一为你解答。

若是你在客户端请求http://0.0.0.0:8000/的时候，顺手在视图函数里面打印下参数request，会有以下输出：

<Request: GET />

看终端的输出能够了解到request参数其实是一个名为Request的实例对象，每当服务端接收到一个请求，Sanic的handle_request函数一定会接收一个Request实例对象，这个实例对象包含了一系列请求信息。

前面说到，每一个URL对应一个视图函数，而Sanic的handle_request接下来会将接收的Request实例对象做为参数传给URL对应的视图函数，也就是上面index的request参数，这样一来，就必须定义request来接收Request实例对象，其中包含的一些请求信息对视图函数来讲很是重要，目前Request对象提供了如下属性：

  • json
  • token
  • form
  • files
  • args
  • raw_args
  • cookies
  • ip
  • port
  • socket
  • remote_addr
  • path
  • url

上面只是列出了一部分属性，若是你想了解更多，可查看request.py源码文件了解。

为了能够实际使用下request，咱们能够再加一个需求，好比增长一个GET请求的接口http://0.0.0.0:8000/json，若是请求不设置参数nums的值，则默认返回一条资讯新闻，若是设置了nums参数，则该接口返回的新闻数量由参数值决定，参数最大值为10：

@app.route('/json')
async def index_json(request):
    """
    默认返回一条资讯，最多十条
    """
    nums = request.args.get('nums', 1)
    # 获取数据
    all_news = await get_news()
    try:
        return json(random.sample(all_news, int(nums)))
    except ValueError:
        return json(all_news)

运行此服务：

python run news.py

此时视图函数index_json就能够根据接受的参数nums来返回对应数量的新闻，访问http://0.0.0.0:8000/json?nums=2，效果以下：

图片描述

响应

不论哪一个Web框架，都是须要构建响应对象的，Sanic天然也不例外，它用的是sanic.response来构建响应对象，像上面的代码中能够看到：

from sanic.response import html, json

这表示咱们目前构建的资讯阅读服务，分别返回了body格式为html以及json的响应对象，除了这两种格式，Sanic还提供了下面几种格式：

  • json
  • text
  • raw
  • html
  • file
  • file_stream
  • stream

更多属性请看response.py，咱们能够根据实际需求来构建响应对象，最后再返回给客户端。

继续深刻

不要觉得如今编写的资讯服务已经很完善了，其实还有许多问题须要咱们解决，好比访问http://0.0.0.0:8000/html这个URL会返回：

Error: Requested URL /html not found

服务程序为何会抛出这个错误？由于程序中并路由没有注册html，而且没有进行错误捕捉（好比此时的404），解决这个问题也很方便，好比把这个错误所有跳转到首页，代码以下：

@app.exception(NotFound)
def ignore_404s(request, exception):
    return redirect('/')

此时访问一些没有注册于路由的URL，好比此时的http://0.0.0.0:8000/html都会自动跳转到http://0.0.0.0:8000/。

如今，咱们已经用Sanic编写了一个简单的资讯阅读服务，在编写的过程当中使用了路由、数据请求、处理以及响应对象，这些基础知识足够你编写一些基本的服务，但这还远远不够，好比模板引、引入静态文件等，这些都等着咱们在实践中继续深刻了解。

总结

本章介绍了Sanic的安装以及基本的使用，目标是但愿诸位能够迅速的了解并掌握Sanic的基本使用方法，并为阅读接下来的章节打一下基础。

文档以及代码：

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程