Django系列之Channels

这篇具有很好参考价值的文章主要介绍了Django系列之Channels。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

1. Channels 介绍

Django 中的 HTTP 请求是建立在请求和响应的简单概念之上的。浏览器发出请求,Django服务调用相应的视图函数,并返回响应内容给浏览器渲染。但是没有办法做到 服务器主动推送消息给浏览器

因此,WebSocket 就应运而生了。WebSocket 是一种基于 HTTP 基础上进行全双工通讯的协议。WebSocket允许服务端主动向客户端推送数据。在WebSocket协议中,浏览器和服务器只需要完成一次握手就可以创建持久性的连接,并在浏览器和服务器之间进行双向的数据传输。

Django Channels 实现了 WebSocket 能力。Channels 允许 Django 以非常类似于传统 HTTP 的方式支持WebSockets。Channels 也允许在运行 Django 的服务器上运行后台任务,HTTP 请求表现以前一样,但也支持通过 Channels 进行路由。

Django channels安装:pip install channels

2. channels 单人聊天

配置文件 settings.py:

INSTALLED_APPS = [
	...
    'app01.apps.App01Config',
    'channels'
]
ASGI_APPLICATION = 'djangoProject.asgi.application'

asgi.py: ASGI支持多种不同的协议,在这里可以指定特定协议的路由信息。

import os
from django.core.asgi import get_asgi_application
from channels.routing import ProtocolTypeRouter, URLRouter
from djangoProject import routings

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'djangoProject.settings')

application = ProtocolTypeRouter({
    'http': get_asgi_application(),     # 支持http请求
    'websocket': URLRouter(routings.websocket_urlpatterns),      # 支持websocket请求
})

主路由文件 urls.py:

from app01 import views as vw1

urlpatterns = [
    path('admin/', admin.site.urls),
    path("chatone", vw1.chat)
]

主业务视图文件 app01/views.py:

from django.shortcuts import render

def chat(request):
    return render(request, "chatting.html")

主业务html文件 chatting.html:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        .message {
            height: 300px;
            border: 1px solid #dddddd;
            width: 100%;
        }
    </style>
</head>
<body>
    <div class="message" id="message"></div>
    <div>
        <input type="text" placeholder="请输入聊天内容:" id="txt">
        <input type="button" value="点击发送" onclick="sendMessage()">
        <input type="button" value="关闭连接" onclick="closeConn()">
    </div>

    <script>

        // 实例化websocket对象,并客户端主动以websocket方式连接服务端
        wbsocket = new WebSocket("ws://127.0.0.1:8080/room/123/");

        // 创建好websocket连接成功后自动触发(服务端执行self.accept()后)
        wbsocket.onopen = function (event) {
            var tag = document.createElement("div");
            tag.innerText = '[连接成功!]';
            document.getElementById("message").appendChild(tag);
        };

        // 创建连接失败后自动触发
        wbsocket.onerror = function (event) {
            var tag = document.createElement("div");
            tag.innerText = '[连接失败!]';
            document.getElementById("message").appendChild(tag);
        };

        // 当websocket接收到服务器发来的消息时会自动触发
        wbsocket.onmessage = function (event) {
            var tag = document.createElement("div");
            tag.innerText = event.data;
            document.getElementById("message").appendChild(tag);
        };

        // 当服务端主动断开客户端时自动触发(服务端执行self.close()后)
        wbsocket.onclose = function (event) {
            var tag = document.createElement("div");
            tag.innerText = '[连接已断开!]';
            document.getElementById("message").appendChild(tag);
        };

        // 页面上客户端点击向服务端"关闭连接"时触发
        function closeConn() {
            wbsocket.close();       // 客户端主动断开连接,服务端会执行 websocket_disconnect()
            var tag = document.createElement("div");
            tag.innerText = '[连接已断开啦!]';
            document.getElementById("message").appendChild(tag);
        }

        // 页面上客户端点击向服务端"发送消息"时触发
        function sendMessage() {
            var info = document.getElementById("txt");
            wbsocket.send(info.value);   // 客户端给服务端发数据
        }

    </script>

