模块 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

字段概要

从类继承的字段 cn.wjybxx.btree.Decorator

child, inlineHelper

从类继承的字段 cn.wjybxx.btree.Task

blackboard, cancelToken, flags, logger, MASK_AUTO_LISTEN_CANCEL, MASK_AUTO_RESET_CHILDREN, MASK_BLACKBOARD_PER_CHILD, MASK_CANCEL_TOKEN_PER_CHILD, MASK_CONTROL_FLOW_OPTIONS, MASK_DISABLE_CHECK_CANCEL, MASK_INVERTED_GUARD, MASK_SLOW_START, MASK_TAIL_CALL_RECURSION, sharedProps

构造器概要

构造器

构造器	说明
Inverter()
Inverter(Task<T> child)

方法概要

修饰符和类型	方法	说明
protected void	execute()	Task的心跳方法，在Task进入完成状态之前会反复执行。
protected void	onChildCompleted(Task<T> child)	子节点进入完成状态 1.避免方法数太多，实现类测试task的status即可 2.Task.getNormalizedStatus()有助于switch测试 3.task可能是取消状态，甚至可能没运行过直接失败（前置条件失败） 4.钩子任务和guard不会调用该方法 5.Task.isExecuting()有助于检测冲突，减少调用栈深度 6.同一子节点连续通知的情况下，completed的逻辑应当覆盖Task.onChildRunning(Task)的影响。
protected void	onChildRunning(Task<T> child)	子类如果支持内联，则重写该方法

从类继承的方法 cn.wjybxx.btree.Decorator

addChildImpl, beforeEnter, childStream, exit, getChild, getChild, getChildCount, getInlineHelper, indexChild, onEventImpl, removeChildImpl, resetForRestart, setChild, setChildImpl, stopRunningChildren

从类继承的方法 cn.wjybxx.btree.Task

addChild, canHandleEvent, checkCancel, enter, exportControlFlowOptions, getBlackboard, getCancelToken, getControl, getControlData, getControlFlowOptions, getEnterFrame, getEntity, getExitFrame, getFlags, getGuard, getNormalizedStatus, getPrevStatus, getReentryId, getRunFrames, getSharedProps, getStatus, getTaskEntry, isActiveInHierarchy, isActiveSelf, isAutoListenCancel, isAutoResetChildren, isBlackboardPerChild, isCancelled, isCancelTokenPerChild, isCompleted, isDisableCheckCancel, isExecuteTriggeredByEnter, isExecuting, isExited, isExitTriggeredByStop, isFailed, isFailedOrCancelled, isInlinable, isInvertedGuard, isRunning, isSlowStart, isStillborn, isSucceeded, isTailRecursion, onCancelRequested, onEvent, refreshActiveInHierarchy, refreshChildrenActiveInHierarchy, registerCancelListener, removeAllChild, removeChild, removeChild, resetChildrenForRestart, resetForRestart, setActive, setAutoListenCancel, setAutoResetChildren, setBlackboard, setBlackboardPerChild, setCancelled, setCancelToken, setCancelTokenPerChild, setChild, setChildCancelToken, setCompleted, setControl, setControlData, setDisableCheckCancel, setEnterFrame, setExitFrame, setFailed, setFlags, setGuard, setGuardFailed, setInvertedGuard, setPrevStatus, setSharedProps, setSlowStart, setSuccess, setTailRecursion, stop, stop, template_checkGuard, template_execute, template_runChild, template_runChildDirectly, template_runHook, template_runHookDirectly, template_runInlinedChild, unsetChildCancelToken, unsetControl

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Inverter

public Inverter()

Inverter

public Inverter(Task<T> child)

方法详细资料

execute

protected void execute()

从类复制的说明: Task

Task的心跳方法，在Task进入完成状态之前会反复执行。 1.可以根据Task.isExecuteTriggeredByEnter()判断是否是与Task.enter(int)连续执行的。 2.运行中可通过Task.setSuccess()、Task.setFailed(int)、Task.setCancelled()将自己更新为完成状态。 3.不建议直接调用该方法，而是通过模板方法Task.template_execute(boolean)运行。

指定者:

execute 在类中 Task<T>

onChildRunning

protected void onChildRunning(Task<T> child)

从类复制的说明: Decorator

子类如果支持内联，则重写该方法

覆盖:

onChildRunning 在类中 Decorator<T>

onChildCompleted

protected void onChildCompleted(Task<T> child)

从类复制的说明: Task

子节点进入完成状态 1.避免方法数太多，实现类测试task的status即可 2.Task.getNormalizedStatus()有助于switch测试 3.task可能是取消状态，甚至可能没运行过直接失败（前置条件失败） 4.钩子任务和guard不会调用该方法 5.Task.isExecuting()有助于检测冲突，减少调用栈深度 6.同一子节点连续通知的情况下，completed的逻辑应当覆盖Task.onChildRunning(Task)的影响。 7.任何的回调和事件方法中都由用户自身检测取消信号

指定者:

onChildCompleted 在类中 Task<T>