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。

项目结构：

项目代码结构

依赖引用：

依赖引用关系图

配置连接 Silo：

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

protected void Application_Start()
{
  var config = ClientConfiguration.LoadFromFile(Server.MapPath(@"~/ClientConfiguration.xml"));
  GrainClient.Initialize(config);
  System.Web.Http.GlobalConfiguration.Configure(WebApiConfig.Register);
}

Business 调用 Grain：

public class Persion
{
  public string SayHello(string name)
  {
    var grain = GrainClient.GrainFactory.GetGrain<IPersonGrain>(name);
    grain.SayHelloAsync();
    return "success";
  }
}

WebAPI 调用 Business 层方法：

public class PersonController : ApiController
{
  [HttpGet]
  public string SayHello(string name)
  {
    return new Business.Persion().SayHello(name);
  }
}

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

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

测试：

启动 Silo 和 WebAPI 后，在浏览器内数据地址：

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

服务端显示结果

参考链接：

• Actor 模型
• Orleans
• 案例 Demo-OrleansWebAPI