Orleans 解决并发之痛(五):Web API

通过前面几篇文章的介绍,可能会疑问怎么在实际开发中调用 Grain,之前 Demo 的 Client 都是基于控制台应用程序,实际开发下可能是基于 Web Form、Web API、MVC……,由于一时短路了,没有联想到控制台应用程序的方式怎么切到其他方式调用。

这篇文章将会介绍基于 Web API 的方式调用 Grain,但相比 Web API,我可能更倾向于 gRPC,Web API 基于 Http,相比 RPC 性能上会弱一些,RPC 方式接口调用上也会更方便,不过这次还是希望装逼的方式可以简单点。有兴趣可以看看这篇文章 ASP.NET 微服务:gRPC

-

我们可以基于 Demo-OrleansState 来调整代码:

  1. 将 Client 控制台程序删除;
  2. 新建解决方案文件夹 Orleans,并将 Grains、Interfaces、Silo 程序集移到文件夹内,这样看上去清晰一点;
  3. 创建类库 Business,普通的业务逻辑代码;
  4. 创建空的 Web API 项目;

注意: Silo 目前依然是控制台应用程序。
如果项目是基于 .NET Framework,之后可以将 Silo 使用 Topshelf 以 Windows 服务方式部署;如果是基于 .NET Core,可以使用 Docker 来部署;据官方提供的 Sample HelloWorld.NetCore,Orleans 2.0.0 将支持 .NET Core,目前是 1.5.0。

项目结构:

项目代码结构

依赖引用:
程序集名称 类型 NuGet 依赖包
Microsoft.Orleans.
引用
Business 类库 Core Interfaces
WebAPI Web API Core
OrleansCodeGenerator
Business

依赖引用关系图

配置连接 Silo:

WebAPI 项目在启动的时候,需要同时连接上 Silo,才能调用 Grain 里面的方法。ClientConfiguration.xml 和之前的控制台程序一样即可,在 Global.asax 的 Application_Start 修改代码如下:

1
2
3
4
5
6
protected void Application_Start()
{
var config = ClientConfiguration.LoadFromFile(Server.MapPath(@"~/ClientConfiguration.xml"));
GrainClient.Initialize(config);
System.Web.Http.GlobalConfiguration.Configure(WebApiConfig.Register);
}
Business 调用 Grain:
1
2
3
4
5
6
7
8
9
public class Persion
{
public string SayHello(string name)
{
var grain = GrainClient.GrainFactory.GetGrain<IPersonGrain>(name);
grain.SayHelloAsync();
return "success";
}
}
WebAPI 调用 Business 层方法:
1
2
3
4
5
6
7
8
public class PersonController : ApiController
{
[HttpGet]
public string SayHello(string name)
{
return new Business.Persion().SayHello(name);
}
}

根据实际接口定义规范,修改 WebApiConfig.cs,假设 routeTemplate 配置如下:

1
routeTemplate: "api/{controller}/{action}"

测试:

启动 Silo 和 WebAPI 后,在浏览器内数据地址:

1
http://localhost:{WebAPI 启动的端口号}/api/person/sayHello?name=beck

服务端显示结果

参考链接:
如果对你有帮助就好