模块 wjybxx.btree.core
程序包 cn.wjybxx.btree.decorator

类 Inverter<T>

java.lang.Object
cn.wjybxx.btree.Task<T>
cn.wjybxx.btree.Decorator<T>
cn.wjybxx.btree.decorator.Inverter<T>
所有已实现的接口:
ICancelTokenListener
public class Inverter<T> extends Decorator<T>
反转装饰器，它用于反转子节点的执行结果。 如果被装饰的任务失败，它将返回成功； 如果被装饰的任务成功，它将返回失败； 如果被装饰的任务取消，它将返回取消。

对于普通的条件节点，可以通过控制流标记直接取反Task.setInvertedGuard(boolean)，避免增加封装。

作者:
wjybxx date - 2023/11/26

  • 构造器详细资料

    • Inverter

      public Inverter()

    • Inverter

      public Inverter(Task<T> child)

  • 方法详细资料

    • enter

      protected void enter(int reentryId)
      从类复制的说明: Task
      该方法在Task进入运行状态时执行 1.数据初始化需要放在Task.beforeEnter()中，避免执行逻辑时对象未初始化完成。 2.如果要初始化子节点，也放到Task.beforeEnter()方法; 3.允许更新自己为完成状态
      覆盖:
      enter 在类中 Task<T>
      参数:
      reentryId - 用于判断父类是否使任务进入了完成状态；虽然也可先捕获再调用超类方法，但传入会方便许多。

    • execute

      protected void execute()
      从类复制的说明: Task
      Task的心跳方法，在Task进入完成状态之前会反复执行。 1.运行中可通过Task.setSuccess()、Task.setFailed(int)、Task.setCancelled()将自己更新为完成状态。 2.如果不想和Task.enter(int)同步执行，可通过Task.setSlowStart(boolean)实现。 3.不建议直接调用该方法，而是通过模板方法Task.template_execute(boolean)运行。
      指定者:
      execute 在类中 Task<T>

    • onChildRunning

      protected void onChildRunning(Task<T> child, boolean starting)
      从类复制的说明: Decorator
      子类如果支持内联，则重写该方法(超类不能安全内联)
      覆盖:
      onChildRunning 在类中 Decorator<T>
      参数:
      starting - 是否是启动时调用，即首次调用

    • onChildCompleted

      protected void onChildCompleted(Task<T> child)
      从类复制的说明: Task
      子节点进入完成状态 1.避免方法数太多，实现类测试task的status即可 2.Task.getNormalizedStatus()有助于switch测试 3.task可能是取消状态，甚至可能没运行过直接失败（前置条件失败） 4.钩子任务和guard不会调用该方法 5.同一子节点连续通知的情况下，completed的逻辑应当覆盖Task.onChildRunning(Task, boolean)的影响。 6.任何的回调和事件方法中都由用户自身检测取消信号
      指定者:
      onChildCompleted 在类中 Task<T>