AbstractMessenger (sjtu-infoplus-atk 1.1-SNAPSHOT API)

java.lang.Object
- edu.sjtu.infoplus.applicationToolkit.AbstractMessenger

```
public abstract class AbstractMessenger
extends Object
```
AbstractMessenger是每一个Messenger所需要继承的父类，提供了所有事件的处理方法的框架以及其他一些辅助方法。
Messenger通过继承AbstractMessenger，重载事件的处理方法来提供对相应事件的响应。

作者:

gwang

字段概要

字段
限定符和类型	字段和说明
`protected InfoPlusApplication`	`application` 注册Messenger的`InfoPlusApplication`对象。
`protected edu.sjtu.utils.cache.DataCache<String,List<CodeItemImpl>>`	`codeTables` 非共享外部代码表缓存。
`protected boolean`	`preloadCodeTables` 是否预加载非共享的外部代码表。
`protected boolean`	`requireVerification` 已过时。
`protected String`	`secret` 流程密钥。
`protected long`	`timeout` 非共享的外部代码表缓存超时时间。
`protected String`	`workflow` 流程代码。

构造器概要

构造器
构造器和说明

AbstractMessenger()

构造器
构造器和说明
`AbstractMessenger()`

方法概要

所有方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`protected String`	`buildEAN13Code()` 构造随机的物品码。
`protected InfoPlusResponse`	`dispatchAction(InfoPlusEvent e, String action)` 重新分发步骤级事件。
`protected List<? extends CodeItem>`	`getCachedCodeItems(String codeTable)` 获取指定外部代码表缓存中的数据全集。
`protected InfoPlusService`	`getInfoPlusService()` 获取`InfoPlusApplication`关联的`InfoPlusService`对象。
`protected javax.servlet.http.HttpServletRequest`	`getRequest()` 获取触发事件调用的HttpServletRequest。
`protected List<? extends CodeItem>`	`getSuggestionData(String codeTable)` 获取指定外部代码表的数据全集。
`protected void`	`invalidateCodeTable(String codeTable)` 使指定的非共享外部代码表缓存失效。
`InfoPlusResponse`	`onActionClicking(InfoPlusEvent e)` 默认的ACTION_CLICKING事件处理方法。
`InfoPlusResponse`	`onActionDoing(InfoPlusEvent e)` 默认的ACTION_DOING事件处理方法。
`InfoPlusResponse`	`onActionDone(InfoPlusEvent e)` 默认的ACTION_DONE事件处理方法。
`InfoPlusResponse`	`onActionSaved(InfoPlusEvent e)` 默认的ACTION_SAVED事件处理方法。
`InfoPlusResponse`	`onActionSaving(InfoPlusEvent e)` 默认的ACTION_SAVING事件处理方法。
`InfoPlusResponse`	`onFieldChanging(InfoPlusEvent e)` 默认的FIELD_CHANGING事件处理方法。
`InfoPlusResponse`	`onFieldSuggesting(InfoPlusEvent e)` 默认的FIELD_SUGGESTING事件处理方法。
`InfoPlusResponse`	`onInstanceCompensation(InfoPlusEvent e)` 默认的INSTANCE_COMPENSATION事件处理方法。
`InfoPlusResponse`	`onInstanceCompleted(InfoPlusEvent e)` 默认的INSTANCE_COMPLETED事件处理方法。
`InfoPlusResponse`	`onInstanceCompleting(InfoPlusEvent e)` 默认的INSTANCE_COMPLETING事件处理方法。
`InfoPlusResponse`	`onInstanceExpired(InfoPlusEvent e)` 默认的INSTANCE_EXPIRED事件处理方法。
`InfoPlusResponse`	`onInstanceExpiring(InfoPlusEvent e)` 默认的INSTANCE_EXPIRING事件处理方法。
`InfoPlusResponse`	`onInstanceExporting(InfoPlusEvent e)` 默认的INSTANCE_EXPORTING事件处理方法。
`InfoPlusResponse`	`onInstanceKilled(InfoPlusEvent e)` 默认的INSTANCE_KILLED事件处理方法。
`InfoPlusResponse`	`onInstanceKilling(InfoPlusEvent e)` 默认的INSTANCE_KILLING事件处理方法。
`InfoPlusResponse`	`onInstancePrinting(InfoPlusEvent e)` 默认的INSTANCE_PRINTING事件处理方法。
`InfoPlusResponse`	`onInstanceRendering(InfoPlusEvent e)` 默认的INSTANCE_RENDERING事件处理方法。
`InfoPlusResponse`	`onInstanceSaved(InfoPlusEvent e)` 默认的INSTANCE_SAVED事件处理方法。
`InfoPlusResponse`	`onInstanceSaving(InfoPlusEvent e)` 默认的INSTANCE_SAVING事件处理方法。
`InfoPlusResponse`	`onInstanceStarted(InfoPlusEvent e)` 默认的INSTANCE_STARTED事件处理方法。
`InfoPlusResponse`	`onInstanceStarting(InfoPlusEvent e)` 默认的INSTANCE_STARTING事件处理方法。
`InfoPlusResponse`	`onStepExpired(InfoPlusEvent e)` 默认的STEP_EXPIRED事件处理方法。
`InfoPlusResponse`	`onStepExpiring(InfoPlusEvent e)` 默认的STEP_EXPIRING事件处理方法。
`InfoPlusResponse`	`onStepExporting(InfoPlusEvent e)` 默认的STEP_EXPORTING事件处理方法。
`InfoPlusResponse`	`onStepPrinting(InfoPlusEvent e)` 默认的STEP_PRINTING事件处理方法。
`InfoPlusResponse`	`onStepRendering(InfoPlusEvent e)` 默认的STEP_RENDERING事件处理方法。
`InfoPlusResponse`	`onStepReviewing(InfoPlusEvent e)` 默认的STEP_REVIEWING事件处理方法。
`InfoPlusResponse`	`onStepWithdrawing(InfoPlusEvent e)` 默认的STEP_WITHDRAWING事件处理方法。
`InfoPlusResponse`	`onStepWithdrawn(InfoPlusEvent e)` 默认的STEP_WITHDRAWN事件处理方法。
`void`	`registerCodeTable(String codeTable)` 声明单个非共享的外部代码表。
`protected List<CodeItemImpl>`	`search(List<CodeItemImpl> list, String prefix, String parent, int pageNo, int pageSize)` 检索并返回符合搜索条件的代码项。
`void`	`setCodeTables(List<String> codeTables)` 声明非共享外部代码表的清单。
`void`	`setPreloadCodeTables(boolean preloadCodeTables)` 设置是否预加载非共享的外部代码表。
`void`	`setRequireVerification(boolean requireVerification)` 已过时。
`void`	`setSecret(String secret)` 设置流程密钥。
`void`	`setTimeout(long timeout)` 设置非共享的外部代码表缓存超时时间。
`void`	`setWorkflow(String workflow)` 设置流程代码。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料
- codeTables
```
protected edu.sjtu.utils.cache.DataCache<String,List<CodeItemImpl>> codeTables
```
  非共享外部代码表缓存。
  
  另请参阅:
  
  DataCache
