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

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