小编推荐

继上篇《优秀的轮--苍穹，你值得拥有》后，通过“copy+paste”，善用优秀的轮子，站在巨人的肩膀上，更快更好地满足了复杂的项目开发需求。

本期，项目需求遇到了“合同的种类繁多、需要和多方系统进行不同业务情况下的数据对接，且对接的接口协议格式不定”等问题。为了高效地完成开发项目，小编为大家进一步介绍“copy+paste”的深度使用技巧。欲知详情，请看下文~

撰稿人：Ximoon。

1 业务背景

客户系统主营合同业务，由于合同的种类繁多，且都继承自合同模板，合同的下游单据统一为合同台账。针对不同的合同，需要和多方系统进行不同业务情况下的数据对接，包括数据的新增、审核、变更、作废、解除等等。

而目前存在的最大问题是，针对不同合同的同一业务场景，或同一合同的不同业务场景，对接的接口协议格式不定。这导致了下游台账在反向获取上游合同数据的时候，无法使用数据获取节点准确定位到具体的单据并转为JSON格式的数据。在这种情况下，可以采用子流程和条件来进行判断，但处理方式既笨拙又不易维护。

客户要求在不同合同类型、合同的不同业务类型及不同同步方式的需求下，通过不引用更多集成对象的资源方式（合同越多，越难以维护一个服务流程或者子流程以及集成中字段映射的方式来处理数据），高效快捷地完成同步字段的配置。

2 解决方案

针对上述难点，需要考虑以下几个问题：

1、上游单据数据的获取并映射为指定的JSON格式是否容易完成？

2、不同类型合同下的不同业务操作类型所对应的不同数据结构是否可以维护？

3、不同类型合同下的不同业务操作类型所对应的同步需求是否能够满足？

拆解成三个小目标之后，问题就很容易解决了。老规矩，从苍穹平台本身去找“轮子”。

针对第一个问题，首先想到的是开放平台—API操作（查询）服务，可以通过这种方式完成JSON的封装。老规矩，BOS设计器、插件、浏览器开发者模式网络跟踪、Postman调用API，再加上对苍穹底层相关知识的了解，定位到了”bos-open“相关的插件包中。

在bos-resources.jar的资源配置中，可以找到开放平台http://host/ierp/kapi/xxxx的访问被接收处理的Servlet容器，即“kd.bos.kcf.KCFServlet”，如下图所示：

上传图片

Servlet mapping映射配置

在“KCFServlet.doAction”中，可以看到有关判断V1、V2版本的相关处理，由于此处使用的是API2.0，所以轻而易举地找到了处理API2.0的“OpenAPIServlet”容器。

上传图片 servlet转发处理

进入“OpenAPIServlet”后，即可看到熟悉的Controller层。当然，并不是指SpringMVC里面的controller，但却充当了这样一个角色。有了Controller也不要忘记“承上启下”地构建查询和转换的数据包。

数据包中最重要的是“APIModel”属性，包含了所有的请求信息、响应数据结构、JSON映射关系、过滤条件等等。

上传图片

controller的初始化及分发执行

上传图片

通过URL构建APIModel

上传图片

APIModel数据的来源

根据业务需求，需要Copy的是操作API的全流程处理，所以，此处拿到了“OperationApiController”的句柄。

上传图片

根据API类型初始化不同的Controller

接下来，经过几层流转来到了调用“service”层的代码，需要Copy的是操作API中的查询操作，所以服务层就是“APIQuery”。

上传图片

“Controller”转发到“service”

在“APIQuery”的代码执行中，可以看到最终的处理结果是调用API微服务，并根据是否仅返回动态对象（即不需要外层的状态封装）对数据进行包装处理。

上传图片

通过调用开放平台的二开微服务处理请求

随后，进入最重要的环节，即如何处理数据的获取及指定JSON结构的字段映射。这里面的逻辑相对复杂，所以本文挑选极为重点的部分进行讲解，具体将以下3句重点标注：