</body>
</html>

websocket路由文件 routings.py:

from django.urls import re_path
from app01 import consumers as consm1

websocket_urlpatterns = [
    re_path(r'room/', consm1.ChatConsumer.as_asgi())
]

处理websocket业务文件 app01/consumers.py:

from channels.exceptions import StopConsumer
from channels.generic.websocket import WebsocketConsumer

class ChatConsumer(WebsocketConsumer):
    def websocket_connect(self, message):
        """
        客户端向服务端发送websocket连接的请求时自动触发。
        """
        print("1 > 客户端和服务端开始建立连接")
        self.accept()

    def websocket_receive(self, message):
        """
        客户端基于websocket向服务端发送数据时,自动触发接收消息。
        """
        print(f"2 > 服务端接收客户端的消息, message is {message}")
        recv_data = message["text"]

        if recv_data == "exit":     # 服务端主动关闭websocket连接时,前端会执行对应的 onclose
            self.close()
            # raise StopConsumer()    # raise主动抛异常后,websocket_disconnect 就不在执行了,多用于`只处理服务端向客户端断开`的场景
            return

        send_data = f"服务端主动推送消息:{recv_data}"
        self.send(text_data=send_data)

    def websocket_disconnect(self, message):
        """
        客户端与服务端断开websocket连接时自动触发(不管是客户端向服务端断开还是服务端向客户端断开都会执行)
        """
        print("3 > 客户端和服务端断开连接")
        self.close()
        raise StopConsumer()

3. channel_layer 群组聊天

对于大多数情况来说,发送到单人的 channel 并没有用,更多的情况下希望可以以广播的方式将message 一次性发送给多个 channel 或者 consumer,这不仅适用于想在向房间内的每个人发送消息,还适用于发送给连接了多个浏览器/标签/设备的用户。

channel_layer 是一种通信系统。它允许多个消费者实例相互交谈,借助 channel_layer 可以很方便的实现群聊功能,我们无需手动管理 websocket 连接。channel 官方推荐的是配置channel_redis,它是一个使用Redis作为传输的Django维护层。安装:pip install channels_redis

channel_layer 属于纯粹的异步接口,如果想要改成同步代码调用,需要使用async_to_sync做转换:
from asgiref.sync import async_to_sync

配置文件 settings.py:

ASGI_APPLICATION = 'djangoProject.asgi.application'

# 开发环境使用
CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels.layers.InMemoryChannelLayer"
    }
}

# 真实生产环境上使用
CHANNEL_LAYERS = {
    "default": {
        "BACKEND": "channels_redis.core.RedisChannelLayer",
        "CONFIG": {
            "hosts": ["redis://127.0.0.1:6379/1", ],        # 无密码连接redis

            # "hosts": ["redis://:password@127.0.0.1:6379/1", ],      # 有密码连接redis
            # "symmetric_encryption_keys": [SECRET_KEY]
        }
    }
}

asgi.py:

import os
from django.core.asgi import get_asgi_application
from channels.routing import ProtocolTypeRouter, URLRouter
from djangoProject import routings

os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'djangoProject.settings')

application = ProtocolTypeRouter({
    'http': get_asgi_application(),     # 支持http请求
    'websocket': URLRouter(routings.websocket_urlpatterns),      # 支持websocket请求
})

主路由文件 urls.py:

from django.contrib import admin
from django.urls import path
from app01 import views as vw1
from app02 import views as vw2

urlpatterns = [
    path('admin/', admin.site.urls),
    path("chatone", vw1.chat),
    path("chatgroup", vw2.groupchat)	# 群聊
]

主业务视图 app02/views.py:

from django.shortcuts import render

def groupchat(request):
    groupid = request.GET.get("groupID")	# 获取群组ID
    return render(request, "groupchatting.html", {"group_num": groupid})

主业务html文件 chatting.html: js在实例化websocket对象时需要改动。

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <style>
        .message {
            height: 300px;
            border: 1px solid #dddddd;
            width: 100%;
        }
    </style>
