一、Reentrant Grains
二、请求上下文
三、激活垃圾收集
四、外部任务和Grains
五、序列化
六、代码生成
七、在Silo内的应用程序引导
八、拦截器
九、取消令牌
十、Powershell客户端
十一、Grains版本控制
十二、Event Sourcing
十三、多群集支持
一、Reentrant Grains
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>
四、外部任务和Grains
五、序列化
六、代码生成
七、在Silo内的应用程序引导
八、拦截器
九、取消令牌
十、Powershell客户端
十一、Grains版本控制
十二、Event Sourcing
十三、多群集支持