cn.crane4j.core.executor

类 AbstractBeanOperationExecutor

java.lang.Object

cn.crane4j.core.executor.AbstractBeanOperationExecutor

所有已实现的接口:

BeanOperationExecutor, NamedComponent

直接已知子类:

AbstractOperationAwareBeanOperationExecutor

public abstract class AbstractBeanOperationExecutor
extends Object
implements BeanOperationExecutor

This class serves as a template class and provides a basic skeleton implementation for most of the BeanOperationExecutor, particularly shielding the complexity of parsing DisassembleOperation operations. Once the executeOperations(java.util.List<cn.crane4j.core.executor.AssembleExecution>, cn.crane4j.core.executor.BeanOperationExecutor.Options) method is implemented in a subclass, it can be used as a BeanOperationExecutor.

According to the instructions specified in BeanOperations, the following steps are performed when executing operations through the BeanOperationExecutor.execute(java.util.Collection<?>, cn.crane4j.core.parser.BeanOperations, cn.crane4j.core.executor.BeanOperationExecutor.Options) method:

• If there are any DisassembleOperation operations to be executed, recursively extract and flatten the objects that need to be processed from the target object (if it is a collection or an array, iterate over each element);
• Group all the objects to be processed based on their corresponding BeanOperations, and wrap each group into an AssembleExecution object.
• Invoke the executeOperations(java.util.List<cn.crane4j.core.executor.AssembleExecution>, cn.crane4j.core.executor.BeanOperationExecutor.Options) method implemented in the subclass to actually perform the operations within each AssembleExecution.

This class only guarantees the sequential execution of DisassembleOperation operations, while the sequential execution of AssembleOperation operations depends on the implementation logic of executeOperations(java.util.List<cn.crane4j.core.executor.AssembleExecution>, cn.crane4j.core.executor.BeanOperationExecutor.Options).
For performance reasons, when implementing the executeOperations(java.util.List<cn.crane4j.core.executor.AssembleExecution>, cn.crane4j.core.executor.BeanOperationExecutor.Options) method, it is recommended to minimize the number of accesses to the Container.

作者:

huangchengxing

另请参阅:

AbstractOperationAwareBeanOperationExecutor, AsyncBeanOperationExecutor, DisorderedBeanOperationExecutor, OrderedBeanOperationExecutor

嵌套类概要

从接口继承的嵌套类/接口 cn.crane4j.core.executor.BeanOperationExecutor

BeanOperationExecutor.Options

字段概要

字段

限定符和类型	字段和说明
boolean	enableExecuteNotActiveOperation Whether to enable the execution of operations that are not active.

构造器概要

构造器

构造器和说明
AbstractBeanOperationExecutor()

方法概要

限定符和类型	方法和说明
protected void	afterOperationsCompletion(MultiMap<BeanOperations,Object> targetWithOperations) Do something after all operations completed.
protected void	beforeAssembleOperation(MultiMap<BeanOperations,Object> targetWithOperations) Do something before the assembly operation begin.
protected void	beforeDisassembleOperation(Collection<?> targets, BeanOperations operations, BeanOperationExecutor.Options options) Do something before the disassemble operations begin.
protected AssembleExecution	createAssembleExecution(BeanOperations beanOperations, AssembleOperation operation, Collection<Object> targets, BeanOperationExecutor.Options options) Create a AssembleExecution.
protected @NonNull List<AssembleExecution>	doCombineExecutions(BeanOperationExecutor.Options options, Predicate<? super KeyTriggerOperation> filter, BeanOperations beanOperations, Collection<Object> targets) Combine the AssembleExecution objects according to the specified BeanOperations and Options.
protected static void	doExecute(AssembleOperationHandler handler, Container<?> container, Collection<AssembleExecution> executions) Try to execute the operation.
void	execute(Collection<?> targets, BeanOperations operations, BeanOperationExecutor.Options options) Complete operations on all objects in targets according to the specified BeanOperations and Options.
protected abstract void	executeOperations(List<AssembleExecution> executions, BeanOperationExecutor.Options options) Complete the assembly operation.
protected <T> @NonNull Collection<T>	filterTargetsForSupportedOperation(Collection<T> targets, KeyTriggerOperation operation) Filter the targets that do not support the operation.

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

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