- requireVerification
```
protected boolean requireVerification
```
  已过时。
  
  是否验证事件请求的认证头。
  
  另请参阅:
  
  setRequireVerification(boolean)
- workflow
```
protected String workflow
```
  流程代码。
  
  另请参阅:
  
  setWorkflow(String)
- secret
```
protected String secret
```
  流程密钥。
  
  另请参阅:
  
  setSecret(String)
- timeout
```
protected long timeout
```
  非共享的外部代码表缓存超时时间。
  默认为3600000毫秒，即1小时。一个Messenger的所有非共享外部代码表，具有相同的缓存超时时间。
  
  另请参阅:
  
  setTimeout(long)
- application
```
protected InfoPlusApplication application
```
  注册Messenger的InfoPlusApplication对象。
  此属性在Messenger注册到InfoPlusApplication时由SDK自动设置。
  
  另请参阅:
  
  InfoPlusApplication.setMessengers(List), InfoPlusApplication.registerMessenger(AbstractMessenger)
- preloadCodeTables
```
protected boolean preloadCodeTables
```
  是否预加载非共享的外部代码表。
  
  另请参阅:
  
  setPreloadCodeTables(boolean)

构造器详细资料
- AbstractMessenger
```
public AbstractMessenger()
```

方法详细资料

setRequireVerification
```
public void setRequireVerification(boolean requireVerification)
```
已过时。

