ASGI(Asynchronous Server Gateway Interface, 异步服务器网关接口) 是WSGI的传人,为了规范支持异步的Python网络服务器,框架和应用之间的通信而定制。
相较于WSGI定义了同步的Python应用间的通信规范,ASGI同时囊括了同步和异步应用的通信规范,并且向后兼容遵循WSGI的应用、服务以及框架。

介绍

ASGI是WSGI的传承者,是python网络服务器、框架和应用进行长连接的通信标准。
WSGI在python网络应用的自由与创新方面很成功,而ASGI希望在此基础上推进异步Python的应用。

为什么WSGI不合适

你可能会问“为什么选择不更新WSGI”?这一问题在过去多年被时常问起,原因通常被归结为WSGI的单次调用接口不适合WebSocket这种介入程度更高的协议。
WSGI应用都是单词、同步调用的,他们仅在接受一个请求后返回应答,这种模式不支持长连接,比如HTTP长轮询或者WebSocket连接。
即使我们将其改为异步调用,发起请求的方式仍然是单一的,所以那些会多次传入事件的协议无法调用这些应用。

ASGI工作原理

ASGI由单独的异步应用沟通成。其中包括scope,包含传入请求的所有信息;send,用于向客户端发送事件的异步方法,receive,用于接受客户端发来事件的异步方法。
ASGI不仅让应用可以多次接受或发送事件,并且可以结合协程时应用同时处理器他任务(比如监听外部触发的事件,就像Redis队列一样)。
一个最简单的应用就像函数一样:

async def application(scope, receive, send):
    event = await receive()
    ...
    await send({"type": "websocket.send", ...})

每一个事件都是按预定的格式编排的python字典,这种格式构成了通信规范的基础,并时的应用可以在服务器之间交换信息。
每个事件都一个type属性,用于表明事件的结构。比如从receive方法可能收到如下结构的事件,用于发送HTTP响应的开头:

{
    "type": "http.response.start",
    "status": 200,
    "headers": [(b"X-Header", b"Amazing Value")],
}

你也可能将如下结构的事件传递给send方法用于发送WebSocket信息:

{
    "type": "websocket.send",
    "text": "Hello world!",
}

兼容WSGI

ASGI被设计为WSGI的超集,定义了明确的方法用于两者之间的转换,通过转换装饰器(在asgiref库中提供)可以让WSGI应用在ASGI服务器内运行。在异步事件循环外会有一个线程池用于运行同步WSGI应用。

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