《通过C#学Proto.Actor模型》之Supervision

Supervision，字面意思是监督，是父Actor发现子Actor有异常发生后，对子Actor产用保种策略处理的机制，如果父Actor不处理，则往上传递。

子Actor发生异常后处理的策略有：

Resume：立即恢复

Restart：恢复之前停止Actor并重新创建它

Stop：停止

Escalate：上报到父级

Supervisor的通过Props.WithChildSupervisorStarategy()来实施的，这个方法第一个参数是接收异常和Actor的PID，以便按一定方式处理异常，第二个参数是重启的次数，第三个参数是两次重启的间隔（按照官方文档，两个连续重启时间大于间隔时间，次数会复位，但实则只按次数走，间隔不起作用）达到最大次数据，子Actor将重新生成。

码友看代码：

 using Proto;
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading.Tasks;

 namespace P006_Supervision
 {
     class Program
     {
         static void Main(string[] args)
         {
             //设置监督策略，指向SupervisiorMode方法，重启次数为3，两次之间间隔1s
             var props = Actor.FromProducer(() => new ShopingCatActor()).WithChildSupervisorStrategy(new OneForOneStrategy(SupervisorMode.Decide, , TimeSpan.FromSeconds()));
             var pid = Actor.Spawn(props);
             var user = new User { UserName = "gsw" };

             var sn = ;
             while (true)
             {
                 Console.WriteLine($"{sn++}--------------------begin-----------------");
                 foreach (var goods in user.ShopingCat.Goodses)
                 {
                     Console.WriteLine(goods);
                 }
                 Console.WriteLine("---------------------end------------------");
                 Console.ReadLine();
                 pid.Request(user, pid);
             }
         }
     }
     /// <summary>
     /// Supervisor 模式
     /// </summary>
     class SupervisorMode
     {
         /// <summary>
         /// 用来处理异常发生的后续操作
         /// </summary>
         /// <param name="pid">PID</param>
         /// <param name="reason">异常原因，Exception类型</param>
         /// <returns></returns>
         public static SupervisorDirective Decide(PID pid, Exception reason)
         {
             Console.WriteLine("   异常发生：" + reason.Message + "   " + pid);
             switch (reason)
             {
                 //重新开始的异常
                 case RecoverableException _:
                     return SupervisorDirective.Restart;
                 //停止异常
                 case FatalException _:
                     return SupervisorDirective.Stop;
                 //其他都上报
                 default:
                     return SupervisorDirective.Escalate;
             }
         }
     }
     /// <summary>
     /// 购物车actor
     /// </summary>
     class ShopingCatActor : IActor
     {
         ShopingCat _shopingCat;
         public ShopingCatActor()
         {
             _shopingCat = new ShopingCat();
             Console.WriteLine("*******************actor ShopingCatActor************************");
         }
         public Task ReceiveAsync(IContext context)
         {
             PID childPid;
             if (context.Children == null || context.Children.Count == )
             {
                 var props = Actor.FromProducer(() => new GoodsActor());
                 childPid = context.Spawn(props);
             }
             else
             {
                 childPid = context.Children.First();
             }
             switch (context.Message)
             {
                 case User user:
                     childPid.Request(_shopingCat, childPid);
                     user.ShopingCat = _shopingCat;
                     break;
             }
             return Actor.Done;
         }
     }
     /// <summary>
     /// 商品actor
     /// </summary>
     class GoodsActor : IActor
     {
         public Task ReceiveAsync(IContext context)
         {
             switch (context.Message)
             {
                 case ShopingCat shopingCat:

                     var goods = new Goods { Name = "红茶", Price = 3.0m, Describe = "统一" };
                     //用来随机产生异常
                     var random = new Random();
                     goods.Quantity = random.Next(, ) - ;
                     if (goods.Quantity <= )
                     {
                         throw new RecoverableException("数量不能小于等于0");
                     }
                     else
                     {
                         shopingCat.Goodses.Add(goods);
                         Console.WriteLine($"添加 {goods} 到购物车里");
                     }
                     break;
             }
             return Actor.Done;
         }
     }
     /// <summary>
     /// 用户
     /// </summary>
     class User
     {
         public ShopingCat ShopingCat { get; set; } = new ShopingCat();
         public string UserName { get; set; }
     }
     /// <summary>
     /// 购物车
     /// </summary>
     class ShopingCat
     {
         public List<Goods> Goodses
         { get; set; } = new List<Goods>();
     }
     /// <summary>
     /// 商品
     /// </summary>
     class Goods
     {
         public string Name { get; set; }

         public int Quantity { get; set; }

         public decimal Price { get; set; }

         public string Describe { get; set; }
         public override string ToString()
         {
             return $"Name={Name}，Quantity={Quantity}，Price={Price}，Describe={Describe}";
         }
     }

 }

Demo中有三个实体类，用户类，购物车类，商品类，他们的关系一目了解，聚合关系。有两个Actor，购物车Actor（ShopingCatActor），商品Actor（GoodsActor），商品Actor是购物车Actor子Actor；ShopingCatActor下有监督策略，在

SupervisorMode下的Decide方法中，处理不同的异常，采用不同的Actor策略。GoodsActor中，添加商品时根据数量来决定是否产生异常。

看运行结果：

注意看ID $1/$2，是在发生四次异常后才生成$1/$3的（这个与文档说法有出入，也许是我理解有问题，是重启3次，不是启动3次）