1、首先，准备好需要查询的列，如果查询的列中包含单据体及基础资料属性等多级结构的数据，则需要通过“CompartorUtil”工具进行补充字段获取处理（比如查询basedata.name，则需要添加查询basedata；查询isv_entryentity.name，则需要补充查询isv_entryentity）。

2、根据过滤条件是否存在单据体的部分字段为判断条件，如果不存在则直接使用“BusinessDataServiceHelper.load”的方式获取数据，本文Copy的需求并无单据体作为过滤条件的需要，所以无需过多处理。

3、存在自定义的JSON数据格式映射，组装并映射对应关系。在准备好查询出来的数据和映射关系后，可以直接调用这段代码。

上传图片

查询取数逻辑及映射组装逻辑

至此，已经完成了正向的拆解过程，将拆解过程中用到的逻辑处理代码Copy出来即可，同时，也可以通过API测试的http请求去拆解调用逻辑。

上传图片

通过页面的API测试按钮获取返回值

现在，需要处理第二个问题，可配置的数据结构及映射场景。这里可以直接模仿操作表单元数据的相关字段来完成设计。因为场景只存在于下游单据反查上游单据的情况，所以查询条件是固定的，只需复制出来返回参数的单据体，并将插件复制出来。这样第二个问题就可以轻松解决。

上传图片

API服务页面

最后，添加包括分组、触发事件、后置流程、同步地址（用来处理较为复杂的数据逻辑）等功能来解决业务场景化的问题。当一个业务场景被触发的时候，只需要查询该配置是否存在对应的同步需求，就可以通过一个服务流程，在非已知具体的上游单据数据和字段映射关系的前提下，对多个系统进行同步。

上传图片

完成效果示例

最后，需要对整体功能进行优化，将映射配置的表单的某些字段和被查询的上游单据的单据编号作为入参，提供二开微服务，获取映射结果；在页面上采用flex面板嵌套子页面的方式，对数据的展示进行优化（确保每次测试的数据不会存入该表单）。

通过右侧文本类型字段的编辑按钮，实现单据列表的选择功能；通过上方工具栏的按钮（API测试），实现父子页面的数据交互，将数据显示到代码编辑器中。

在对应事件触发的服务流程中，调用写好的二开微服务，就简单完成了一个业务场景下的所有逻辑处理，无需考虑上游单据的种类及个数，减少了当前流程的分支数，更加简单，易于维护。

3 方案的复用价值

这是Copy+Paste的第二期，当熟练掌握了这个工具之后，可以解放更多的时间来研究更深层次的技术问题，同时，面对复杂化的场景需求时，不再机械地考虑做一套功能需要花费多长时间，而是通过已有的轮子Copy出来符合当下项目甚至多个项目需求的工具时，能极大提高工作效率。

苍穹是个极其优秀的平台，尤其在做与集成相关的需求时，更加体会到了这一点。大家总是习惯性的去使用平台，但同时也可以以平台为模板案例，发展出无限可能。

在不断复制、更新、优化的过程中，也不断完善了整个生态，当生态体系足够庞大时，还需要发愁某个需求太复杂而交付的时间却太短吗？

4 注意事项

借用第一期的老话，不要违背开源协议。

在此感谢苍穹平台吕传勇、高俊和彭健老师对本开发项目的大力支持。

#往期推荐#

# 实践案例 | 优秀的轮子--苍穹，你值得拥有

# 实践案例 | 运维工单系统开发，全方位闭环管理业务问题

# 实践案例 | 经营数据可视化开发，助力企业高效管理资金

# 实践案例 | 基于前后端分离技术构建企业商城，实现销售业务数字化管理

更多精彩内容，“码”上了解！↓

上传图片

实践案例 | 优秀的轮子--苍穹，你值得拥有（续篇）

实践案例 | 优秀的轮子--苍穹，你值得拥有（续篇）

恭喜您！