Sanic-异常与中间件

Sanic是一个类似Flask的Python 3.5+ Web服务器，它的写入速度非常快。除了Flask之外，Sanic还支持异步请求处理程序。这意味着你可以使用Python 3.5中新的闪亮的异步/等待语法，使你的代码非阻塞和快速。

前言：Sanic最低支持Python 3.5，如果需要学习Sanic，请先下载版本不低于3.5的Python包

异常

异常可以从请求处理程序中抛出，并由Sanic自动处理。异常将消息作为第一个参数，并且还可以将状态码传回HTTP响应中。

• 抛出异常：手动产生异常的方式，有过Python基础的都知道，可以使用raise来产生一个异常：

from sanic.exceptions import ServerError
from sanic.response import text

@app.route("/get_exception")
async def get_exception(request):
    raise ServerError("it is error",status_code=500)

你也可以使用abort：

from sanic.exceptions import abort
from sanic.response import text

@app.route("/get_exception")
async def get_exception(request):
    abort(402)
    text("ok")

• 处理异常：有时我们需要对一些特殊异常做特殊处理，此时我们可以用到@app.exception装饰器，然后在定义一个异常函数来进行处理。异常装饰器处理函数必须以一个Request和Exception对象作为参数：

from sanic.response import text
from sanic.exceptions import NotFound

@app.exception(NotFound)
async def not_found_exception(request,exception):
    return text("not found=>{}".format(request.url))

中间件

中间件是服务器在请求之前或之后执行的功能，他们可以用来修改修改用户定义处理函数的请求或相应。Sanic提供两种类型的中间件：请求和响应。两者都是使用@app.middleware装饰器声明，两个装饰器分别需要传入一个代表其类型的参数：request和response，下面举一个简单的栗子：

from sanic.response import text

@app.route("/get_info")
async def get_info(request):
    print(request.url)
    return text("it is ok!")

@app.middleware("request")
async def get_request_middleware(request):
    print("请求中间件")

@app.middleware("response")
async def get_response_middleware(request,response):
    print("响应中间件")

当我们访问/get_info请求时，打印结果将会是这样的：

请求中间件
http://localhost:5000/get_info
响应中间件

值得注意的是，如果是响应中间的处理函数，除了需要传递一个request对象参数，还需要传递一个response对象参数。从结果可以看出，request中间件是在接收到请求时立马触发的，而response中间件是在接收到响应时立马触发的。针对这两者的特性，我们可以进行一些特殊的操作，来达到我们的目的：

@app.middleware("request")
async def get_request_middleware(request):
    request.args.update({"name":"laozhang"})

@app.middleware("response")
async def get_response_middleware(request,response):
    response.headers["name"] = "laozhang"

将所有的请求的args添加一条name=laozhang，并且在响应头中添加name=laozhang

监听器

如果需要在服务器启动/关闭的时候，执行一些特殊的代码，则可以使用以下监听器：

• before_server_start：在服务器启动之前执行
• after_server_start：在服务器启动之后执行
• before_server_stop：在服务器关闭之前执行
• after_server_stop：在服务器关闭之后执行

举个栗子：

@app.listener("before_server_start")
async def before_server_start(request,loop):
    print("before_server_start")

@app.listener("after_server_start")
async def after_server_start(request,loop):
    print("after_server_start")

@app.listener("before_server_stop")
async def before_server_stop(request,loop):
    print("before_server_stop")

@app.listener("after_server_stop")
async def after_server_stop(request,loop):
    print("after_server_stop")

现在先启动服务，而后关闭，发现执行的顺序将会是这样：

before_server_start
after_server_start
before_server_stop
after_server_stop