《ESB平台API管理功能使用总结》共分为上、下两个篇章来与大家分享，在上篇我们已经从应用集成的角度对ESB平台的API管理功能进行了了解，下面我们将继续分享业务集成角度下的API管理功能，以及通过ESB平台对API进行监控统计。

业务集成

业务集成主要是面向于跨系统的业务单据集成需求，主要是通过API管理功能实现，通过将业务系统的接口注册在ESB的API管理中，再通过处理器或代理的方式构建ESB访问地址，提供给源头系统进行调用。

1.场景说明

业务集成主要是通过ESB进行代理转发，实现源头于目标系统的业务数据集成，具体流程图如下。

1.目标系统作为数据接收方，需要提供接收数据的服务接口，并提供接口地址给ESB平台；

2.ESB在API管理模块中注册目标系统的服务接口，之后再基于该接口进行代理，或建立配置服务的处理器，实现对目录系统接口的调用，同时产生基于ESB的新的接口地址；

3.ESB将新的接口地址提供给源头系统，源头系统产生数据后，推送到ESB的接口中，通过ESB再发送给目标系统实现数据集成。

2.服务注册

在业务集成场景中，服务注册的方式都是目标系统提供接口，ESB通过注册的方式进行添加，根据服务接口类型的不同，注册操作的步骤也会有所区别。

1.Web服务或Rest服务，并以WSDL或WADL作为描述：

（1）API服务中选择新增——注册：

（2）选择所属应用，输入服务地址（注意是以wsdl或wadl结尾）：

（3）点击解析按钮，自动解析服务编码、名称和API接口：

（4）启用服务：

（5）调用测试：

2.HTTP形式的API接口：

（1）选择一个GET查询接口作为样例：http://localhost:9090/Demo/services/DemoService/demoserviceRetrieve/{code}：

（2）其中http://localhost:9090/Demo/services/DemoService作为服务地址，demoserviceRetrieve作为API接口名称，{code}为接口入参：

（3）API服务中选择新增——注册：

（4）输入服务编码、名称、选择所属应用，输入服务地址（http://localhost:9090/Demo/services/DemoService）：

（5）直接点击保存（不需要解析）：

（6）进入API列表，手动添加API（demoserviceRetrieve）：

（7）保存，确认方法动词和入参类型：

（8）调用测试：

3.应用方式

通过注册方式添加的服务，一般需要通过配置服务或代理的方式生成新的接口地址，从而提供给源头系统进行调用，实现数据推送。

> > > > 配置服务

1.在API服务的新增下选择配置服务：

2.定义服务编码和服务名称：

3.在API列表中添加操作：

4.在处理器配置修改处理器：

5.修改类型为http，保存，新增配置：

6.选择服务接口，自动解析服务配置：

7.配置入参映射：

（1）属性映射：对入参的属性进行映射处理，需要针对每一个属性配置映射；

（2）对象映射：直接将入参报文传递到处理器服务中，不做任何的参数处理。

8.调用测试：

> > > > 代理服务

1.在API管理——API代理下选择API分组，创建代理服务：

（1）导入：将在API管理中注册的服务直接导入到API代理中生成代理服务；

（2）新增：手动定义代理服务信息，添加代理服务。

2.点击导入，导入注册的服务：

3.导入之后可以查看服务的API信息，并进行启用、禁用、调用测试等操作：

4.调用测试：

5.在API代理新增代理：

6.在服务列表中添加代理接口：

7.在API代理新增代理，勾选多代理：

8.在服务列表中添加代理接口：

9.添加多个代理接口：

4.安全策略

业务集成的安全管理主要是API接口的安全配置，和应用集成不同的是注册API的安全配置是在API管理中的API安全功能进行配置，但具体的配置过程和功能与应用集成的安全配置基本相同。

在配置API安全是可以对服务进行配置，服务下的API直接继承服务的安全策略，也可以针对每一个API自定义配置独立的安全策略。

5.技术要点

1.通过注册方式注册的服务接口除了通过配置、代理等方式支持业务集成外，也可以支持集中管理的需求，同时也可以直接在应用集成中引用；

2.在注册服务时，如果服务描述是WSDL或WADL，可以直接通过解析的方式解析API，否则必须用Http的方式进行手动注册；

3.除了配置服务，导入服务也支持拦截器的配置，但是导入服务配置的是后置拦截器，即在API调用结束后进行拦截处理，如进行日志记录、消息通知等操作；

4.配置服务可以通过处理器支持异步调用、单处理器重试等复杂场景的处理：

（1）异步调用：即源头系统将数据推送至ESB后，不等待目标系统的返回值，由ESB和目标系统进行后续的交互，将源头和ESB、ESB与目标两个集成过程进行解耦。这种一般适用场景：大批量推送数据，目标系统接收处理的时间较长；源头需要同时将数据发送多个系统，无法同时接收多个目标返回值；

（2）单处理器重试：由于配置服务通过处理器实现，在配置API时可以配置多个处理器实现多系统的集成，所以在出现异常时需要考虑对单一系统进行重试，通过单处理器重试可以保证只对出问题的处理器进行重试，避免数据重推的情况；

5.API代理模式一般而言更多是借助于ESB的服务监控、统计、限流、安全、报警等策略，提高接口的安全性和管控能力；