设置是否验证事件请求的认证头。
无论设置值，此版本的SDK总是验证事件请求的认证头

参数:

requireVerification - true - 是，false - 否

setWorkflow
```
public void setWorkflow(String workflow)
```
设置流程代码。
事件请求根据流程代码来匹配处理的Messenger，因此必须设置。

参数:

workflow - 流程代码

setSecret
```
public void setSecret(String secret)
```
设置流程密钥。
事件请求根据流程代码和密钥来匹配处理的Messenger，并验证事情请求的认证头是否合法，因此必须设置。

参数:

secret - 流程密钥

setTimeout
```
public void setTimeout(long timeout)
```
设置非共享的外部代码表缓存超时时间。
时间单位为毫秒。默认为3600000毫秒，即1小时。设置此值影响该Messenger中所有的非共享外部代码表。

参数:

timeout - 缓存超时时间毫秒值

另请参阅:

getSuggestionData(String), invalidateCodeTable(String)

setCodeTables
```
public void setCodeTables(List<String> codeTables)
```
声明非共享外部代码表的清单。
Messenger支持的非共享外部代码表必须先通过此方法声明，并实现getSuggestionData(String)方法来提供数据。非共享外部代码表优先于共享外部代码表，一个外部代码表如果在非共享外部代码表中没有找到，才会进一步在共享外部代码表中查找。

参数:

codeTables - 非共享外部代码表代码的List

另请参阅:

getSuggestionData(String), InfoPlusApplication.setSharedCodeTableBuilders(List), InfoPlusApplication.registerSharedCodeTableBuilder(CachableDataBuilder)

setPreloadCodeTables
```
public void setPreloadCodeTables(boolean preloadCodeTables)
```
设置是否预加载非共享的外部代码表。
通常非共享的外部代码表在首次表单suggest操作时才会通过调用getSuggestionData(String)加载数据。可以通过设置预加载把加载数据提前到Messenger初始化后立即进行，这样可以改善首次表单suggest操作时的响应速度。

参数:

preloadCodeTables - true - 预加载，false - 不预加载。默认为false。

registerCodeTable
```
public void registerCodeTable(String codeTable)
```
声明单个非共享的外部代码表。
setCodeTables(List)方法内部使用本方法来逐个声明非共享的外部代码表。

参数:

codeTable - 非共享的外部代码表的代码

另请参阅:

setCodeTables(List)

invalidateCodeTable
```
protected void invalidateCodeTable(String codeTable)
```
使指定的非共享外部代码表缓存失效。
此方法仅可失效非共享外部代码表缓存。如果是共享外部代码表，可在InfoPlusApplication.getSharedCodeTables()返回的对象上调用DataCache.invalidate(Object) ，使缓存失效。

参数:

codeTable - 外部代码表的代码

另请参阅:

getSuggestionData(String)

getRequest
```
protected javax.servlet.http.HttpServletRequest getRequest()
```
获取触发事件调用的HttpServletRequest。

返回:

HttpServletRequest对象

