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 修改代码如下：

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(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