</head>
<body>
    <div> 群组内聊天[ 群ID: {{ group_num }} ] </div>
    <div class="message" id="message"></div>
    <div>
        <input type="text" placeholder="请输入群聊内容:" id="txt">
        <input type="button" value="点击发送" onclick="sendMessage()">
        <input type="button" value="关闭连接" onclick="closeConn()">
    </div>

    <script>

        // 实例化websocket对象,并客户端主动以websocket方式连接服务端
        wbsocket = new WebSocket("ws://127.0.0.1:8080/group/{{ group_num }}/");

        // 创建好websocket连接成功后自动触发(服务端执行self.accept()后)
        wbsocket.onopen = function (event) {
            var tag = document.createElement("div");
            tag.innerText = '[连接成功!]';
            document.getElementById("message").appendChild(tag);
        };

        // 创建连接失败后自动触发
        wbsocket.onerror = function (event) {
            var tag = document.createElement("div");
            tag.innerText = '[连接失败!]';
            document.getElementById("message").appendChild(tag);
        };

        // 当websocket接收到服务器发来的消息时会自动触发
        wbsocket.onmessage = function (event) {
            var tag = document.createElement("div");
            tag.innerText = event.data;
            document.getElementById("message").appendChild(tag);
        };

        // 页面上客户端点击向服务端"关闭连接"时触发
        function closeConn() {
            wbsocket.close();       // 客户端主动断开连接,服务端会执行 websocket_disconnect()
            var tag = document.createElement("div");
            tag.innerText = '[连接已断开!]';
            document.getElementById("message").appendChild(tag);
        }

        // 页面上客户端点击向服务端"发送消息"时触发
        function sendMessage() {
            var info = document.getElementById("txt");
            wbsocket.send(info.value);   // 客户端给服务端发数据
        }

    </script>

</body>
</html>

websocket 路由文件 routings.py:

from django.urls import re_path
from app01 import consumers as consm1
from app02 import consumers as consm2

websocket_urlpatterns = [
    re_path(r'room/', consm1.ChatConsumer.as_asgi()),
    re_path(r"group/(?P<groupID>\w+)/$", consm2.GroupChatConsumer.as_asgi())	# 群聊
]