6.基于API代理只是将业务系统接口注册到ESB，并重新生成基于ESB的调用地址，对于接口的调用方式、入参/出参格式等均不做任何调整，同时也不支持同一个请求调用多个目标接口的操作，这一点和API的配置服务有所区别；

7.单代理和多代理的区别主要在于：通过多代理代理后的服务，服务地址都相同，只是操作名称不同，而单代理之后服务名称也不同。

监控统计

监控统计是ESB进行服务接口管理的重要组成内容，包括运行监控和统计分析两部分，其中运行监控是实时监控，可以从不同角度对服务接口进行监听，实时获取服务接口的运行情况，统计分析是汇总统计，是对一段时间内服务接口的运行情况进行统计，并以图表的形式进行展现。

1.场景说明

ESB的监控统计包括运行监控和统计分析两部分，并且可以基于服务、流程分角度统计，具体内容如下图所示。

2.运行监控

1.服务工程监控：按照ESB服务工程统计服务实时调用情况：

2.服务分组监控：按照API分组进行分类管理，统计服务的实时调用情况：

3.流程工程监控：按照ESB服务工程统计流程的实时调用情况：

4.流程分组监控：按照API分组进行分类管理，统计API的实时调用情况：

5.服务运行日志：可以对API服务的调用日志进行统计监控，同时支持调用过程中的调用地址、报文进行查看：

6.服务报警日志：在开启API的报警功能后，每次报警都会进行日志记录，并能通过API分组进行查看：

3.统计分析

1.服务工程统计：按照ESB的服务工程，统计一段时间内的服务调用情况，并通过图表进行汇总展现：

2.服务分组统计：按照ESB的API分组，统计一段时间内的服务调用情况，并通过图表进行汇总展现：

3.流程工程统计：按照ESB的服务工程，统计一段时间内的流程的调用情况，并通过图表进行汇总展现：

4.流程分组统计：按照ESB的API分组，统计一段时间内的流程的调用情况，并通过图表进行汇总展现：

5.服务应用分布：按照业务系统统计每个系统提供以及调用的服务接口情况：

4.技术要点

1.运行监控的服务运行日志会记录每一次请求的报文信息，为了降低ESB的资源消耗，注册服务时默认是不开启日志，如果有需要可以手动开启：

2.服务监控/统计与流程监控/统计：服务主要是针对Web Service和Rest Service而言，一般而言每个服务下都会有多个API接口，流程主要针对服务下的接口，在ESB中包括Http、Embed、Queue、Timer等流程类型，服务监控/统计主要按服务监控/统计操作的调用情况，而流程监控/统计这是独立统计每个流程的调用情况；

3.服务应用分布中的统计，按照API管理中注册关联的业务系统来统计服务提供，而服务调用则通过API安全中配置的调用系统统计：

分析总结

ESB企业服务总线平台是数通畅联的核心产品之一，在集成中台、数据中台、企业中台、主数据治理、数仓建设等方案中都发挥这非常重要的作用。根据在不同方案中ESB平台的作用以及数据处理的过程不同，ESB平台又可以分成服务总线和数据总线。

1.功能总结

API管理模块是ESB平台中非常重要的功能，通过API管理可以实现企业内外部服务接口的统一管理，满足接口集成、接口安全、报警通知等功能，并且基于API管理的集成、配置可以直接在ESB的SMC控制台中完成，可以直接图形化、零代码配置，提升开发效率、降低学习成本。

2.产品价值

ESB企业服务总线平台是企业信息化的基础系统之一，通过ESB平台可以为系统集成构建统一的集成通道，满足系统间数据集成的需求，实现基于服务接口的集成对接，完成接口的统一管理。同时ESB平台还具备服务开发的能力，可以根据实际需求进行服务接口的开发与部署，实现跨系统的微服务体系建设。

3.集成方案

根据ESB平台的作用和数据处理方式的不同，ESB可以分为服务总线和数据总线，服务总线强调ESB对服务接口的统一管理，基于服务接口进行系统集成，如集成中台、业务集成等方案；数据总线强调ESB的数据抽取、加工、转换、写入能力，实现跨系统、跨类型的数据库读写操作，如数仓建设方案。根据实际项目的需要，ESB是可以同时发挥服务总线和数据总线的能力，如数据中台、企业中台方案。

4.个人总结

ESB平台的API管理功能在目前的集成方案中都会用到，并且随着产品功能以及业务场景的不断完善，针对于多系统调用、同步/异步调用、单处理器重试等场景都实现了良好的支持，在实际项目中也得到了很好的验证，配置使用的方式越来越便捷，大大提升了实际项目中使用效果和交付效率。

对技术人员而言，熟练掌握ESB平台的使用是非常重要的能力，无论是实际项目还是内部样例、POC都是通过ESB平台实现的集成对接，同时由于ESB设计器提供低代码的开发能力，在实际工作中可以通过ESB设计器进行服务接口、工具类的开发测试，以及底层代码断点调试等需求。在实际业务场景和方案中，ESB作为贯穿各个系统的总线平台，在实现系统交互、集成的过程中，也能实现对系统传输过程中的数据抓取、日志记录，便于对问题的排查以及报警通知，提升系统集成的安全性和可控性。

本文由@数通畅联原创，欢迎转发，仅供学习交流使用，引用请注明出处！谢谢~