通過前面幾篇文章的介紹,可能會疑問怎么在實際開發(fā)中調(diào)用 Grain,之前 Demo 的 Client 都是基于控制臺應(yīng)用程序,實際開發(fā)下可能是基于 Web Form、Web API、MVC......,由于一時短路了,沒有聯(lián)想到控制臺應(yīng)用程序的方式怎么切到其他方式調(diào)用。
這篇文章將會介紹基于 Web API 的方式調(diào)用 Grain,但相比 Web API,我可能更傾向于 gRPC,Web API 基于 Http,相比 RPC 性能上會弱一些,RPC 方式接口調(diào)用上也會更方便,不過這次還是希望裝逼的方式可以簡單點。有興趣可以看看這篇文章 ASP.NET 微服務(wù):gRPC 。

我們可以基于 Demo-OrleansState 來調(diào)整代碼:
- 將 Client 控制臺程序刪除;
- 新建解決方案文件夾 Orleans,并將 Grains、Interfaces、Silo 程序集移到文件夾內(nèi),這樣看上去清晰一點;
- 創(chuàng)建類庫 Business,普通的業(yè)務(wù)邏輯代碼;
- 創(chuàng)建空的 Web API 項目;
注意: Silo 目前依然是控制臺應(yīng)用程序。
如果項目是基于 .NET Framework,之后可以將 Silo 使用 Topshelf 以 Windows 服務(wù)方式部署;如果是基于 .NET Core,可以使用 Docker 來部署;據(jù)官方提供的 Sample HelloWorld.NetCore,Orleans 2.0.0 將支持 .NET Core,目前是 1.5.0。
項目結(jié)構(gòu):

依賴引用:
| 程序集名稱 | 類型 | NuGet 依賴包 Microsoft.Orleans. |
引用 |
|---|---|---|---|
| Business | 類庫 | Core | Interfaces |
| WebAPI | Web API | Core OrleansCodeGenerator |
Business |

配置連接 Silo:
WebAPI 項目在啟動的時候,需要同時連接上 Silo,才能調(diào)用 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 調(diào)用 Grain:
public class Persion
{
public string SayHello(string name)
{
var grain = GrainClient.GrainFactory.GetGrain<IPersonGrain>(name);
grain.SayHelloAsync();
return "success";
}
}
WebAPI 調(diào)用 Business 層方法:
public class PersonController : ApiController
{
[HttpGet]
public string SayHello(string name)
{
return new Business.Persion().SayHello(name);
}
}
根據(jù)實際接口定義規(guī)范,修改 WebApiConfig.cs,假設(shè) routeTemplate 配置如下:
routeTemplate: "api/{controller}/{action}"
測試:
啟動 Silo 和 WebAPI 后,在瀏覽器內(nèi)數(shù)據(jù)地址:
http://localhost:{WebAPI 啟動的端口號}/api/person/sayHello?name=beck