websocket 群聊业务文件 consumers.py:
注意:从路由url中获取参数时,要使用 self.scope["url_route"]["kwargs"].get("groupID"),这里的 groupID 必须和routings中的路由分组名 re_path(r"group/(?P<groupID>\w+)/$" 保持一致!!!文章来源地址https://www.toymoban.com/news/detail-622862.html

from asgiref.sync import async_to_sync
from channels.exceptions import StopConsumer
from channels.generic.websocket import WebsocketConsumer

class GroupChatConsumer(WebsocketConsumer):
    group_id = None

    def websocket_connect(self, message):
        # 接受客户端连接
        self.accept()
        print(">>> 客户端和服务端已成功建立连接 <<<")
        # 从url获取群组id,这个groupID必须和routings里的路由分组名保持一致
        self.group_id = self.scope["url_route"]["kwargs"].get("groupID")
        # 将当前的连接加入到名为self.group_id的组中
        async_to_sync(self.channel_layer.group_add)(self.group_id, self.channel_name)

    def websocket_receive(self, message):
        print(f"current self is {self}, id is {id(self)}, groupID is {self.group_id}")
        # 组内所有的客户端,执行type对应的函数,可以在此函数中自定义任意功能
        async_to_sync(self.channel_layer.group_send)(self.group_id, {"type": "send_msg", "message": message})

    def send_msg(self, event):
        input_msg = event["message"].get("text")
        send_msg = f"组内主动推送消息:{input_msg}"
        self.send(text_data=send_msg)

    def websocket_disconnect(self, message):
        # self.channel_name从组self.group_id中删除并断开连接
        async_to_sync(self.channel_layer.group_discard)(self.group_id, self.channel_name)
        print(">>> 客户端和服务端已断开连接 <<<")
        raise StopConsumer()

到了这里,关于Django系列之Channels的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • django channels实战(websocket底层原理和案例)

    asgi.py在django项目同名app目录下 django代码总结 报错如下: 1、不要安装最新的版本,建议安装指定版本 pip install -U channels==3.0.2 2、在python .manage.py runserver 0.0.0.0:8080启动的前提下,新开一个cmd窗口,启动daphne服务 1)首先,确保你已经安装了 Daphne。可以使用以下命令安装最新版

    2024年02月14日
    浏览(41)
  • Django Channels、WS协议及同步与异步详解

    在 Django 中,同步和异步主要涉及到请求处理的方式。这两种方式的主要区别在于它们如何处理多个并发请求: 同步(Synchronous):在同步模式下,Django 会为 每个请求 创建一个 单独 的线程或进程。这意味着,如果一个请求正在等待响应(例如,等待数据库查询返回结果),

    2024年02月07日
    浏览(41)
  • Django框架:使用channels实现websocket,配置和项目实际使用

    依赖包: 项目目录结构: study_websocket         --study_websocket                 --__init__.py                 --settings.py                 --asgi.py                 --wsgi.py                 --urls.py         --chat                 --routing

    2024年02月15日
    浏览(40)
  • 【项目部署-apache】windows系统下apache部署django+channels

    1、原生的python3.8.5(默认安装,不更改安装目录),不要使用Anaconda做虚拟环境。 2、在windows系统下需要,mod_wsgi 模块。 创建虚拟环境:(在当前目录下创建名为 gzgs_alert 的虚拟环境) 激活gzgs_alert 虚拟环境,安装mod_wsgi: whl文件下载: 复制文件到虚拟环境的Scripts目录下: cmd进

    2024年04月26日
    浏览(37)
  • Django3框架-(2)-[使用websocket]:使用channels实现websocket,配置和项目实际使用

    依赖包: 项目目录结构: study_websocket         --study_websocket                 --__init__.py                 --settings.py                 --asgi.py                 --wsgi.py                 --urls.py         --chat                 --routing

    2024年01月18日
    浏览(39)
  • Python系列-Django-Ninja

    适用对象: 有一定python和django基础,对此技术感兴趣,或者想快速尝试、实现效果的。 原则: 实用为主,效果为主 不重复造轮子,但应该知道其工作原理 官网是最好的教程,其它只是辅助 Django Ninja 是一个使用 Django 和 Python 3.6+ 类型提示构建 API 的 Web 框架。 官网地址 做记

    2023年04月08日
    浏览(25)
  • django如何连接sqlite数据库?

    目录 一、SQLite数据库简介 二、Django连接SQLite数据库 1、配置数据库 2、创建数据库表 三、使用Django ORM操作SQLite数据库 1、定义模型 2、创建对象 3、查询对象 总结 本文将深入探讨如何在Django框架中连接和使用SQLite数据库。我们将介绍SQLite数据库的特点,Django的数据库配置,以

    2024年02月06日
    浏览(55)
  • 【python】Django系列Day04--Cookie和Session

    🙋作者:爱编程的小贤 ⛳知识点:Django–cookie和session 🥇:每天学一点,早日成大佬 💎 💎 💎今天我们进入Django第四部分的学习啦!!! 🚀 🚀 🚀学习之前先要好好复习回顾前面的内容哦!!! 如果你看完感觉对你有帮助,,,欢迎给个三连哦💗!!!您的支持是我创

    2024年02月10日
    浏览(43)
  • django sqlite3操作和manage.py功能介绍

     参考链接:https://www.cnblogs.com/csd97/p/8432715.html manage.py 常用命令_python manage.py_追逐梦想的博客-CSDN博客 python django操作sqlite3_django sqlite_浪子仙迹的博客-CSDN博客

    2024年02月12日
    浏览(47)
  • 部署Django报错-requires SQLite 3.8.3 or higher

    在部署测试环境时,有需要用到一个python的后端服务,要部署到测试环境中去 心想这不是so easy吗,把本地调试时使用的python版本及Django版本在服务器上对应下载好,然后直接执行命令 不就完事儿了吗,说干就干,立马去服务器布置好python和django的环境,到py项目的根目录下

    2024年02月10日
    浏览(51)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包