从接口继承的方法 cn.crane4j.core.executor.BeanOperationExecutor

execute, execute

从接口继承的方法 cn.crane4j.core.support.NamedComponent

getName

字段详细资料

enableExecuteNotActiveOperation

public boolean enableExecuteNotActiveOperation

Whether to enable the execution of operations that are not active.

构造器详细资料

AbstractBeanOperationExecutor

public AbstractBeanOperationExecutor()

方法详细资料

execute

public void execute(Collection<?> targets,
                    BeanOperations operations,
                    BeanOperationExecutor.Options options)

Complete operations on all objects in targets according to the specified BeanOperations and Options.

指定者:

execute 在接口中 BeanOperationExecutor

参数:

targets - targets

operations - operations to be performed

options - options for execution

另请参阅:

beforeDisassembleOperation(java.util.Collection<?>, cn.crane4j.core.parser.BeanOperations, cn.crane4j.core.executor.BeanOperationExecutor.Options), beforeAssembleOperation(cn.crane4j.core.util.MultiMap<cn.crane4j.core.parser.BeanOperations, java.lang.Object>), afterOperationsCompletion(cn.crane4j.core.util.MultiMap<cn.crane4j.core.parser.BeanOperations, java.lang.Object>)

doCombineExecutions

@NonNull
protected @NonNull List<AssembleExecution> doCombineExecutions(BeanOperationExecutor.Options options,
                                                                         Predicate<? super KeyTriggerOperation> filter,
                                                                         BeanOperations beanOperations,
                                                                         Collection<Object> targets)

Combine the AssembleExecution objects according to the specified BeanOperations and Options.

参数:

options - options for execution

filter - filter

beanOperations - bean operations

targets - targets

返回:

AssembleExecution objects

createAssembleExecution

protected AssembleExecution createAssembleExecution(BeanOperations beanOperations,
                                                    AssembleOperation operation,
                                                    Collection<Object> targets,
                                                    BeanOperationExecutor.Options options)

Create a AssembleExecution.

参数:

beanOperations - bean operations

operation - operation

targets - targets

options - options for execution

返回:

AssembleExecution

executeOperations

protected abstract void executeOperations(List<AssembleExecution> executions,
                                          BeanOperationExecutor.Options options)
                                   throws OperationExecuteException

Complete the assembly operation.
All operations of input parameters ensure their orderliness in the same class. For example, if there are ordered operations a and b in A.class, the order of a and b is still guaranteed when the corresponding AssembleExecution is obtained.

参数:

executions - assembly operations to be completed

options - options for execution

抛出:

OperationExecuteException - thrown when operation execution exception

beforeAssembleOperation

protected void beforeAssembleOperation(MultiMap<BeanOperations,Object> targetWithOperations)

Do something before the assembly operation begin.

参数:

targetWithOperations - target with operations

beforeDisassembleOperation

protected void beforeDisassembleOperation(Collection<?> targets,
                                          BeanOperations operations,
                                          BeanOperationExecutor.Options options)

Do something before the disassemble operations begin.

参数:

targets - targets

operations - operations

options - options for execution

从以下版本开始:

2.5.0

afterOperationsCompletion

protected void afterOperationsCompletion(MultiMap<BeanOperations,Object> targetWithOperations)

Do something after all operations completed.

参数:

targetWithOperations - target with operations

从以下版本开始:

2.5.0

filterTargetsForSupportedOperation

@NonNull
protected <T> @NonNull Collection<T> filterTargetsForSupportedOperation(Collection<T> targets,
                                                                                  KeyTriggerOperation operation)

Filter the targets that do not support the operation.

参数:

targets - targets

operation - operation

返回:

filtered targets

从以下版本开始:

2.5.0

doExecute

protected static void doExecute(AssembleOperationHandler handler,
                                Container<?> container,
                                Collection<AssembleExecution> executions)

Try to execute the operation.
If necessary, output the log when throwing an exception.

参数:

handler - handler

executions - executions

container - container