如何在.NET中集成SignalR-武穆逸仙

如何在.NET 中集成 SignalR

SignalR 简介

SignalR 是一个开放源代码库，可用于简化向应用添加实时 Web 功能，实时 Web 功能使服务器端代码能够将内容推送到客户端。

SignalR 开源库：https://github.com/SignalR/SignalR

SignalR 应用场景

需要高频次从服务器获取信息的应用：如预警、游戏、社交网络、投票、拍卖、地图和 GPS 引用；

仪表盘应用：如数字大屏、仪表板、即时信息看板等；

协作应用：包括白板应用和团队会议软件；

通知应用：社交网络、电子邮件、聊天、游戏、预警和其他应用都需要使用的通知。

.NET Framework 项目中集成 SignalR

服务端（.NET Framework MVC）

选择要引用 Signalr 的项目，右键点击【管理 NuGet 程序包】搜索【SignalR】包，找到“ Microsoft.AspNet.SignalR ”，点击【安装】

因为 SignalR 需要依赖其他程序包，在安装“ Microsoft.AspNet.SignalR ”的同时，还会自动安装“ Microsoft.AspNet.SignalR.Core ”、“ Microsoft.AspNet.SignalR.JS ”、“ Microsoft.AspNet.SignalR.SystemWeb ”。

还需引用添加 Owin 相关的包，Owin 定义了 Web 服务器和应用程序组件之间的交互的规范。

同样，在【管理 NuGet 程序包】搜索【Owin】包，找到“ Microsoft.Owin ”，点击【安装】

在项目中引入


Microsoft.Owin.Hosting
Microsoft.Owin.Cors
Microsoft.Owin.Host.HttpListener

在 Web 项目中【Startup.cs】文件中启用 SignalR。


    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            app.MapSignalR();
       }
    }

创建一个类来继承 Hub 类


    public class ServerHub : Hub
    {       
        public async Task DoWork()
        {
            //供客户端调用
        }
        public async Task SendMessage(string msg)
        {
            // 当前连接用户的标志,是一个 GUID，如：362d3597-041e-4d65-8fdf-e77e98425d38
            string connectionId = Context.ConnectionId;
            // 给所有人发送消息
            await Clients.All(connectionId).newmsg(msg);
            // 给组内所有人发送消息
            await Clients.Group(connectionId).newmsg(msg);
            // 给除去自己其他人发送消息
            await Clients.Others(connectionId).newmsg(msg);
            // 给自己发送消息
            await Clients.Caller(connectionId).newmsg(msg);
        }

        public async Task WhoIam(string connectionId)
        {
            // 当前连接用户的标志,是一个 GUID，如：362d3597-041e-4d65-8fdf-e77e98425d38
            await Groups.Add(Context.ConnectionId, connectionId);
            await Clients.Group(connectionId).newmsg(Context.ConnectionId + "已登入");
        }
    }

BuildHub 中的方法供客户端调用，方法中 Clients 代表客户端对象。

把后台服务启动起来，然后查看 SignalR 状态是否正常，如果出现如图页面则表示 SignalR 正常。

如何在.NET 中集成 SignalR

客户端：

在网页中引入 SignalR 相关 JS


<script src="/Scripts/jquery.min.js"></script>
<script src="/Scripts/jquery.signalR-2.4.1.min.js"></script>
<script src="/signalr/hubs"></script>

客户端页面代码：

<html>
<head>
    <title>SignalR</title>
</head>
<body>
    <div> 
        <input type="text" id="msg"/>
        <button id="sendMsg">发送消息</button>
    </div>
    <ol id="showMsg"></ol>  
	<script src="/Scripts/jquery.min.js"></script>
	<script src="/Scripts/jquery.signalR-2.4.1.min.js"></script>
	<script src="/signalr/hubs"></script>
    <script>
        $(function () {
            //获取服务端连接对象
            var hub = $.connection.serverHub;
            //创建服务端所调用的客户端方法
            hub.client.showMsg=function(name, msg){
                $('#showMsg').append('<li><span style="color:red">'+name+':</span>'+msg+'</li>')
            }
            //开始连接服务器
            $.connection.hub.start().done(function () {
                //连接成功
                $('#sendMsg').bind('click', function () {
                    //调用服务端发送方法
                    hub.server.SendMessage($('#msg').val());
                })
            }).fail(function () {
                //连接失败
                alert("连接失败");
            });
        })
    </script>
</body>
</html>

.NET Core 中集成 SignalR

先通过【管理 NuGet 程序包】搜索、安装 SignalR 包，主要是配置上有点差异。

若项目是.NET6 以前的版本，在【Startup.cs】中配置：


    public class Startup
    {
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();

            services.AddSignalR();
        }
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.UseRouting();

            app.UseAuthorization();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllers();
                endpoints.MapHub("Hubs"); 
            });
        }
    }

若项目是.NET6 以后的版本，则在【Program.cs】中配置：


var builder = WebApplication.CreateBuilder(args);
//添加 SignalR 服务
builder.Services.AddSignalR();


app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}"
    );

    //添加 SignalR 端点
    endpoints.MapHub("/Hubs");
});

博主的文章没有高度、深度和广度，只是凑字数。利用读书、参考、引用、抄袭、复制和粘贴等多种方式打造成自己的纯镀 24k 文章！如若有侵权，请联系博主删除。

☆ END ☆