一. 说在前面的话
本节主要在前面章节的基础上补充了几个简单的知识点,比如:第三方调用通过 GlobalHost.ConnectionManager.GetHubContext<MySpecHub1>();来获取Hub对象,那么能不能封装一下不必每次都这么获取呢?再比如SignalR传输是否有大小限制,一下传输10w个字能否传输成功?最后着重整理一下跨域的各种使用情况,结合C/S程序充当客户端和服务器端。
本节内容包括:
①. SignalR与MVC或者WebApi简单的整合。
②. 全局的几个配置。
③. 跨域的配置和应用。
④. C/S程序充当客户端或服务器端。
二. SignalR与MVC的简单整合
在前面的章节中我们已经知道,如果要通过控制器中的Action来实现通讯,需要通过 GlobalHost.ConnectionManager.GetHubContext<MySpecHub1>(); 来获取Hub类,但是每个Action中都这么获取,显得有点麻烦,这里简单封装一下,来便捷开发。
分析:实质在我们在Action中用到的对象无非也就这两个,IHubConnectionContext<dynamic> Clients 和 IGroupManager Groups ,所以这里利用继承的关系简单的封装一下,声明BaseController类,在里面获取这两个对象,然后其它控制器继承BaseController,并传入对应的Hub类,这样在Action中就可以直接使用 Clients和Groups了。
PS:WepAPI程序可以采用下面类似方式进行封装。
BaseController代码展示:
/// <summary>
/// 整合MVC和SignalR
/// </summary>
public class BaseController<T> : Controller where T : Hub
{
public IHubConnectionContext<dynamic> Clients { get; set; } public IGroupManager Groups { get; set; } public BaseController()
{
var hub = GlobalHost.ConnectionManager.GetHubContext<T>();
Clients = hub.Clients;
Groups = hub.Groups;
}
}
继承BaseController的代码展示:
public class HubController : BaseController<MySpecHub1>
{ /// <summary>
/// 向所有人发送消息
/// </summary>
/// <param name="myConnectionId">当前用户的登录标记</param>
/// <param name="msg">发送的信息</param>
public string MySendAll(string myConnectionId, string msg)
{
//Hub模式
Clients.AllExcept(myConnectionId).receiveMsg($"用户【{myConnectionId}】发来消息:{msg}");
return "ok";
} }
三. 全局的几个配置
这里的全局配置主要包括:传输超时时间、强制关闭时间、WebSocket模式下允许传输的数据最大值等等,以下配置代码可以在Configuration方法中进行配置,可以根据实际业务情况自行选择配置。
1. 表示客户端在转而使用其他传输或连接失败之前应允许连接的时间。默认值为 5 秒。(传输超时时间)
GlobalHost.Configuration.TransportConnectTimeout = TimeSpan.FromSeconds(5);
2. 表示连接在超时之前保持打开状态的时间
GlobalHost.Configuration.ConnectionTimeout= TimeSpan.FromSeconds(5);
3. 用于表示在连接停止之后引发断开连接事件之前要等待的时间。 (强制关闭时间)
GlobalHost.Configuration.DisconnectTimeout = TimeSpan.FromSeconds(5);
4. 表示两次发送保持活动消息之间的时间长度。如果启用,此值必须至少为两秒。设置为 null 可禁用。
GlobalHost.Configuration.KeepAlive = TimeSpan.FromSeconds(2);
5. Websocket模式下允许传输数据的最大值,默认为64kb
GlobalHost.Configuration.MaxIncomingWebSocketMessageSize = 64;
PS:设置消息缓冲区大小
GlobalHost.Configuration.DefaultMessageBufferSize = 500;
(默认情况下,SignalR 将保留在内存中的每个中心的每个连接的 1000 条消息。 如果使用大型消息时,这可能会造成内存问题,这可以通过减小此值来缓解压力)
四. 跨域的应用
在很多情况下,前后端是分离,客户端和服务器端并不在一个地址下,比如APP(这里指混合开发能使用JS的情况下),这个时候服务器的SignalR就需要配置允许跨域,这里有两种允许跨域的策略,一种是JSONP模式,另外一种是Cors模式。
在Startup类中的Configuration方法中进行配置,代码如下:
public class Startup
{
public void Configuration(IAppBuilder app)
{
//配置允许跨域
//1. JSONP模式
//app.MapSignalR(new HubConfiguration() { EnableJSONP = true }); //2. Cors模式(需要安装Microsoft.Owin.Cors程序集)
app.UseCors(CorsOptions.AllowAll).MapSignalR();
}
}
注:采用Cors模式的跨域需要安装:Microsoft.Owin.Cors 程序集,并且上述代码没有单独配置模型路径,所以采用的是默认路径“/signalr”。
当然前端代码也需要进行相应的改写:
(1). 代理模式的改写形式:
a. 自动生成代理类代码需要改写为 <script src="http://localhost:7080/signalr/hubs"></script> ,localhost:7080,根据实际情况改为实际地址。
b. 需要单独配置一下Hub的连接路径, conn.url = "http://localhost:7080/signalr";
以上两步即为全部改变,其余位置不需变化。
(2). 非代理模式下的代码:
非代理模式下就更容易,只需要在hubConnection方法中传入路径即可。如下图:
五. C/S程序充当客户端
C/S程序(这里采用控制台)充当客户端,当然服务器端必须已经配置了允许跨域,且C/S程序是没有JS的,所以只能采用非代理模式。
步骤如下:
1:安装程序集 Microsoft.AspNet.SignalR.Client
2:代码配置
a. 与服务器路径匹配的时候要注意,默认路径的话,要加上signalr/
b. 如果定义的方法大于一个参数的时候,需要声明一个类来接收
eg:Proxy.On<Person>("方法名", Person=>
Console.WriteLine("ID{0} Name{1}", Person.ID, Person.Name));
代码如下:
class Program
{
static void Main(string[] args)
{ //一. 基础信息配置
//1. 与服务器路径进行匹配
var conn = new HubConnection("http://localhost:8099/signalr/");
//2. 创建代理类
var proxy = conn.CreateHubProxy("MySpecHub1"); //二. 定义客户端的方法
//特别注意,如果定义的方法大于一个参数的时候,msg的位置需要声明一个类来接受
//1 接受用户登录成功后的提示 proxy.On("LoginSuccessNotice", (msg) =>
{
Console.WriteLine(msg);
}); //2 接收自己的connectionId
proxy.On("ReceiveOwnCid", (msg) =>
{
Console.WriteLine(msg);
}); //三. 启动
conn.Start().Wait(); Console.ReadKey(); }
}
六. C/S程序充当服务器端
在很多情况下,我们需要避免使用IIS的性能开销,或者要将SignalR部署成Windows服务,这个使用就需要使用C/S程序作为服务器端了。
配置步骤比较简单,如下:
1. 安装程序集:Microsoft.AspNet.SignalR.SelfHost 和 Microsoft.Owin.Cors(跨域使用)
2. 添加集线器类MySpecHub1
3. 在Startup中配置允许跨域
4. 编写启动代码
PS:以上步骤2和步骤3在前面章节中已经多次提到过了,这里指展示一下启动代码:
static void Main(string[] args)
{
try
{
string url = "http://localhost:7080";
using (WebApp.Start<Startup>(url))
{
Console.WriteLine("Server running on {0}", url);
Console.ReadLine();
}
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
Console.ReadKey();
}
特别注意:如果报System.Reflection.TargetInvocationException was unhandled,直接去bin文件里以管理员身份运行exe程序即可或者以管理员身份运行VS程序然后启动即可。
!
- 作 者 : Yaopengfei(姚鹏飞)
- 博客地址 : http://www.cnblogs.com/yaopengfei/
- 声 明1 : 本人才疏学浅,用郭德纲的话说“我是一个小学生”,如有错误,欢迎讨论,请勿谩骂^_^。
- 声 明2 : 原创博客请在转载时保留原文链接或在文章开头加上本人博客地址,否则保留追究法律责任的权利。