cn.crane4j.core.parser

类 TypeHierarchyBeanOperationParser

java.lang.Object

cn.crane4j.core.parser.TypeHierarchyBeanOperationParser

所有已实现的接口:

BeanOperationParser, NamedComponent

直接已知子类:

ConditionalTypeHierarchyBeanOperationParser

public class TypeHierarchyBeanOperationParser
extends Object
implements BeanOperationParser

操作配置解析器的通用实现。

工作机制

在解析配置时，解析器将创建一个根配置对象作为此次执行的上下文， 然后依次调用所有注册的 注解处理器， 将配置信息收集到上下文中的配置对象中。
解析完成后，将缓存与AnnotatedElement对应的BeanOperations实例， 下次访问时将优先使用缓存。

扫描范围

在解析元素时，如果是：

• Class：将检查其层次结构中的所有父类和接口；
• Method：将检查其层次结构中具有相同方法签名的方法；
• 其他：只检查自身；

操作配置的顺序

解析器获取的操作顺序遵循：

• 注解处理器的调用顺序；
• 它们在链中的顺序；

需要注意的是，这个顺序并不代表最终操作将执行的顺序，最终操作的顺序由执行器保证。

General implementation of BeanOperationParser.

Working Mechanism

When parsing the configuration, the parser will create a root BeanOperations as the context for this execution, Then successively call all registered OperationAnnotationHandler to collect the configuration information into the BeanOperations in context.
After the parsing is completed, the BeanOperations instance corresponding to the AnnotatedElement will be cached, and the cache will be used preferentially for the next access.

Scanning Range

When parsing element, if it is a:

• Class: it will check all parent classes and interfaces in its hierarchy;
• Method: it will check for methods with the same method signature in all parent classes and interfaces in its hierarchy;
• other: only the itself will be checked;

Order of Operation Configuration

The sequence of operations obtained through the parser follows:

• The calling order of OperationAnnotationHandler;
• their order in link OperationAnnotationHandler;

It should be noted that this order does not represent the order in which the final operation will be executed. This order is guaranteed by the executor BeanOperationExecutor.

从以下版本开始:

1.2.0

作者:

huangchengxing

另请参阅:

OperationAnnotationHandler

字段概要

字段

限定符和类型	字段和说明
protected Map<AnnotatedElement,BeanOperations>	currentlyInParsing temp cache for operations of element that currently in parsing
protected boolean	enableHierarchyCache Whether to cache hierarchy operation info of an element.
protected List<OperationAnnotationHandler>	operationAnnotationHandlers registered operation annotation resolvers.
protected Map<AnnotatedElement,BeanOperations>	resolvedElements cache for operations of a resolved element.
protected Map<AnnotatedElement,BeanOperations>	resolvedHierarchyElements temp cache for operations of a resolved element where in type hierarchy.

构造器概要

构造器

构造器和说明
TypeHierarchyBeanOperationParser()

方法概要

限定符和类型	方法和说明
void	addOperationAnnotationHandler(OperationAnnotationHandler handler) Add bean operations resolvers.
protected BeanOperations	createBeanOperations(AnnotatedElement element, boolean root) Create BeanOperations instance.
protected BeanOperations	doResolveToOperations(AnnotatedElement source)
Collection<OperationAnnotationHandler>	getOperationAnnotationHandlers() Get all operation annotation handlers.
protected void	mergeBeanOperationsToRootBeanOperations(BeanOperations root, Collection<BeanOperations> childOperations) Merge each child BeanOperations to root BeanOperations.
@NonNull BeanOperations	parse(AnnotatedElement element) Parse the class and class attribute information, and generate the corresponding BeanOperations instance.

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

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

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

getName

字段详细资料

currentlyInParsing

protected final Map<AnnotatedElement,BeanOperations> currentlyInParsing

temp cache for operations of element that currently in parsing

resolvedHierarchyElements

protected final Map<AnnotatedElement,BeanOperations> resolvedHierarchyElements

temp cache for operations of a resolved element where in type hierarchy.

resolvedElements

protected final Map<AnnotatedElement,BeanOperations> resolvedElements

cache for operations of a resolved element.

operationAnnotationHandlers

protected final List<OperationAnnotationHandler> operationAnnotationHandlers

registered operation annotation resolvers.

enableHierarchyCache

protected boolean enableHierarchyCache

Whether to cache hierarchy operation info of an element.

另请参阅:

resolvedHierarchyElements

构造器详细资料

TypeHierarchyBeanOperationParser

public TypeHierarchyBeanOperationParser()

方法详细资料

addOperationAnnotationHandler

public void addOperationAnnotationHandler(OperationAnnotationHandler handler)

Add bean operations resolvers.

参数:

handler - handler

getOperationAnnotationHandlers

public Collection<OperationAnnotationHandler> getOperationAnnotationHandlers()

Get all operation annotation handlers.

返回:

handlers

parse

@NonNull
public @NonNull BeanOperations parse(AnnotatedElement element)
                                        throws OperationParseException

Parse the class and class attribute information, and generate the corresponding BeanOperations instance.
If there is a cache, it will be obtained from the cache first.

NOTE:The BeanOperations obtained may still be being parsed. Please confirm whether it is ready through BeanOperations.isActive().

指定者:

parse 在接口中 BeanOperationParser

参数:

element - element to parse

返回:

BeanOperations

抛出:

OperationParseException - thrown when configuration resolution exception

mergeBeanOperationsToRootBeanOperations

protected void mergeBeanOperationsToRootBeanOperations(BeanOperations root,
                                                       Collection<BeanOperations> childOperations)

Merge each child BeanOperations to root BeanOperations.

参数:

root - root

childOperations - child operations

createBeanOperations

protected BeanOperations createBeanOperations(AnnotatedElement element,
                                              boolean root)

Create BeanOperations instance.

参数:

element - element

root - whether the element is root

返回:

BeanOperations

doResolveToOperations

protected BeanOperations doResolveToOperations(AnnotatedElement source)