Le sujet d'aujourd'hui est d'aider tout le monde à démarrer rapidement avec Asp.net SignalR. Sans plus tarder, entrons officiellement dans le contenu du sujet d’aujourd’hui.
2. Qu'est-ce qu'Asp.net SignalR
Asp.net SignalR est une bibliothèque de classes de Microsoft permettant de réaliser une communication en temps réel. Dans des circonstances normales, SignalR utilisera la méthode d'interrogation longue de JavaScript pour implémenter la communication client et serveur. Avec l'émergence de WebSockets dans HTML5, SignalR prend également en charge la communication WebSockets. De plus, les programmes développés par SignalR ne se limitent pas à être hébergés dans IIS, mais peuvent également être hébergés dans n'importe quelle application, y compris les consoles, les programmes clients et les services Windows. Ils prennent également en charge Mono, ce qui signifie qu'ils peuvent être déployés de manière croisée. -plateforme sur environnement Linux.
Il existe deux types d'objets dans SignalR :
Objet Http Persistent Connection : utilisé pour résoudre la fonction des connexions à long terme. Le client peut également demander activement des données au serveur, et le serveur n'a pas besoin d'implémenter trop de détails. Il lui suffit de gérer les cinq événements fournis dans PersistentConnection : OnConnected, OnReconnected, OnReceived, OnError et OnDisconnect.
Objet Hub (hub) : utilisé pour résoudre la fonction d'échange d'informations en temps réel. Le serveur peut utiliser l'URL pour enregistrer un ou plusieurs Hubs. Tant qu'il est connecté à ce Hub, il peut être partagé avec tous. clients et envoyés aux informations sur le serveur, et le serveur peut appeler le script du client.
SignalR encapsule l'intégralité de l'échange d'informations. Le client et le serveur utilisent JSON pour communiquer. Toutes les informations Hub déclarées sur le serveur généreront du JavaScript et les transmettront au client. .NET s'appuie sur Proxy pour générer des objets proxy en interne. convertit JSON en objets.
L'interaction spécifique entre le client et le serveur est illustrée dans la figure ci-dessous :
De l'introduction ci-dessus, on peut voir que SignalR est né pour le temps réel, qui détermine son emplacement d'utilisation. Les scénarios spécifiques applicables sont les suivants :
1. Salons de discussion, tels que les systèmes de service client en ligne, les systèmes de messagerie instantanée, etc.
2. Mises à jour en temps réel des cours des actions
3. services
4. Push en temps réel de l'emplacement des personnages dans le jeu
Actuellement, mon entreprise développe un système de service client en ligne.
3. Utilisez Asp.net SignalR pour implémenter des messages diffusés sur le Web
Grâce à l'introduction de la deuxième partie, je pense que tout le monde a une compréhension préliminaire d'Asp.net SignalR. Ensuite, nous en utiliserons deux. exemples pour illustrer Que chacun approfondisse sa compréhension du mécanisme de fonctionnement de SignalR. Le premier exemple est de savoir comment utiliser SignalR pour implémenter des messages diffusés sur le Web.
Utilisez Visual Studio 2013 pour créer un projet MVC
Installez le package SignalR via Nuget. Cliquez avec le bouton droit sur la référence -> Sélectionnez Gérer les packages Nuget -> Entrez SignalR dans la fenêtre qui apparaît pour trouver le package SignalR à installer.
Après avoir installé SignalR avec succès, les scripts de la bibliothèque SignalR seront ajoutés au dossier Scripts. Comme le montre la figure ci-dessous :
4. Ajoutez un hub SignalR (v2) au projet et nommez-le ServerHub.
5. Remplissez le code suivant dans la classe ServerHub que vous venez de créer.
using Microsoft.AspNet.SignalR; using Microsoft.AspNet.SignalR.Hubs; using System; namespace SignalRQuickStart {public class ServerHub : Hub { private static readonly char[] Constant = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; /// <summary> /// 供客户端调用的服务器端代码 /// </summary> /// <param name="message"></param> public void Send(string message) { var name = GenerateRandomName(4); // 调用所有客户端的sendMessage方法 Clients.All.sendMessage(name, message); } /// <summary> /// 产生随机用户名函数 /// </summary> /// <param name="length">用户名长度</param> /// <returns></returns> public static string GenerateRandomName(int length) { var newRandom = new System.Text.StringBuilder(62); var rd = new Random(); for (var i = 0; i < length; i++) { newRandom.Append(Constant[rd.Next(62)]); } return newRandom.ToString(); } } }
6. Créer une classe de démarrage Si l'authentification n'est pas modifiée lorsque vous démarrez la création du projet MVC, cette classe sera ajoutée par défaut. Si c'est le cas, il n'est pas nécessaire de l'ajouter à plusieurs reprises. Mettez à jour la classe Startup selon le code suivant.
7. Créez une méthode Home Action dans le contrôleur Home
public class HomeController : Controller { public ActionResult Index() { return View(); } public ActionResult About() { ViewBag.Message = "Your application description page."; return View(); } public ActionResult Contact() { ViewBag.Message = "Your contact page."; return View(); } public ActionResult Chat() { return View(); } }
8. Créez-la dans le dossier Home dans le fichier Views Une vue Chat, le code de vue est le suivant :
@{ ViewBag.Title = "聊天窗口"; } <h2>Chat</h2> <div class="container"> <input type="text" id="message" /> <input type="button" id="sendmessage" value="Send" /> <input type="hidden" id="displayname" /> <ul id="discussion"></ul> </div> @section scripts { <!--引用SignalR库. --> <script src="~/Scripts/jquery.signalR-2.2.0.min.js"></script> <!--引用自动生成的SignalR 集线器(Hub)脚本.在运行的时候在浏览器的Source下可看到 --> <script src="~/signalr/hubs"></script> <script> $(function () { // 引用自动生成的集线器代理 var chat = $.connection.serverHub; // 定义服务器端调用的客户端sendMessage来显示新消息 chat.client.sendMessage = function (name, message) { // 向页面添加消息 $('#discussion').append('<li><strong>' + htmlEncode(name) + '</strong>: ' + htmlEncode(message) + '</li>'); }; // 设置焦点到输入框 $('#message').focus(); // 开始连接服务器 $.connection.hub.start().done(function () { $('#sendmessage').click(function () { // 调用服务器端集线器的Send方法 chat.server.send($('#message').val()); // 清空输入框信息并获取焦点 $('#message').val('').focus(); }); }); }); // 为显示的消息进行Html编码 function htmlEncode(value) { var encodedValue = $('<div />').text(value).html(); return encodedValue; } </script> }
9. Modifiez la classe RoutConfig dans le dossier App_Start et définissez la méthode Action sur Chat en default.
public class RouteConfig { public static void RegisterRoutes(RouteCollection routes) { routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); routes.MapRoute( name: "Default", url: "{controller}/{action}/{id}", defaults: new { controller = "Home", action = "Chat", id = UrlParameter.Optional } ); } }
À ce stade, notre exemple est terminé. Examinons ensuite l'effet d'exécution, puis expliquons comment fonctionne SignalR. Complétez le message diffusé. Les résultats en cours d'exécution sont les suivants.
À partir des résultats en cours, vous pouvez constater que si vous entrez des informations dans n'importe quelle fenêtre et que vous les envoyez, tous les clients recevront le message. Il existe de nombreux effets de ce type dans des applications pratiques, telles que QQ. Les messages publicitaires de Tencent seront diffusés dès que vous vous connecterez à QQ.
Après avoir lu les résultats d'exécution, analysons le code puis analysons le fonctionnement de SignalR.
按照B/S模式来看,运行程序的时候,Web页面就与SignalR的服务建立了连接,具体的建立连接的代码就是:$.connection.hub.start()。这句代码的作用就是与SignalR服务建立连接,后面的done函数表明建立连接成功后为发送按钮注册了一个click事件,当客户端输入内容点击发送按钮后,该Click事件将会触发,触发执行的操作为: chat.server.send($('#message').val())。这句代码表示调用服务端的send函数,而服务端的Send韩式又是调用所有客户端的sendMessage函数,而客户端中sendMessage函数就是将信息添加到对应的消息列表中。这样就实现了广播消息的功能了。
看到这里,有人是否会有疑问,前面的实现都只用到了集线器对象,而没有用到持久连接对象。其实并不是如此,$.connection这句代码就是使用持久连接对象,当然你也可以在重新OnConnected方法来查看监控客户端的连接情况,更新的代码如下所示:
public class ServerHub : Hub { private static readonly char[] Constant = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; /// <summary> /// 供客户端调用的服务器端代码 /// </summary> /// <param name="message"></param> public void Send(string message) { var name = GenerateRandomName(4); // 调用所有客户端的sendMessage方法 Clients.All.sendMessage(name, message); } /// <summary> /// 客户端连接的时候调用 /// </summary> /// <returns></returns> public override Task OnConnected() { Trace.WriteLine("客户端连接成功"); return base.OnConnected(); } /// <summary> /// 产生随机用户名函数 /// </summary> /// <param name="length">用户名长度</param> /// <returns></returns> public static string GenerateRandomName(int length) { var newRandom = new System.Text.StringBuilder(62); var rd = new Random(); for (var i = 0; i < length; i++) { newRandom.Append(Constant[rd.Next(62)]); } return newRandom.ToString(); } }
这样在运行页面的时候,将在输出窗口看到“客户端连接成功”字样。运行效果如下图所示:
在第二部分介绍的时候说道,在服务端声明的所有Hub信息,都会生成JavaScript输出到客户端,为了验证这一点,可以在Chrome中F12来查看源码就明白了,具体如下图所示:
看到上图,你也就明白了为什么Chat.cshtml页面需要引入"signalr/hubs"脚本库了吧。
<!--引用SignalR库. --> <script src="~/Scripts/jquery.signalR-2.2.0.min.js"></script> <!--引用自动生成的SignalR 集线器(Hub)脚本.在运行的时候在浏览器的Source下可看到 --> <script src="~/signalr/hubs"></script>
四、在桌面程序中如何使用Asp.net SignalR
上面部分介绍了SignalR在Asp.net MVC 中的实现,这部分将通过一个例子来看看SignalR在WPF或WinForm是如何使用的。其实这部分实现和Asp.net MVC中非常相似,主要不同在于,Asp.net MVC中的SignalR服务器寄宿在IIS中,而在WPF中应用,我们把SignalR寄宿在WPF客户端中。
下面让我们看看SignalR服务端的实现。
/// <summary> /// 启动SignalR服务,将SignalR服务寄宿在WPF程序中 /// </summary> private void StartServer() { try { SignalR = WebApp.Start(ServerUri); // 启动SignalR服务 } catch (TargetInvocationException) { WriteToConsole("一个服务已经运行在:" + ServerUri); // Dispatcher回调来设置UI控件状态 this.Dispatcher.Invoke(() => ButtonStart.IsEnabled = true); return; } this.Dispatcher.Invoke(() => ButtonStop.IsEnabled = true); WriteToConsole("服务已经成功启动,地址为:" + ServerUri); } public class ChatHub : Hub { public void Send(string name, string message) { Clients.All.addMessage(name, message); } public override Task OnConnected() { // Application.Current.Dispatcher.Invoke(() => ((MainWindow)Application.Current.MainWindow).WriteToConsole("客户端连接,连接ID是: " + Context.ConnectionId)); return base.OnConnected(); } public override Task OnDisconnected(bool stopCalled) { Application.Current.Dispatcher.Invoke(() => ((MainWindow)Application.Current.MainWindow).WriteToConsole("客户端断开连接,连接ID是: " + Context.ConnectionId)); return base.OnDisconnected(true); } } public class Startup { public void Configuration(IAppBuilder app) { // 有关如何配置应用程序的详细信息,请访问 http://go.microsoft.com/fwlink/?LinkID=316888 // 允许CORS跨域 //app.UseCors(CorsOptions.AllowAll); app.MapSignalR(); } }
通过上面的代码,我们SignalR服务端的实现就完成了,其实现逻辑与Asp.net MVC的代码类似。
接下来,让我们看看,WPF客户端是如何连接和与服务器进行通信的。具体客户端的实现如下:
public IHubProxy HubProxy { get; set; } const string ServerUri = "http://localhost:8888/signalr"; public HubConnection Connection { get; set; } public MainWindow() { InitializeComponent(); // 窗口启动时开始连接服务 ConnectAsync(); } /// <summary> /// 发送消息 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void ButtonSend_Click(object sender, RoutedEventArgs e) { // 通过代理来调用服务端的Send方法 // 服务端Send方法再调用客户端的AddMessage方法将消息输出到消息框中 HubProxy.Invoke("Send", GenerateRandomName(4), TextBoxMessage.Text.Trim()); TextBoxMessage.Text = String.Empty; TextBoxMessage.Focus(); } private async void ConnectAsync() { Connection = new HubConnection(ServerUri); Connection.Closed += Connection_Closed; // 创建一个集线器代理对象 HubProxy = Connection.CreateHubProxy("ChatHub"); // 供服务端调用,将消息输出到消息列表框中 HubProxy.On<string, string>("AddMessage", (name, message) => this.Dispatcher.Invoke(() => RichTextBoxConsole.AppendText(String.Format("{0}: {1}\r", name, message)) )); try { await Connection.Start(); } catch (HttpRequestException) { // 连接失败 return; } // 显示聊天控件 ChatPanel.Visibility = Visibility.Visible; ButtonSend.IsEnabled = true; TextBoxMessage.Focus(); RichTextBoxConsole.AppendText("连上服务:" + ServerUri + "\r"); }
上面的代码也就是WPF客户端实现的核心代码,主要逻辑为,客户端启动的时候就调用Connection.Start方法与服务器进行连接。然后通过HubProxy代理类来调用集线器中Send方法,而集线器中的Send方法又通过调用客户端的addMessage方法将消息输出到客户端的消息框中进行显示,从而完成消息的推送过程。接下来,让我们看看其运行效果:
从上面的运行效果看出,其效果和Asp.net MVC上的效果是一样的。
五、总结
到这里,本专题的所有内容就结束了,这篇SignalR快速入门也是本人在学习SignalR过程中的一些心得体会,希望可以帮助一些刚接触SignalR的朋友快速入门。本篇主要实现了SignalR的广播消息的功能,可以实现手机端消息推送的功能,接下来一篇将介绍如何使用SignalR实现一对一的聊天。
更多Asp.net SignalR快速入门相关文章请关注PHP中文网!