onInstanceStarting
```
public InfoPlusResponse onInstanceStarting(InfoPlusEvent e)
```
默认的INSTANCE_STARTING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_STARTING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceStarted
```
public InfoPlusResponse onInstanceStarted(InfoPlusEvent e)
```
默认的INSTANCE_STARTED事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_STARTED事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceCompleting
```
public InfoPlusResponse onInstanceCompleting(InfoPlusEvent e)
```
默认的INSTANCE_COMPLETING事件处理方法。
默认方法仅返回null。流程平台不支持此事件，所以永远不会调用。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceCompleted
```
public InfoPlusResponse onInstanceCompleted(InfoPlusEvent e)
```
默认的INSTANCE_COMPLETED事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_COMPLETED事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceSaving
```
public InfoPlusResponse onInstanceSaving(InfoPlusEvent e)
```
默认的INSTANCE_SAVING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_SAVING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceSaved
```
public InfoPlusResponse onInstanceSaved(InfoPlusEvent e)
```
默认的INSTANCE_SAVED事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_SAVED事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstancePrinting
```
public InfoPlusResponse onInstancePrinting(InfoPlusEvent e)
```
默认的INSTANCE_PRINTING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_PRINTING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceExporting
```
public InfoPlusResponse onInstanceExporting(InfoPlusEvent e)
```
默认的INSTANCE_EXPORTING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_EXPORTING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceKilling
```
public InfoPlusResponse onInstanceKilling(InfoPlusEvent e)
```
默认的INSTANCE_KILLING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_KILLING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceKilled
```
public InfoPlusResponse onInstanceKilled(InfoPlusEvent e)
```
默认的INSTANCE_KILLED事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_KILLED事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceCompensation
```
public InfoPlusResponse onInstanceCompensation(InfoPlusEvent e)
```
默认的INSTANCE_COMPENSATION事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_COMPENSATION事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onInstanceRendering
```
public InfoPlusResponse onInstanceRendering(InfoPlusEvent e)
```
默认的INSTANCE_RENDERING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_RENDERING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onActionClicking
```
public final InfoPlusResponse onActionClicking(InfoPlusEvent e)
```
默认的ACTION_CLICKING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发ACTION_CLICKING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onActionDoing
```
public final InfoPlusResponse onActionDoing(InfoPlusEvent e)
```
默认的ACTION_DOING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发ACTION_DOING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onActionDone
```
public final InfoPlusResponse onActionDone(InfoPlusEvent e)
```
默认的ACTION_DONE事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发ACTION_DONE事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepRendering
```
public final InfoPlusResponse onStepRendering(InfoPlusEvent e)
```
默认的STEP_RENDERING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_RENDERING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepReviewing
```
public final InfoPlusResponse onStepReviewing(InfoPlusEvent e)
```
默认的STEP_REVIEWING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_REVIEWING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepPrinting
```
public final InfoPlusResponse onStepPrinting(InfoPlusEvent e)
```
默认的STEP_PRINTING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_PRINTING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepExporting
```
public final InfoPlusResponse onStepExporting(InfoPlusEvent e)
```
默认的STEP_EXPORTING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_EXPORTING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepWithdrawing
```
public final InfoPlusResponse onStepWithdrawing(InfoPlusEvent e)
```
默认的STEP_WITHDRAWING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_WITHDRAWING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onStepWithdrawn
```
public final InfoPlusResponse onStepWithdrawn(InfoPlusEvent e)
```
默认的STEP_WITHDRAWN事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_WITHDRAWN事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String)

onActionSaving
```
public InfoPlusResponse onActionSaving(InfoPlusEvent e)
```
默认的ACTION_SAVING事件处理方法。
默认方法仅返回null。Messenger需要处理ACTION_SAVING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

onActionSaved
```
public InfoPlusResponse onActionSaved(InfoPlusEvent e)
```
默认的ACTION_SAVED事件处理方法。
默认方法仅返回null。Messenger需要处理ACTION_SAVED事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

dispatchAction

protected final InfoPlusResponse dispatchAction(InfoPlusEvent e,
                                                String action)

重新分发步骤级事件。

不同于其他事件处理采用的重载对应方法来提供处理的做法，SDK对步骤级事件采用约定命名规则，并通过反射进行调用的方法。下表列出了使用这种方法的事件以及命名规则：

事件	命名规则
STEP_RENDERING	onStep{StepCode}Rendering
STEP_REVIEWING	onStep{StepCode}Reviewing
STEP_PRINTING	onStep{StepCode}Printing
STEP_EXPORTING	onStep{StepCode}Exporting
STEP_EXPIRING	onStep{StepCode}Expiring
STEP_WITHDRAWING	onStep{StepCode}Action{ActionCode}Withdrawing
STEP_WITHDRAWN	onStep{StepCode}Action{ActionCode}Withdrawn
ACTION_CLICKING	onStep{StepCode}Action{ActionCode}Clicking
ACTION_DOING	onStep{StepCode}Action{ActionCode}Doing
ACTION_DONE	onStep{StepCode}Action{ActionCode}Done toStep{TargetStepCode}Done

StepCode为步骤的代码，在方法名中使用时首字母转为大写，其余部分保持不变。
ActionCode为动作代码，在方法名中使用时首字母转为大写，其余部分保持不变。

所有方法都应该只接受一个InfoPlusEvent对象作为入参，并返回InfoPlusResponse对象作为返回值。
如果对应的步骤或者动作不需要处理，对应方法名的方法可以不提供。

