ASGI¶

Краткое описание¶

Приложение ASGI - это вызываемый объект, который принимает область видимости и возвращает вызываемую сопрограмму, которая принимает методы приема и отправки. Обычно это записывается как класс:

class Application:

    def __init__(self, scope):
        ...

    async def __call__(self, receive, send):
        ...

Словарь scope определяет свойства соединения, такие как его удаленный IP (для HTTP) или имя пользователя (для протокола чата), а также время жизни соединения. Приложения создаются один раз для каждой области - например, один раз для HTTP-запроса или один раз для открытого соединения WebSocket.

Области действия всегда имеют ключ type, который сообщает вам, какое это соединение и какие другие ключи следует ожидать в области (и какие сообщения ожидать).

Ожидаемый объект (awaitable) receive предоставляет события в виде словарей по мере их возникновения, а awaitable send отправляет события обратно клиенту в аналогичном формате словаря.

Сервер протокола находится между клиентом и кодом вашего приложения, декодируя необработанный протокол в область видимости и события и кодируя все, что вы отправляете обратно в протокол.

Компонуемость¶

Приложения ASGI, такие как WSGI, предназначены для компоновки, и они включают компоненты маршрутизации и промежуточного программного обеспечения каналов, такие как ProtocolTypeRouter и SessionMiddeware. Это просто приложения ASGI, которые принимают в качестве аргументов другие приложения ASGI, поэтому вы можете передать только одно приложение верхнего уровня для всего проекта Django и отправить его нужному потребителю в зависимости от того, с каким типом соединения вы работаете.

Спецификации протокола¶

Базовая спецификация ASGI только описывает интерфейс для приложения ASGI - она не определяет, как сетевые протоколы кодируются в области и из областей и словарей событий. Это работа спецификаций протокола:

• HTTP и WebSocket: https://github.com/django/asgiref/blob/master/specs/www.rst