Orleans高级功能
一、Reentrant Grains
二、请求上下文
三、激活垃圾收集
四、外部任务和Grains
五、序列化
六、代码生成
七、在Silo内的应用程序引导
八、拦截器
九、取消令牌
十、Powershell客户端
十一、Grains版本控制
十二、Event Sourcing
十三、多群集支持
Grain类有以下两个方法
Task Foo() { await task1; // line 1 return Do2(); // line 2 } Task Bar() { await task2; // line 3 return Do2(); // line 4 }
如果将这个grain标记为[Reentrant]，下面的执行顺序是可能会发生：第1行，第3行，第2行和第4行。
如果将这个grain没有标记为[Reentrant]，唯一可能的执行将是第1行，第2行，第3行，第4行或者第3行第4行第1行第2行（这个grain是单线程执行的）
1，RequestContext包含两个方法：
void Set(string key，object value)用于在请求上下文中存储一个值。该值可以是任何可序列化类型。 Object Get(string key)用于从当前请求上下文中检索一个值
2，例如，要将客户端中的跟踪标识设置为新的GUID，可以简单地调用：
RequestContext.Set("TraceId", new Guid());
在grain代码中(或在调度线程中运行在Orleans的其他代码)，可以使用原始客户机请求的跟踪ID，例如，在写入日志时:
Logger.Info("Currently processing external request {0}", RequestContext.Get("TraceId"));
1,激活垃圾收集的显式控制
①延迟激活GC
grain激活可以通过调用this.DelayDeactivation()方法来延迟自己的激活GC：
protected void DelayDeactivation(TimeSpan timeSpan)
②加快激活GC
通过调用this.DeactivateOnIdle()方法，grain激活还可以指示运行时在下次空闲时停用它。
protected void DeactivateOnIdle()
如果目前没有处理任何消息，则谷物激活被认为是空闲的。 如果在grain正在处理消息时调用DeactivateOnIdle，则当前消息的处理完成后将立即停用。 如果有任何排队等待谷物的请求，它们将被转发到下一个激活。
DeactivateOnIdle优先于配置或DelayDeactivation中指定的任何激活垃圾收集设置。 请注意，此设置仅适用于所谓的grain激活，并不适用于此类grain的其他激活。
2，配置
①编程配置
默认Collection Age Limit（所有grain类型）可以通过以下方式设置：
void GlobalConfiguration.Application.SetDefaultCollectionAgeLimit(TimeSpan ageLimit)
对于单独的grain类型，限制可以通过以下方式设置：
void GlobalConfiguration.Application.SetCollectionAgeLimit(Type type, TimeSpan ageLimit)
该限制也可以为grain类型重置，所以默认限制将适用于它，通过：
void GlobalConfiguration.Application.ResetCollectionAgeLimitToDefault(Type type)
②XML配置（不建议使用）
配置XML文件中的任何时间长度都可以使用指定时间单位的后缀：
| 后缀 | 单位 |
|---|---|
| none | millisecond(s) |
| ms | millisecond(s) |
| s | second(s) |
| m | minute(s) |
| hr | hour(s) |
指定默认收集年龄限制
通过将OrleansConfiguation / Globals / Application / Defaults / Deactivation元素添加到OrleansConfiguration.xml文件，可以自定义适用于所有grain类型的默认集合期限。 允许的最低年龄限制是1分钟。
以下示例指定已空闲10分钟或更长时间的所有激活应被视为取消激活的条件。
<?xml version="1.0" encoding="utf-8"?> <OrleansConfiguration xmlns="urn:orleans"> <Globals> <Application> <Defaults> <Deactivation AgeLimit="10m"/> </Defaults> </Application> </Globals> </OrleansConfiguration>
指定每个类型的年龄限制
单个grain类型可以使用OrleansConfiguation / Globals / Application / GrainType / Deactivation元素来指定独立于全局默认的集合年龄限制。 允许的最低年龄限制是1分钟。
在以下示例中，空闲10分钟的激活有资格进行收集，除MyGrainAssembly.DoNotDeactivateMeOften类实例化的激活之外，除非空闲整整24小时，否则不被视为可收集：
<?xml version="1.0" encoding="utf-8"?> <OrleansConfiguration xmlns="urn:orleans"> <Globals> <Application> <Defaults> <Deactivation AgeLimit="10m"/> </Defaults> <GrainType Type="MyGrainAssembly.DoNotDeactivateMeOften"> <Deactivation AgeLimit="24hr"/> </GrainType> </Application> </Globals> </OrleansConfiguration>