onStep开头的方法名中的StepCode均指事件发生的步骤，而对于ACTION_DONE事件，SDK支持调用以动作执行后到达的节点命名的方法，即toStep开头的方法名。 TargetStepCode为到达节点的代码，使用这种方法来提供事件处理需要注意:
1、ACTION_DONE事件实际由动作起始节点触发，同一个到达节点可能来自不同的起始节点，因此需要注意在所有可能的起始节点上都勾选Done事件才能保证事件处理不会遗漏。
2、一个动作的到达节点可能是多个(触发并行的情况)，因此多个处理方法可能被调用，SDK不保证调用的顺序，并且仅返回最后一个处理方法的返回结果。
3、如果同时提供了onStep方法和toStep方法都能匹配ACTION_DONE事件，将先调用onStep方法，再调用toStep方法

参数:: e - InfoPlusEvent对象; action - 操作名称，Rendering、Doing、Done、Printing等
返回:: InfoPlusResponse对象

onStepExpiring
```
public final InfoPlusResponse onStepExpiring(InfoPlusEvent e)
```
默认的STEP_EXPIRING事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_EXPIRING事件，请参考dispatchAction(InfoPlusEvent, String)

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String), InfoPlusResponse.setTimer(Timer)

onStepExpired
```
public final InfoPlusResponse onStepExpired(InfoPlusEvent e)
```
默认的STEP_EXPIRED事件处理方法。
此方法不可重载，SDK提供了特殊的规则来重新分发STEP_EXPIRED事件，请参考dispatchAction(InfoPlusEvent, String)
流程平台实际不支持此事件，因此此事件不可能发生。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

dispatchAction(InfoPlusEvent, String), InfoPlusResponse.setTimer(Timer)

onInstanceExpiring
```
public InfoPlusResponse onInstanceExpiring(InfoPlusEvent e)
```
默认的INSTANCE_EXPIRING事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_EXPIRING事件时，应该重载此方法。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

InfoPlusResponse.setTimer(Timer)

onInstanceExpired
```
public InfoPlusResponse onInstanceExpired(InfoPlusEvent e)
```
默认的INSTANCE_EXPIRED事件处理方法。
默认方法仅返回null。Messenger需要处理INSTANCE_EXPIRED事件时，应该重载此方法。
流程平台实际不支持此事件，因此此事件不可能发生。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

InfoPlusResponse.setTimer(Timer)

onFieldChanging

public InfoPlusResponse onFieldChanging(InfoPlusEvent e)

默认的FIELD_CHANGING事件处理方法。

默认方法仅返回null。Messenger需要处理FIELD_CHANGING事件时，应该重载此方法。

FIELD_CHANGING事件的处理中需要特别关注两点：
1、获取变化的字段。参考InfoPlusEvent.getChangingField()、InfoPlusEvent.getChangingObject(Object)、InfoPlusEvent.getChangingObject(Object, Class)获取更多信息。
2、仅可以使用InfoPlusEvent.toBean(Class)返回的表单数据实例对象，或者InfoPlusEvent.getChangingObject(Object)、InfoPlusEvent.getChangingObject(Object, Class)方法基于该对象获取到的对象来构造返回结果。
参考如下示例：

表单数据结构:

     purchaseRequest ---- 采购申请主表单
         fieldTitle ---- String, 申请标题
         fieldTotalAmount ---- Double, 采购总价
         groupItems ---- 重复结构，采购明细
             fieldItem ---- String, 采购物品名称
             fieldPrice ---- Double, 采购物品单价
             fieldQuantity ---- Int, 采购物品数量

Java对象定义:

     //采购申请主表单
     class PurchaseRequest {
         private String title; //申请标题
         private BigDecimal totalAmount; //采购总价
         private List<PurchaseItem> items; //采购明细

         ...
         //setter & getter
     }
     //采购明细
     class PurchaseItem {
         String itemName; //采购物品名称
         BigDecimal itemPrice; //采购物品单价
         Integer itemQuantity; //采购物品数量
         BigDecimal itemAmount; //采购物品单项金额

         ...
         //setter & getter
     }

