中国电信总线规范.

《中国电信总线规范.》由会员分享，可在线阅读，更多相关《中国电信总线规范.（29页珍藏版）》请在金锄头文库上搜索。

1、中国电信集团智能网管服务总线接入规范 中国电信集团智能网管服务总线接入规范V1.0中国电信集团公司2015年10月修改记录版本号时间记录人变更原因变更描述V1.02015/10/22新建新建初稿版本1. 文档说明1.1 编制说明本规范作为电信集团各网管域系统和集团与省份两级服务总线互联接口协议的重要组成部分，为支撑电信集团各网管域系统之间的服务交互、以及集团服务总线和省份服务总线两级服务交互，同时为中国电信集团智能网管平台建设提供指导和依据。1.2 适用范围本规范适用于中国电信集团公司智能网管平台和其它网管域系统间的服务交互，同时也适用于电信集团和省份的智能网管服务总线平台之间的服务交互。1.

2、3 参考规范中国电信智能网管技术规范-技术架构分册V1.0。1.4 起草单位本规范起草单位为中国电信集团公司。1.5 解释权本规范的解释权归中国电信集团公司所有。1.6 版权本规范的版权归中国电信集团公司所有。2. 综述2.1 概述本规范明确了电信集团智能网管服务总线平台在接入业务系统时的服务接入原则，进行了跨系统的业务流程分析，确定了集团智能网管服务总线平台的接入服务的类别划分及各类服务的适用场景。在此基础上，对每类服务的交互过程、交互过程中的每个接口的接口协议进行了详细的阐述，并针对主要的服务类型编写了场景 Demo 供开发人员参考。针对服务交互过程的可靠性以及事后审计，规范也对其中各业务

3、系统需要注意和配合的部分进行了详细描述。2.2 目标本规范为了指导中国电信集团公司以及下属省分公司进行各业务系统与集团智能网管服务总线平台的对接，实现以下目标： 当各业务系统间在建设及开发新的业务接口时，为相应业务系统间接口实现的技术统一化和规范化提供参考依据。 当业务系统提供的接口服务接入到集团智能网管服务总线平台时，为该业务系统所属的服务的升级改造提供参考依据。 当业务系统调用集团智能网管服务总线平台提供的服务能力时，为该业务系统的升级改造提供参考依据。 为各业务系统的以保证服务交易可靠性为目标的升级改造提供参考依据。2.3 范围 本规范主要包含以下几方面的内容： 明确了集团智能网管服务总

4、线平台在接入业务系统服务时的接入原则。 明确了集团智能网管服务总线平台接入服务的类别划分以及服务的适用场景。 对每类服务的接口交互、接口交互中的每个接口的接口协议进行了详细的阐述。 针对主要的服务类型编写了场景 Demo 供开发人员参考。 针对服务交互过程的可靠性以及事后审计，规范也对其中各业务系统需要注意和配合的部分进行了详细描述。3. 服务接入原则由于各系统间差异较大且数量众多，为确保新疆网管ESB平台接口服务接入的稳定高效的实施，按照中国电信智能网管技术规范中的要求，建议若干服务接入原则如下:3.1 服务能力定义要求电信集团智能网管服务总线平台服务能力定义要求如下：一个服务只能最多实现一

5、个业务，如果一个服务完成两个事情 A 和 B，且要求 B 在服务升级的过程中不中断 A 的服务，则 A 和 B 应当分散在两个独立的服务中。 小数据量服务所传递的单条消息大小原则上不大于 128K，否则应建议采用大数据量服务方式。3.2 接口技术统一原则所有接入到电信集团智能网管服务总线平台的原子服务能力接口均采用基于HTTP协议的Webserivce技术以及REST风格的原子服务能力接口。其中基于HTTP协议的WebService技术包括采用HTTP/SOAP协议的WebService、和采用REST风格的WebService两种形式。3.3 数据格式统一原则所有接入到电信集团智能网管服务总

6、线平台的服务的接口数据包含公共框架层和业务框架层两部分，接口数据采用XML格式或者JSON格式，大数据量的接口数据可以辅以文本文件格式，文本内容也应采用XML格式或者JSON格式。3.4 调用控制原则 鉴权原则：对于注册发布到集团智能网管服务总线平台的服务，服务消费者只有经平台鉴权通过并授予访问权限后才能调用服务。 频度控制原则：智能网管服务总线平台对服务调用的频度做相应的检查控制，如果在单位时间内的调用次数超过上限值将返回给服务消费者异常信息，通知已超过调用频度上限。 流量控制原则：智能网管服务总线平台对服务调用的流量做相应的检查控制，如果在单位时间内的总流量超过上限值将返回给服务消费者异常

7、信息，通知已超过流量上限。 超时控制原则：智能网管服务总线平台对服务调用的单次访问时间做相应的检查控制，如果在一定时间内没有完成服务请求/响应过程，将返回给服务消费者异常信息，通知已经访问超时。3.5 消息持久化原则服务消费方、服务提供方和集团智能网管总线平台在进行服务调用的过程中均需要分别在各自的系统中对消息进行持久化。为消息对账提供数据基础。4. 服务接入流程5. 服务适用场景5.1 应用型同步接口服务5.1.1 服务描述应用型同步接口服务由两个WebService接口组成，分别是由智能网管服务总线平台提供的代理接口、由服务提供方提供的业务接口。调用方式采用同步调用，即：服务消费方在调用服

