top.xiajibagao.crane.core.handler.interfaces

接口 OperateHandlerChain

所有超级接口:

Comparable<Orderly>, OperateHandler, org.springframework.core.Ordered, Orderly

所有已知实现类:

AbstractOrderlyHandlerChain, BeanReflexOperateHandlerChain

public interface OperateHandlerChain
extends OperateHandler

处理器链，用于组织多个操作处理器与数据源拦截器，从而完成针对某一些类型的数据读与写操作。

处理器链中同时拥有数据源拦截器链interceptors()与操作处理器链handlers()两条"链"。 执行时，应当先执行拦截器链，再执行处理器链。

数据源拦截器链可以视为由多个拦截器组成，可按一定规则排序的纯粹责任链，约定：
当调用OperateHandler.readFromSource(Object, PropertyMapping, Operation)时， 链上所有SourceOperateInterceptor.supportInterceptReadSource(Object, PropertyMapping, Operation)返回为ture的节点都应当被执行；
当调用OperateHandler.writeToTarget(Object, Object, PropertyMapping, AssembleOperation)时， 链上所有SourceOperateInterceptor.supportInterceptSourceWrite(Object, Object, PropertyMapping, AssembleOperation)返回为ture的节点都应当被执行。

操作处理器可以视为由多个处理器组成，看按一定规则排序的不纯责任链，约定：
当调用OperateHandler.readFromSource(Object, PropertyMapping, Operation)时， 排序最靠前，且OperateHandler.sourceCanRead(Object, PropertyMapping, Operation)返回为ture的节点才会被执行； 当调用OperateHandler.writeToTarget(Object, Object, PropertyMapping, AssembleOperation)时， 排序最靠前，且OperateHandler.targetCanWrite(Object, Object, PropertyMapping, AssembleOperation)返回为ture的节点才会被执行；

作者:

huangchengxing

另请参阅:

OperateHandler, SourceOperateInterceptor, AbstractOrderlyHandlerChain

字段概要

从接口继承的字段 org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

方法概要

限定符和类型	方法和说明
OperateHandlerChain	addHandler(OperateHandler handler) 添加处理器节点
OperateHandlerChain	addInterceptor(SourceOperateInterceptor interceptor) 注册操作拦截器
List<OperateHandler>	handlers() 获取操作处理器链
List<SourceOperateInterceptor>	interceptors() 获取操作拦截器链
default Object	tryReadFromSource(Object source, PropertyMapping property, Operation operation) 若OperateHandler.sourceCanRead(Object, PropertyMapping, Operation)方法返回ture， 则返回OperateHandler.readFromSource(Object, PropertyMapping, Operation)的返回值，否则直接返回null
default void	tryWriteToTarget(Object sourceData, Object target, PropertyMapping property, AssembleOperation operation) 若OperateHandler.targetCanWrite(Object, Object, PropertyMapping, AssembleOperation)返回ture， 则调用OperateHandler.writeToTarget(Object, Object, PropertyMapping, AssembleOperation)

从接口继承的方法 top.xiajibagao.crane.core.handler.interfaces.OperateHandler

readFromSource, sourceCanRead, targetCanWrite, writeToTarget

从接口继承的方法 top.xiajibagao.crane.core.helper.Orderly

comparator, compareTo, getActualOrder, getOrder

方法详细资料

interceptors

List<SourceOperateInterceptor> interceptors()

获取操作拦截器链

返回:

java.util.List

从以下版本开始:

0.5.5

addInterceptor

OperateHandlerChain addInterceptor(SourceOperateInterceptor interceptor)

注册操作拦截器

参数:

interceptor - 拦截器

返回:

top.xiajibagao.crane.core.handler.interfaces.OperateHandlerChain

从以下版本开始:

0.5.5

handlers

List<OperateHandler> handlers()

获取操作处理器链

返回:

java.util.List

addHandler

OperateHandlerChain addHandler(OperateHandler handler)

添加处理器节点

参数:

handler - 处理器节点

返回:

top.xiajibagao.crane.core.handlers.OperateHandlerChain

tryReadFromSource

default Object tryReadFromSource(Object source,
                                 PropertyMapping property,
                                 Operation operation)

若OperateHandler.sourceCanRead(Object, PropertyMapping, Operation)方法返回ture， 则返回OperateHandler.readFromSource(Object, PropertyMapping, Operation)的返回值，否则直接返回null

参数:

source - 数据源

property - 待处理字段

operation - 字段配置

返回:

java.lang.Object

从以下版本开始:

0.5.5

tryWriteToTarget

default void tryWriteToTarget(Object sourceData,
                              Object target,
                              PropertyMapping property,
                              AssembleOperation operation)

若OperateHandler.targetCanWrite(Object, Object, PropertyMapping, AssembleOperation)返回ture， 则调用OperateHandler.writeToTarget(Object, Object, PropertyMapping, AssembleOperation)

参数:

sourceData - 从数据源获取的数据

target - 待处理对象

property - 待处理字段

operation - 字段配置

从以下版本开始:

0.5.5