1. 概述

本工程主要用于处理汇联易与下游系统数据集成，提供一些列封装好的API供实施团队进行快速开发。目前主要提供汇联易开放接口封装，错误异常重试与报障，接口性能采集，任务调度器，常见业务场景模板。

1.1. 开放接口封装

将汇联易提供的开放接口用Java进行封装，以Service提供给开发者，将接口的调用过程与参数结构以Java SDK的形式提供。方便开发者进行接口的使用。接口sdk文档说明可参见文档末尾接口说明。

1.2. 错误异常重试与报障

在系统集成应用中，网络异常与数据异常属于较为常见的错误： 1.在双方系统出现维护重启或者宕机以及网络不通的情况下，容易出现服务不可用，在本工程中通过捕捉特定异常来进行任务的重试，同时要求开发者能够正确的抛出服务不可用的异常。 2.另外一类较为常见的错误即为数据问题导致的错误，由于双方系统基础数据维护不统一，或者同步任务之间有依赖关系，导致的业务数据报错。按照本工程数据处理规范，即可将错误数据持久化并进行重试。

在发生服务不可用或者业务数据达到最大重试次数时，可按照配置的管理员电子邮箱发出告警邮件，提醒管理员进行运维。

1.3. 接口性能采集

在工程中开发了一个用于采集接口调用性能的注解，在封装接口请求调用时，通过本注解可以采集到接口的调用耗时，请求时间，如果发生错误还可以记录错误日志等内容。方便管理员进行接口性能诊断。

1.4. 任务调度器

提供统一任务调度器，将同步任务维护在调度器中即可进行轮询执行。同时在调度器中提供错误任务与业务异常重试，以及错误报障和数据清理等功能。开发者仅需要将需要进行定期执行的任务按照规范维护在调度器中即可。

1.5. 业务场景模板

根据常见系统集成需求，封装同步模板，将常见开发步骤抽象化，开发者仅需完成少量个性化开发即可完成数据集成。此处的个性化开发主要针对下游系统，对于数据写入场景，主要是下游系统数据查询与转化，对于数据导出场景主要是数据转化与下游系统数据写入。常见汇联易接口已经被封装在模板中，目前支持的模板有当前支持的模板类型有部门模板、用户模板、成本中心模板、成本中心项模板、成本中心项用户模板、报销单模板、借款单模板、差旅申请单模板。开发者需要完成对应的数据对象封装，即可完成系统对接，下图主要描述模板主要工作原理：