通過前面幾篇文章的介紹,可能會(huì)疑問怎么在實(shí)際開發(fā)中調(diào)用 Grain县习,之前 Demo 的 Client 都是基于控制臺(tái)應(yīng)用程序作谚,實(shí)際開發(fā)下可能是基于 Web Form忆家、Web API、MVC......全蝶,由于一時(shí)短路了闹蒜,沒有聯(lián)想到控制臺(tái)應(yīng)用程序的方式怎么切到其他方式調(diào)用。
這篇文章將會(huì)介紹基于 Web API 的方式調(diào)用 Grain抑淫,但相比 Web API绷落,我可能更傾向于 gRPC,Web API 基于 Http始苇,相比 RPC 性能上會(huì)弱一些砌烁,RPC 方式接口調(diào)用上也會(huì)更方便,不過這次還是希望裝逼的方式可以簡(jiǎn)單點(diǎn)催式。有興趣可以看看這篇文章 ASP.NET 微服務(wù):gRPC 函喉。
我們可以基于 Demo-OrleansState 來調(diào)整代碼:
- 將 Client 控制臺(tái)程序刪除避归;
- 新建解決方案文件夾 Orleans,并將 Grains函似、Interfaces槐脏、Silo 程序集移到文件夾內(nèi),這樣看上去清晰一點(diǎn)撇寞;
- 創(chuàng)建類庫 Business顿天,普通的業(yè)務(wù)邏輯代碼;
- 創(chuàng)建空的 Web API 項(xiàng)目蔑担;
注意: Silo 目前依然是控制臺(tái)應(yīng)用程序牌废。
如果項(xiàng)目是基于 .NET Framework,之后可以將 Silo 使用 Topshelf 以 Windows 服務(wù)方式部署啤握;如果是基于 .NET Core鸟缕,可以使用 Docker 來部署;據(jù)官方提供的 Sample HelloWorld.NetCore排抬,Orleans 2.0.0 將支持 .NET Core懂从,目前是 1.5.0。
項(xiàng)目結(jié)構(gòu):
依賴引用:
程序集名稱 | 類型 | NuGet 依賴包 Microsoft.Orleans. |
引用 |
---|---|---|---|
Business | 類庫 | Core | Interfaces |
WebAPI | Web API | Core OrleansCodeGenerator |
Business |
配置連接 Silo:
WebAPI 項(xiàng)目在啟動(dòng)的時(shí)候蹲蒲,需要同時(shí)連接上 Silo番甩,才能調(diào)用 Grain 里面的方法。ClientConfiguration.xml 和之前的控制臺(tái)程序一樣即可届搁,在 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ù)實(shí)際接口定義規(guī)范缘薛,修改 WebApiConfig.cs,假設(shè) routeTemplate 配置如下:
routeTemplate: "api/{controller}/{action}"
測(cè)試:
啟動(dòng) Silo 和 WebAPI 后卡睦,在瀏覽器內(nèi)數(shù)據(jù)地址:
http://localhost:{WebAPI 啟動(dòng)的端口號(hào)}/api/person/sayHello?name=beck