orleans 2.0 教程之-----官方文档翻译,给大家学习ol一个参考

本人也是英文盲,翻译不对的地方请谅解。由于翻译内容较多，会慢慢更新

orleans简称ol，一些专用词不做翻译。先决条件，读这表文章之前需要了解：actor,es,cqrs

参考链接：

https://www.cnblogs.com/netfocus/p/4150084.html

http://www.infoq.com/cn/articles/microservices-aggregates-events-cqrs-part-1-richardson

https://studygolang.com/articles/6250

一.基础开始：

1.使用ol的必要条件：ol是一个来自NuGet的类库。你需要 .NET Core 2.0以上和.NET Framework 4.6.1以上版本才能使用它。在.net core 下ol可以在windows,Linux,MacOS下运行。

目前ol是在windows上测试的,但是许多用户在非Windows平台上也成功运行了ol。

开发工具，建议使用Visual Studio 2017或更高版本。

在生产环境中，为了维护可靠的集群成员关系，ol需要持久化存储。你可以选择以下其中一种

Azure Table Storage 8.2.1或以上版本
SQL Server 2008或以上版本
ZooKeeper 3.4.0或以上版本
MySQL 5.0或以上版本
PostgreSQL 9.5或以上版本
Consul 0.7.0或以上版本
DynamoDB

还有一种办法是使用Azure的service fabric

2.Grains

grains是ol编程模型的关键，grains构成了ol应用，它是隔离的，持久的，分布的。grain就好比.net中的实体对象。grain之间可以通过接口相互调用。

ol的目标是大大简化构建可伸缩应用程序的难度，并避免了大多数并发性问题，grain之间不共享事例，只能通过消息传递。每个grain保证单线程运行

一个典型grain有状态和行为(例如特定的用户或方法或会话)

每一个grain都有一个唯一标识，也称为grain主键。主键可以试long，string ，guid。

如何访问一个grain

一个grain类实现一个或多个grain接口，要调用一个grain，调用者需要知道grain类实现的接口，该接口包括调用者想要调用的方法和目标grain的唯一标识。

例如，如果使用电子邮件作为唯一标识，则可以调用用户配置grain来更新用户地址。

var user = grainFactory.GetGrain<IUserProfile>(userEmail);
await user.UpdateAddress(newAddress);

GetGrain的调用是一种廉价的本地操作，用于构建对目标grain的引用。注意，不需要创建或实例化目标grain，我们调用usergrain来更新地址，就好像usergrain已经实例化了。

这是ol编程模型的最大优势之一我们从来不需要创建、实例化或删除grain。可能有数百万的grain在内存中等待我们调用它，在内部ol能通过一系列复杂的操作来把grain加载到内存中。

grain的生命周期

grain在执行容器里，叫做silo。silo形成一个集群，将多个物理或虚拟机的资源组合在一起，当有对grain请求时，ol确保在集群中的一个silo上有该谷物的实例。如果任何silo上没有grain实例，ol内存管理将创建一个。这个过程叫做激活。

如果grain使用了持久化，在激活时自动从存储器读取状态。一旦在silo上激活，grain处理来自其他grain或来自前端web服务器的传入请求。在处理请求的过程中，grain可以调用其他grain。

如果一个grain停止接收请求并保持空闲，在一段不活动时间后，ol将grain从内存中删除(使其失效)，以释放资源用于其他grain。如果并且当有一个新的grain请求时，ol会再次激活它，可能是在一个不同的silo上激活，

所以调用者会有这样的感觉，grain会一直留在内存中。grain经历了生命周期，从仅作为其存储中的持久化状态(如果有的话)存在，到在内存中实例化，到从内存中删除。

ol能隐式控制grain的激活和停用过程，应此在编写一个grain时，开发人员假设所有gain都被激活。

grain生命周期中的关键事件顺序是这样的：

一个grain或一个客户端调用另一个grain的方法

grain被激活(如果它还没有在集群中的某个地方被激活的话)，grain类的一个实例被创建，称为grain激活

grain的构造函数使用依赖注入(如果适用)来执行，如果声明了持久性，则从存储中读取grain的状态

如果重写，则调用OnActivateAsync（此方法在grain激活时会被调用）

grain处理传入的请求

grain闲置了一段时间

silo内存管理决定停用grain

如果重写OnDeactivateAsync，则调用OnDeactivateAsync（此方法在grain停用时会被调用）
silo内存管理从内存中删除谷物

当一个silo被正确的关闭时，它所拥有的所有grain激活都被停用。在grain队列中等待处理的任何请求都被转发到集群中的其他silo中，在那里，根据需要创建并激活新的停用grain。

请注意，检测silo的故障需要一些时间(这是可配置的)，因此重新激活停用的grain的过程不是立即进行的。