Orleans入门例子

Orleans入门例子

　　这是Orleans系列文章中的一篇.首篇文章在此

 一.铺垫。

　　虽然是个入门例子，还是需要一些铺垫。

Orleans的最小完全体，应该分为2个部分。一个是Orleans客户端，一个是Orleans服务端，这里为什么要加上“Orleans”这个限定词语呢？那是因为Orleans的完全体，才是普通意义上的服务端主程。它们共同构成了游戏服务器，网站服务器等等。

在Orleans客户端中，我们使用GrainClient类以及Grain类，在Orleans服务端内，我们主要使用silo类和grain类。这里要说说Silo类，前面说过Grain类是处于“单线程机制”约束下的类，那么它们运行在哪个地方呢？就是Silo类所在的地方。Silo类是Grain地代码实际执行的地方，它是Grain类的宿主，它承载着所有的Grain实例，也许是几百万个Grain实例。在一些语境下,silo,silohost,以及Orleans服务端,这三个词语有可能代表同一个意思.

一个外部请求的处理大部分情况下需要很多个Grain实例，进行一连串的方法调用后才能处理完毕，这些Grain实例形成一个处理消息的链条，这个消息流走于Grain链内直至处理完毕。那么这个消息是如何第一次到达Grain链条里呢？GrainClient类的作用就是入口，它通知Silo类，有新消息达到，它需要哪个Grain类实例，需要调用特定的方法等。

经过以上铺垫，要想创造一个Orleans完全体，我来用vs2017创建一个解决方案，里面添加4个项目：Client，Host，Grains，IGrains。它们的作用分别解释如下：

1. Client：这个显而易见，里面就是要运行GrainClient的。它要和Host通信，这就要求它引用IGrains项目。这是个控制台项目
2. Host：这个也是显而易见，里面就是要运行Silo的。它应该引用Grains项目以及IGrains项目，因为它要承载Grain（这就要求引用Grains类），并且需要Grain实例间的通信（这就要求引用IGrains项目），这是个控制台项目
3. Grains：这个里面实现所有IGrain载明的接口，实现所有的Grain类，包括它们的方法以及字段。（它要求引用IGrain。。。废话）这是个类库项目
4. IGrains：这里放置所有Grains类要扩展的接口。这是个类库项目。

　　同时为了使用Orleans框架，我们还需要引用Orleans的类库，官方教程里有方案，不过，我们采用简单的办法，统一引用一个类库集合，下文有述。

　　好吧，以上解释不管懂与不懂，你就暂且记下，先按照步骤一步一步来吧。也许某个阶段，你就突然懂了。我相信在读的各位对这种醍醐灌顶的感觉一定不陌生。

　　按照以上套路，我开始了我的工作，我打算跟世界say Hi：

　　二.创建

　　我创建了四个项目的解决方案，它长成这个样子,注意它们的.net框架版本都是4.6.1：

　　

　　好了我们要引用Orleans类库啦，说了半天，终于要主角登场啦，好激动，所以我nuget引用了Microsoft.Orleans.Server，它长这样子：

　　

　　里面没有实际内容，我现在先弄IGrains，它很简单，就一个接口一个方法：长成这样：

　　

　　我再弄Grains项目：它就是要实现IGrains项目里的接口,所以先引用哪个项目,然后实现它，长这样子。

　　

　　我再实现Client项目，它需要引用IGrains项目,它长这样子：

　　

　　最后是Host类，它长这样子：

　　

　　现在我高兴的运行这个Orleans完全体，它再一连串的日志记录之后，跳出了 hello world如下图

　　…我成功地创造了Orleans地完全体。好了全系列文章到此结束。

　　再见

 补充

　　噢，我还需要补充一下下。

　　搞了半天，闹这么大动静，就写了个简版的WCF？并不是，这里只是展示了码Orleans的主要步骤。这里有几个要点需要解释一下：

1.IGrains的所有接口方法，必须是返回Task类的。这个是必须的，因为Orleans的“单线程机制”，是建立在Task类之上的。它是利用TaskScheduler类，实现“单线程机制”的。啥？有人问怎么实现的？你确信自己入门教程还没有看完就想知道?…以后再说吧。反正接口的方法，必须是返回Task。

2.IGrains接口扩展自IGrainWithInteger接口，这个IGrainWithInteger接口是Orleans提供的，之前说过，Grain实例之间需要通信，这就需要彼此区分，要有各自的主标识。这个接口，就规定了主标识是长整数（名字是整数，但是实际上是长整数）。Grain实例的主标识还可以是其他类型：比如字符串和Guid等等。

3.Grains项目中，实现了我规定的接口，就表明自己的主标识是长整数，它又扩展自Grain类，就表明自己受“单线程机制”约束了

4.Host项目，只是引用了Grains项目，但是没有再代码中具体使用。它如何知道自己要承载哪些Grain类？Host利用反射检查所有目录里的类库文件，如果找到grain类，它就加载，并管理起来

5.GrainClient有静态的，有动态的类，我这里先使用静态类讲解。动态类其实一样。我调用的时候，使用一个参数“12345”。就是要告诉Host。我要激活主标识是12345的Grain类实例。然后又调用了它的say方法。它聪明的再host的控制台窗口打印出say hello。

　　　

　　到现在，我们就明白了，再Orleans的世界里，给grain发送消息，实质上是调用对应的接口，grain实例接收到消息以后，使用对应的方法进行处理。（吃瓜群众：这不就是一个RPC框架嘛…呵呵。）

　　在这个简单的例子里，展现出的东西还有很多，不过今天很晚了，打完收工。明天继续说说这个例子展现的内容。