8、务后一直等待，直到接收到业务响应结果后才可以继续执行。5.1.2 功能说明 代理接口：由智能网管服务总线平台提供的所有应用型接口服务的统一入口，可以接受所有的服务调用方的WebService请求消息。 业务接口：由应用服务提供方提供的真正提供业务服务的接口。业务接口的执行反馈是实时得到的。5.1.3 时序图步骤说明：1、 服务能力消费方向智能网管服务总线平台发起业务请求；2、 智能网管服务总线平台接收请求，并进行请求消息路由鉴权解释；3、 智能网管服务总线平台向服务能力提供方转发业务请求；4、 服务能力提供方处理业务请求；5、 服务能力提供方向智能网管服务总线平台返回处理结果；6、 智能网管服

9、务总线平台进行响应消息路由处理；7、 智能网管服务总线平台向服务能力消费方转发处理结果。5.2 应用型异步接口服务5.2.1 服务描述应用型异步接口服务指的是服务消费方与智能网管服务总线平台之间以及平台与服务提供方之间全部采用异步接口方式。即：服务消费者在调用服务后不等待返回结果，继续执行自己的任务。服务提供方在完成业务处理后，再通过其他的接口将业务响应结果通知服务消费方。因此，异步接口可以理解为不需要立即获得业务响应的服务。5.2.2 功能说明应用型异步接口服务由三个 WebService 接口组成，分别是由新疆网管ESB平台提供的代口、服务提供方组成的业务接口以及服务消费方提供的确认接口组

10、成。 代理接口：是由网管新疆网管ESB平台提供的所有应用型接口服务的统一接口，接受所有服务方的请求消息。 业务接口：是由服务提供方提供的真正提供业务服务的接口。 确认接口：是由服务消费方提供新疆网管ESB平台会调用此接口，将服务的状态通过此反馈给服务消费方。确认接口是否调用可选，如果服务消费方不需要服务提供方的确认信息，则不需要确认接口。5.2.3 时序图步骤说明：1、 服务能力消费方向智能网管服务总线平台发起业务请求；2、 智能网管服务总线平台接收和保存业务请求；3、 智能网管服务总线平台向服务能力消费方返回确认收到请求的响应；4、 智能网管服务总线平台进行业务请求的消息路由；5、 智能网管

11、服务总线平台向服务能力提供方转发业务请求；6、 服务能力提供方将业务请求保存到队列中；7、 服务能力提供方向智能网管服务总线平台返回确认收到业务请求的响应；8、 智能网管服务总线平台保存服务能力提供文质确认消息；当服务能力消费方需要接收服务能力提供方的确认消息时，服务能力消费方需提供接收确认消息的接口服务供智能网管服务总线平台调用；10、智能网管服务总线平台向服务能力消费方转发服务提供方的确认消息；11、服务能力消费方向智能网管服务总线平台返回响应。5.3 数据共享类接口服务5.3.1 服务描述由于网络带宽、报文处理等多方面因素的限制，智能网管服务总线只适合于直接传输小数据量的报文（一般大于1

12、28KB可以认为是大数据量）。但业务系统交互的情况下，存在大数据量交互的需求，如告警数据、性能数据、资源数据等，传输这样的数据，并不适合以单纯的Web service等单一接口协议来进行，推荐使用Web service + FTP/SFTP的结合使用的方法来实现。通过Web service完成FTP/SFTP控制类消息的通知，如产生新数据需要传输、数据传输成功确认等等，而数据本身（以文件的形式）的传输使用FTP/SFTP协议完成。5.3.2 功能说明数据共享类接口服务由三个WebService接口组成，分别是由智能网管服务总线平台提供的代理接口、服务提供方组成的业务接口以及服务消费方提供的确认

13、接口组成。 代理接口：由智能网管服务总线平台提供的所有应用型接口服务的统一入口，接受所有服务调用方的请求消息。 业务接口：由服务提供方提供的真正提供业务服务的接口。 确认接口：由服务消费方提供，应用智能网管服务总线平台会调用此接口，将服务提供方的确认消息转发给服务消费方。确认接口是否调用可选，如果服务消费方不需要服务提供方的确认消息，则不需要确认接口。5.3.3 时序图步骤说明：1、 数据源系统将数据上传到FTP服务器；2、 数据源系统向智能网管服务总线平台发起数据共享通知的业务请求；3、 智能网管服务总线平台保存业务请求；4、 智能网管服务总线平台向数据源系统返回确认收到请求的响应；5、 智

14、能网管服务总线平台进行业务请求的消息路由；6、 智能网管服务总线平台向数据目标系统转发数据共享通知的业务请求；7、 数据目标系统保存业务请求；8、 数据目标系统向智能网管服务总线平台返回确认收到业务请求的响应；9、 智能网管服务总线平台实例化确认消息；i、 数据目标系统到FTP服务器上去下载数据；ii、 数据目标系统对数据进行业务处理；当服务数据源系统需要接收数据目标系统的确认消息时，数据源系统需提供接收确认消息的接口服务供智能网管服务总线平台调用；10、 智能网管服务总线平台向数据源系统转发服务提供方的确认消息；11、 数据源系统向智能网管服务总线平台返回响应。6. 消息框架协议6.1 协议

15、格式定义为统一服务交互过程中的协议格式，对协议格式中的每个XML元素按照以下7个方面进行描述：1 按照元素所在的层级及同层级的次序编号，例如：父元素的层级为2，则此父元素下的所有子元素的次序编号全部加1，即：层级编号为3。规定SOAP 协议的根元素soapenv:Envelope 的层次编号为1。2 元素名称3 父元素名称4 约束：元素出现次数5 类型：元素的数据类型6 长度：元素的数据长度7 描述其中，约束、类型、长度的符号说明如下：序号格式定义类型格式符号用途备注1约束?0.1有0 到一个元素 2*0.n有0 到n个元素3+1.n有1 到n个元素411有一个元素5类型String 字符串 6Number 数字 7Int 整数