Pythonプロジェクトの戦闘:リアルタイムブログのプロジェクトのソースコードのダウンロード

 

最終結果


 

ASGI、Djangoのチャンネル紹介

 
 

 

私は昨年に翻訳をしたASGI完全な説明。

ASGIは、同時処理(例えばDjangoのような)ネットワークフレームワークにHTTP、HTTP2、のWebSocketプロトコルを解決するために、Djangoのチームが提案しました。DjangoはASGI能力をもたらしたため、このような理由から、ジャンゴ・ジャンゴチャンネルチームは、プラグインを開発しました。

ネットワーク要求処理におけるASGIでは三つのレベル、フロント層、インターフェースサーバ(サーバプロトコル処理)に分割され、プロトコルが要求を解析する責任、および異なるチャネル(チャネル)の異なるプロトコルに分配されます。第二層に属するチャンネルは、一般的にキューシステムとすることができます。チャネルは、消費者(消費者)第三の層を結合しました。

例えば、チャネルHTTPプロトコルHTTPコンシューマを結合上の新しいHTTP要求を、HTTPリクエストの流通経路へのインタフェースサーバ、HTTPチャネルHTTPバインディング消費者が要求を処理し、プロセスが存在する場合結果は、HTTPチャネルに戻され、最終的にクライアントに返します。

ここでは、例を使用するには、この能力を示します。

リアルタイムのブログ

最初のステップ:アップ実行

この例ではPython 3.5.1に基づいており、MacOSの10.12.4ベータ5は、理論的には、Pythonの2.7は、Linuxは(自分の主張をテストする)まで実行することができます。

インストールが異なります。-r requirements.txtをインストールPIP

次のようにrequirements.txt:

Djangoの
チャンネル
asgi_redis 
feedparser

新しいDjangoプロジェクト:ジャンゴ-adminのstartprojectのlivelog。

settings.py内側チャネルの基本構成と結合INSTALLED_APPSにチャネルを追加します:

...
INSTALLED_APPS = (
    ...
    'channels',
)
...
# Redis
REDIS_OPTIONS = {
    'HOST': '127.0.0.1',
    'PORT': 6379,
    'DB': 0
}
USE_REDIS = True
# Channel settings
CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "asgi_redis.RedisChannelLayer",
        "CONFIG": {
            "hosts": ['redis://{}:{}'.format(REDIS_OPTIONS['HOST'],
                                             REDIS_OPTIONS['PORT'])]
        },
        "ROUTING": "livelog.routing.channel_routing"
    }
}

注意到使用了 Redis 来做为 Channels 的 Backend。使用 Redis 是为了跨进程的消息处理,为了简便(不需要跨进程),也可以使用 In Memory Channel Layer。

接着,我们在 livelog app 目录下添加一个 routing.py 文件,用以配置 channel 路由,现在可以留空:

channel_routing = []

现在,通过以下命令即可跑起来我们的第一个 ASGI Server。

# run following commands in command line separately
redis-server /usr/local/etc/redis.conf
python manage.py runserver

可以看到和普通的 Django app server 的启动方式没什么两样,这归功于 Django Channels 封装。实际工作中,要拆解为三个单独的启动步骤:

daphne livelog.asgi:channel_layer --port 8080  //daphne 是 asgi interface sever 的一种实现
python manage.py runworker // 启动 ASGI consumer worker
python manage.py runserver --noasgi --noworker // 启动原始的 WSGI server,不运行 ASGI interface server、worker

第二步:处理 WebSocket

Channels 将 WebSocket 连接映射到三个不同到频道:

  • 当一个新的客户端通过 WebSocket 连接时,websocket.connect 频道将收到一条消息,在本例中,将在此频道将新用户添加到实时博客订阅组里。
  • 当一个客户端断开连接,websocket.disconnect 频道将收到一条消息。
  • 每一条消息都将被发往 websocket.receive 频道,在这个频道里。

首先,我们需要将我们的处理逻辑绑定到这三个频道。

在 livelog app 目录中,添加 comsumers.py 文件:

...
def ws_connect(message):
    message.reply_channel.send({'accept': True})
    Group(const.GROUP_NAME).add(message.reply_channel)
def ws_disconnect(message):
    Group(const.GROUP_NAME).discard(message.reply_channel)
def ws_receive(message):
    pass

在本例中,使用 WSGI 也即原生 Django 提供 http 服务。

在 routing.py 文件中,将逻辑绑定到路由:

...
channel_routing = [
    route('websocket.connect', ws_connect),
    route('websocket.disconnect', ws_disconnect),
    route('websocket.receive', ws_receive)
]

