英文渣水平,大伙湊合著看吧……
這是微軟官方SignalR 2.0教程Getting Started with asp.net SignalR 2.0系列的翻譯,這里是第六篇:SignalR 自托管主機
原文:SignalR Self-Host
PS.前面的那篇在MVC5上使用SignalR跳過了……MVC5跟HTML的實現完全一樣,只是將HTML的腳本放在View里面了,這里就跳過了。有興趣的同學可以自己去看。
SignalR服務器通常在IIS的ASP.NET應用程序上承載,但它也可以使用自托管庫來作為自托管的主機(就像控制臺應用或者Windows服務那樣)。與SignalR 2.0一樣,自托管庫是基于.Net開放式Web接口(OWIN)來構建的。OWIN定義了.Net Web服務器和Web應用程序之間的抽象接口,將Web應用程序從服務器上解耦,使得OWIN可以在IIS之外建立自托管主機。
為什么不在IIS中托管?參考以下理由:
如果為了性能考慮而是用SignalR自托管主機,建議對IIS中承載的應用程序進行測試,以確定性能確實得到了提高。
在本教程中,您將創建托管在控制臺應用程序中的服務器,當然將其承載在Windows服務及Azure工作角色中也是可行的。
1.以管理員權限運行VS2013,新建一個控制臺應用程序,命名為"SignalRSelfHost"并確定。
2.打開程序包管理器控制臺。
3.在控制臺中輸入以下命令:
Install-Package Microsoft.AspNet.SignalR.SelfHost
此命令將SignalR自托管庫添加到項目中。
4.繼續在控制臺中輸入以下命令:
Install-Package Microsoft.Owin.Cors
此命令將OWIN核心庫添加到項目中,因為SignalR主機與網頁客戶端之間在不同的域中運行,該庫將用于跨域支持。由于SignalR服務和Web客戶端運行在不同的端口上,這意味如果想在這些組件間進行通訊,則必須啟動這些組件中的跨域功能。5.替換PRogram.cs中的代碼:
1 using System; 2 using Microsoft.AspNet.SignalR; 3 using Microsoft.Owin.Hosting; 4 using Owin; 5 using Microsoft.Owin.Cors; 6 7 namespace SignalRSelfHost 8 { 9 class Program10 {11 static void Main(string[] args)12 {13 // This will *ONLY* bind to localhost, if you want to bind to all addresses14 // use http://*:8080 to bind to all addresses. 15 // See http://msdn.microsoft.com/en-us/library/system.net.httplistener.aspx 16 // for more information.17 string url = "http://localhost:8080";18 using (WebApp.Start(url))19 {20 Console.WriteLine("Server running on {0}", url);21 Console.ReadLine();22 }23 }24 }25 class Startup26 {27 public void Configuration(IAppBuilder app)28 {29 app.UseCors(CorsOptions.AllowAll);30 app.MapSignalR();31 }32 }33 public class MyHub : Hub34 {35 public void Send(string name, string message)36 {37 Clients.All.addMessage(name, message);38 }39 }40 }
上面的代碼包含了三個類:
6.編譯并運行,服務器的地址將顯示在控制臺窗口中。
7.如果執行失敗,除了發生System.Reflection.TargetInvocationException錯誤,你需要以管理員權限重新運行VS2013并執行。
8.在進行下一步前,關閉控制臺應用程序。
在本節中,您將使用同入門教程一致的JS客戶端。我們只進行一項修改,即定義集線器的URL,作為自托管主機,服務器并不一定在相同的URL作為連接地址(由于反向代理及負載平衡),所以URL需要顯示定義。
1.在解決方案資源管理器中,添加ASP.NET Web應用程序,命名為"JavascriptClient",然后確定。
2.以空模板創建項目。
3.在包管理器控制臺中,在默認項目的下拉列表中選擇“JavascriptClient”項目,并執行以下命令:
Install-Package Microsoft.AspNet.SignalR.JS
此命令安裝客戶端所需要的SignalR及jQuery庫。
4.添加一個新的HTML頁面,命名為Default.HTML。
5.用下面的代碼替換HTML中的內容,同樣需要確認代碼中腳本引用的版本路徑是否一致。
1 <!DOCTYPE html> 2 <html> 3 <head> 4 <title>SignalR Simple Chat</title> 5 <style type="text/CSS"> 6 .container { 7 background-color: #99CCFF; 8 border: thick solid #808080; 9 padding: 20px;10 margin: 20px;11 }12 </style>13 </head>14 <body>15 <div class="container">16 <input type="text" id="message" />17 <input type="button" id="sendmessage" value="Send" />18 <input type="hidden" id="displayname" />19 <ul id="discussion"></ul>20 </div>21 <!--Script references. -->22 <!--Reference the jQuery library. -->23 <script src="Scripts/jquery-1.6.4.min.js"></script>24 <!--Reference the SignalR library. -->25 <script src="Scripts/jquery.signalR-2.0.2.min.js"></script>26 <!--Reference the autogenerated SignalR hub script. -->27 <script src="http://localhost:8080/signalr/hubs"></script>28 <!--Add script to update the page and send messages.-->29 <script type="text/javascript">30 $(function () {31 //Set the hubs URL for the connection32 $.connection.hub.url = "http://localhost:8080/signalr";33 34 // Declare a proxy to reference the hub.35 var chat = $.connection.myHub;36 37 // Create a function that the hub can call to broadcast messages.38 chat.client.addMessage = function (name, message) {39 // Html encode display name and message.40 var encodedName = $('<div />').text(name).html();41 var encodedMsg = $('<div />').text(message).html();42 // Add the message to the page.43 $('#discussion').append('<li><strong>' + encodedName44 + '</strong>: ' + encodedMsg + '</li>');45 };46 // Get the user name and store it to prepend to messages.47 $('#displayname').val(prompt('Enter your name:', ''));48 // Set initial focus to message input box.49 $('#message').focus();50 // Start the connection.51 $.connection.hub.start().done(function () {52 $('#sendmessage').click(function () {53 // Call the Send method on the hub.54 chat.server.send($('#displayname').val(), $('#message').val());55 // Clear text box and reset focus for next comment.56 $('#message').val('').focus();57 });58 });59 });60 </script>61 </body>62 </html>63
注意此行代碼聲明了SignalR的基礎連接URL。
$.connection.hub.url = "http://localhost:8080/signalr";
6.在解決方案上右擊,設置多個啟動項目為啟動。
7.在Default.Html上右擊,選擇設為起始頁。
8.運行該項目,將彈出控制臺服務器及Web頁面,如果Web頁面在控制臺服務器啟動前就執行,你需要重新刷新一次頁面。
9.你可以輸入用戶名,打開多個瀏覽器來進行多用戶的聊天室測試了。
作者:帕特里克·弗萊徹-帕特里克·弗萊徹是ASP.NET開發團隊的程序員,作家,目前正在SignalR項目工作。
新聞熱點
疑難解答