当前表单数据，Bean格式(json表达):

     {
         "title": "采购办公用品",
         "totalAmount": 65,
         "items": [{
             "itemName": "记号笔", "itemPrice": 3, "itemQuantity": 20, "itemAmount": 50
         }, {
             "itemName": "白板擦", "itemPrice": 5, "itemQuantity": 3, "itemAmount": 15
         }]
     }

当将"记号笔"的采购数量改变时：

     public InfoPlusResponse onFieldChanging(InfoPlusEvent e) {
         PurchaseRequest form = e.toBean(PurchaseRequest.class);
         Object changedObject = null; //构造返回值的对象
         if ("fieldItemQuantity".equals(e.getChangingField())) { //采购物品数量字段发生改变
             //1. 重新计算单项金额（改变变化的重复字段同层其他字段）
             PurchaseItem item = e.getChangingObject(form);
             item.setItemAmount(item.getItemPrice().multiply(new item.getItemQuantity()));
             changedObject = item; //正确（合计金额totalAmount由前端公式计算）

             //2. 重新计算金额合计（改变变化的重复字段上层的字段）
             form.setTotalAmount(form.getItems().stream().map(PurchaseItem::getAmount).reduce(BigDecimal.ZERO, BigDecimal::add));
             changedObject = form; //正确（返回数据中包含了totalAmount字段，则该字段必须由后端计算）

             //3. 追加行
             PurchaseItem item = new PurchaseItem();
             item.setItemName("复印纸");
             form.getItems().add(item);
             changedObject = form; //正确
             changedObject = item; //错误。不能仅返回新创建的对象

             //4. 删除本行
             PurchaseItem item = e.getChangingObject(form);
             form.getItems().remove(item);
             changedObject = form; //正确
             changedObject = item; //错误。不能仅返回删除的对象

             //5. 改变其他行的字段
             PurchaseItem item = form.getItems().get(0);
             item1.setItemName("记号笔*");
             changedObject = item; //正确
             changedObject = form; //也正确，但是返回数据较大，效率低
         }
         if (changedObject == null) return null;
         return new InfoPlusResponse(e, changedObject);
     }

参数:: e - InfoPlusEvent对象
返回:: InfoPlusResponse对象
另请参阅:: InfoPlusEvent.getChangingField(), InfoPlusEvent.getChangingObject(Object), InfoPlusEvent.getChangingObject(Object, Class)

onFieldSuggesting
```
public InfoPlusResponse onFieldSuggesting(InfoPlusEvent e)
```
默认的FIELD_SUGGESTING事件处理方法。
此方法提供对表单suggest操作的默认支持，为外部代码表提供数据。一般Messenger不需要重载此方法来支持外部代码表，而应该根据外部代码表的使用范围决定作为非共享外部代码表还是共享外部代码表来支持。对于非共享外部代码表，需要调用setCodeTables(List)或registerCodeTable(String)进行注册，并重载getSuggestionData(String)来提供数据；对于共享外部代码表，需要实现CachableDataBuilder，并调用InfoPlusApplication.setSharedCodeTableBuilders(List)或者InfoPlusApplication.registerSharedCodeTableBuilder(CachableDataBuilder)进行注册。
如果存在特殊的需求需要完全控制对FIELD_SUGGESTING的响应，Messenger也可以重载此方法提供自定义的处理逻辑。重载此方法后上述的非共享外部代码表和共享外部代码表支持机制将失效，开发者需自行处理InfoPlusEvent，构造返回的InfoPlusResponse对象。开发者应了解FIELD_SUGGESTING事件对应了表单中suggest字段的每一次键盘输入操作，用户期待及时的响应，因此需要很高的性能要求。流程平台对FIELD_SUGGESTING事件的响应最低时间要求是30秒，通常用户期望的响应时间应该小于2秒。

参数:

e - InfoPlusEvent对象

返回:

InfoPlusResponse对象

另请参阅:

InfoPlusEvent.getSuggestion(), InfoPlusResponse.setCodes(List)

search
```
protected List<CodeItemImpl> search(List<CodeItemImpl> list,
                                    String prefix,
                                    String parent,
                                    int pageNo,
                                    int pageSize)
```
检索并返回符合搜索条件的代码项。

参数:

list - 检索的源数据。仅支持SDK内部实现的CodeItemImpl类的实例。

prefix - 检索的关键词。

