通过前面几篇文章的介绍,可能会疑问怎么在实际开发中调用 Grain,之前 Demo 的 Client 都是基于控制台应用程序,实际开发下可能是基于 Web Form、Web API、MVC......,由于一时短路了,没有联想到控制台应用程序的方式怎么切到其他方式调用。
这篇文章将会介绍基于 Web API 的方式调用 Grain,但相比 Web API,我可能更倾向于 gRPC,Web API 基于 Http,相比 RPC 性能上会弱一些,RPC 方式接口调用上也会更方便,不过这次还是希望装逼的方式可以简单点。有兴趣可以看看这篇文章 ASP.NET 微服务:gRPC 。
我们可以基于 Demo-OrleansState 来调整代码:
- 将 Client 控制台程序删除;
- 新建解决方案文件夹 Orleans,并将 Grains、Interfaces、Silo 程序集移到文件夹内,这样看上去清晰一点;
- 创建类库 Business,普通的业务逻辑代码;
- 创建空的 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