ASP.NET Core SignalR是一个开发实时网络应用程序的框架,它使用WebSocket作为传输协议,并提供了一种简单和高效的方式来实现实时双向通信。
SignalR使用了一种称为"Hub"的概念来管理连接和消息的传递。开发者可以编写自己的Hub类,并定义可以由客户端调用的方法。客户端可以通过SignalR客户端库来连接到服务器上的Hub,并调用相应的方法。服务器端的Hub会接收和处理客户端的请求,并可以向客户端推送消息。
ASP.NET Core SignalR支持多种传输协议,包括WebSocket、Server-Sent Events(SSE)、长轮询(Long-polling)等。它会自动根据浏览器的支持和服务器配置来选择最佳的传输方式。当WebSocket不可用时,SignalR会自动回退到其他传输方式。
ASP.NET Core SignalR提供了一些强大的功能,例如群组(Group)管理、消息广播、连接保持、身份验证等。开发者可以利用这些功能来构建各种实时应用程序,比如聊天应用、实时数据监控、协同编辑等。
总结来说,ASP.NET Core SignalR是一个用于构建实时网络应用程序的框架,它使用WebSocket作为传输协议,提供了简单和高效的双向通信方式。它具有灵活的API和丰富的功能,适用于各种实时应用的开发需求。
下面是一个简单的示例,演示如何使用ASP.NET Core SignalR建立一个实时聊天应用程序。
-
创建一个新的ASP.NET Core Web应用程序项目。
-
在项目的
Startup.cs
文件中,添加以下代码来配置SignalR:
csharp
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
namespace SignalRDemo
{
public class Startup
{
public void ConfigureServices(IServiceCollection services)
{
// 添加SignalR服务
services.AddSignalR();
}
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
app.UseRouting();
// 添加SignalR中间件
app.UseEndpoints(endpoints =>
{
endpoints.MapHub<ChatHub>("/chathub");
});
}
}
}
- 创建一个名为
ChatHub.cs
的新文件,用于定义聊天的Hub:
csharp
using Microsoft.AspNetCore.SignalR;
using System.Threading.Tasks;
namespace SignalRDemo
{
public class ChatHub : Hub
{
public async Task SendMessage(string user, string message)
{
// 调用所有客户端的接收消息的方法
await Clients.All.SendAsync("ReceiveMessage", user, message);
}
}
}
- 创建一个名为
Index.cshtml
的新文件,用于展示聊天室的界面:
html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>SignalR Chat Demo</title>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script src="/chat.js"></script>
</head>
<body>
<div>
<input type="text" id="username" placeholder="Enter your name" />
<input type="text" id="message" placeholder="Enter your message" />
<button id="sendButton">Send</button>
</div>
<div id="chatBox"></div>
</body>
</html>
- 创建一个名为
chat.js
的新文件,用于处理聊天室的客户端逻辑:
javascript
"use strict";
var connection = new signalR.HubConnectionBuilder().withUrl("/chathub").build();
connection.on("ReceiveMessage", function (user, message) {
var encodedUser = user;
var encodedMessage = message;
var li = document.createElement("li");
li.textContent = encodedUser + " says: " + encodedMessage;
document.getElementById("chatBox").appendChild(li);
});
document.getElementById("sendButton").addEventListener("click", function (event) {
var user = document.getElementById("username").value;
var message = document.getElementById("message").value;
connection.invoke("SendMessage", user, message).catch(function (err) {
return console.error(err.toString());
});
event.preventDefault();
});
connection.start().then(function () {
console.log("Connected to chat hub");
}).catch(function (err) {
console.error(err.toString());
});
- 运行ASP.NET Core应用程序。
现在,您可以访问http://localhost:5000
来查看实时聊天室应用程序,多个客户端可以进行聊天并实时接收消息。
可以参考官网:https://learn.microsoft.com/zh-cn/aspnet/core/signalr/version-differences?view=aspnetcore-6.0