parent - 父级代码值。如果传入null，表示不限制匹配的代码项的父级代码，否则仅当代码项的父级代码和传入值相同时，该代码项才符合检索条件。

pageNo - 返回数据的页号。

pageSize - 返回数据的分页大小。

返回:

符合检索条件的一页数据。

getSuggestionData
```
protected List<? extends CodeItem> getSuggestionData(String codeTable)
```
获取指定外部代码表的数据全集。
AbstractMessenger使用了特别的设计来简化外部代码表的实现。一般情况下Messenger不需要重新实现onFieldSuggesting(InfoPlusEvent)方法来响应FIELD_SUGGESTING事件，而仅需要重新实现本方法来提供完整的代码表数据全集即可完成对外部代码表的支持。 AbstractMessenger的默认onFieldSuggesting(InfoPlusEvent)实现会调用本方法来获取数据，自动完成索引建立、数据缓存，改善表单suggest操作的性能和使用体验。
此方法返回数据的缓存时间由timeout属性指定，缓存到期后的suggest调用会触发再次调用此方法来重新获取数据。如果希望主动使缓存过期，可以调用invalidateCodeTable(String)方法。
索引是指用来匹配用户的输入的数据，如果表单中suggest字段的用户输入值匹配代码项索引的前缀，则该代码项被返回供用户选择。如果返回的代码项仅实现了CodeItem接口，则CodeItem.getCodeId()、CodeItem.getCodeName()和CodeItem.getCodeDescription()的返回值、返回值中的中文字符的全拼、返回值中的中文字符的拼音首字符均作为索引。比如CodeItem.getCodeId()返回"40100"，CodeItem.getCodeName()返回"网络信息中心"，则索引包括: 40100，网络信息中心，wangluoxinxizhongxin，wlxxzx
如果希望自定义索引，返回的代码项可以实现CodeItemEx接口，通过CodeItemEx.getCodeIndexes()方法来直接提供自定义的索引。

参数:

codeTable - 外部代码表的代码

返回:

包含所有代码项CodeItem的List

另请参阅:

onFieldSuggesting(InfoPlusEvent), getCachedCodeItems(String)

getCachedCodeItems
```
protected List<? extends CodeItem> getCachedCodeItems(String codeTable)
```
获取指定外部代码表缓存中的数据全集。
如果调用此方法时，代码表的缓存尚未建立，则触发缓存的建立。

参数:

codeTable - 外部代码表的代码

返回:

包含所有代码项CodeItem的List

getInfoPlusService
```
protected InfoPlusService getInfoPlusService()
```
获取InfoPlusApplication关联的InfoPlusService对象。
只有Messenger完成注册到InfoPlusApplication后才可以调用此方法。

返回:

InfoPlusService对象

另请参阅:

InfoPlusApplication.setMessengers(List), InfoPlusApplication.registerMessenger(AbstractMessenger)

buildEAN13Code
```
protected String buildEAN13Code()
```
构造随机的物品码。
物品码的构造一般在表单操作时由前端代码构造，如果流程中存在不需要用户关心的物品，Messenger可以使用此方法构造新的物品码，并给物品字段赋值。

返回:

新的物品码

类 AbstractMessenger

字段概要

构造器概要

方法概要

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

字段详细资料

codeTables

requireVerification

workflow

secret

timeout

application

preloadCodeTables

构造器详细资料

AbstractMessenger

方法详细资料

setRequireVerification

setWorkflow

setSecret

setTimeout

setCodeTables

setPreloadCodeTables

registerCodeTable

invalidateCodeTable

getRequest

onInstanceStarting

onInstanceStarted

onInstanceCompleting

onInstanceCompleted

onInstanceSaving

onInstanceSaved

onInstancePrinting

onInstanceExporting

onInstanceKilling

onInstanceKilled

onInstanceCompensation

onInstanceRendering

onActionClicking

onActionDoing

onActionDone

onStepRendering

onStepReviewing

onStepPrinting

onStepExporting

onStepWithdrawing

onStepWithdrawn

onActionSaving

onActionSaved

dispatchAction

onStepExpiring

onStepExpired

onInstanceExpiring

onInstanceExpired

onFieldChanging

onFieldSuggesting

search

getSuggestionData

getCachedCodeItems

getInfoPlusService

buildEAN13Code