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

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

这篇文章将会介绍基于Web API的方式调用Grain,但相比Web API,我可能更倾向于gRPC,Web API基于Http,相比RPC性能上会弱一些,RPC方式接口调用上也会更方便,不过这次还是希望装逼的方式可以简单点。有兴趣可以看看这篇文章 跨项目数据共享(跨语言)

-

我们可以基于 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

服务端显示结果

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