在 ws_connect 频道中,做了两件事:

  1. 建立 WebSocket 连接;
  2. 将新用户添加到群组里,后面我们将该群组作为实时博客的订阅组,对它发送新的消息。

在 ws_disconnect 频道中,将断开连接的用户移出群组。

在 ws_receive 频道中,暂时什么也不做,因为本例中,我们不通过被动接受新消息的方式来更新博客。

为了较为全面地展示 ASGI 的能力,本例中,我们使用 Background worker(后台进程)来主动更新博客,并给群组用户推送新消息。

第三步:推送消息

更新实时博客的方式有很多种,在这里我们使用一个 RSS Feed 作为内容源,对该内容源定时抓取,将新内容更新到博客中,以此来做一个演示。在此之前,介绍一个 Django 的小特性,这个特性将允许我们这么运行我们自己的后台进程:

python manage.py blogging_worker // blogging_worker 是我们自定义的命令

这个特新就是 Django 的自定义命令

具体做法在此不赘述,看文档或看本例完整源码即可得知。下面我们回到正事儿上:

blogging_worker.py

# -*- coding: utf-8 -*-
...
class Command(BaseCommand):
    """
    Command to start blogging worker from command line.
    """
    help = 'Fetch and parse RSS feed and send over channel'
    def handle(self, *args, **options):
        rc = redis.Redis(host=settings.REDIS_OPTIONS['HOST'],
                         port=settings.REDIS_OPTIONS['PORT'],
                         db=settings.REDIS_OPTIONS['DB'])
        rc.delete(const.GROUP_NAME)  # flush live blogs
        while True:
            feed = feedparser.parse(const.IFANR_FEED_URL)
            for entry in feed.get('entries')[::-1]:
                if not rc.hexists(const.GROUP_NAME, entry.get('id')):
                    Group(const.GROUP_NAME).send({'text': json.dumps(entry)})
                    rc.hset(const.GROUP_NAME, entry.get('id'), json.dumps(entry))
                    logger.debug('send a message %s ' % entry.get('title'))
                    time.sleep(5)

这个文件里的大量写法都是 Django 约束的,所以不必过分追究,我们看 handle 方法,在这里,我们做这么几件事:

  1. 从爱范儿的 RSS Feed 获取最新的文章,对每一文章,检查这篇文章是否已经发送过,如果没有发送过,则将该文章发送给群组;
  2. 在 redis 中,新建一个名为 liveblog(这个常量存储在 const.GROUP_NAME) 的哈希表,将每篇未被发送过的新文章添加到该哈希表中,这样就可以判断一篇文章是否曾经被发送过;
  3. Group(const.GROUP_NAME).send({'text': json.dumps(entry)}) 对群组进行新消息的发送;
  4. 每次发送之后,休息 5 秒钟。

第四步:接收新消息并渲染

我们已经有了一个永不停歇的博客更新服务在运行着,一旦有新的内容,这个服务将为用户推送。现在,我们需要一个页面来渲染呈现新消息。

在 templates 目录下,新建 blog.html 文件:

<!DOCTYPE html>
<html lang="en">
...
        <div id="container">
        <h2>Live Blog</h2>
        <ul id="log">
        </ul>
    </div>
    <script type="application/javascript">
        var ws_scheme = window.location.protocol == "https:" ? "wss" : "ws";
        var ws = new WebSocket(ws_scheme + '://' + window.location.host + window.location.pathname);
        console.log(ws);
        ws.onmessage = function (message) {
            var data = JSON.parse(message.data);
            var logList = document.querySelector('#log');
            var logItem = document.createElement('li');
            var itemTmp = `
                <h3>${data.title}</h3>
                <p>
                    <date>${new Date(data.published).toLocaleString()}</date>
                    <span>${data.source.title}</span>
                </p>
            `;
            logItem.innerHTML = itemTmp;
            logList.insertBefore(logItem, logList.firstChild);
        }
    </script>
</body>
</html>

在这个页面里,有一个 WebSocket Client 将被新建,并向服务器发起建立连接的请求。当有新消息,将在 #log ul 中插入新的消息。

接下来就是传统 Django 的工作:

  1. 在 urls.py 中配置 django view 的路由:url(r'blog/$', livelog.views.livelog, name='livelog');
  2. 在 views.py 中新增一个名为 livelog 的 view: def livelog(request): return render(request, 'blog.html'),渲染模板,响应 http 请求。

到此,一个主动更新博客内容并将新消息推送给每位在线的用户的服务就完成了。

References

  • ASGI 异步服务网关接口规范
  • Django Channels Get Started
  • Finally, Real-Time Django Is Here: Get Started with Django Channels
  • Raspberry PI and Django Channels

  • 下载地址

おすすめ

転載: www.cnblogs.com/pythongood/p/11183061.html