CMMB通讯平台接口规范的设计方案.doc

CMMB中央通讯平台接口规范设计方案 2011-2-12 修订记录： 版本号 修订时间 修订人 修订内容 1.1 2011-2-12 冯帅 初稿完成 1.2 2011-3-18 冯帅 修改消息头定义 1.3 2011-3-23 冯帅 修改基础数据版本定义； 修改参数定义接口 修改设备链路接口定义； 修改生产数据同步接口定义 增加查询参数值回放接口 修改运维消息接口定义 修改同步基础数据流程描述 修改同步生产数据流程描述 1.4 2011-3-31 冯帅 修改数据结构以适配JAVA平台，省、地市级平台接口合并 前言 方案概述 本方案旨在为中央级平台与省级平台及地市级平台之间提供统一的数据传输接口。为了满足对实时数据传输、批量数据同步和按需实时传输三种数据传输需求，采用ESB作为系统数据传输平台。 通过该方案能够明确省、地市级平台同中央级平台之间的系统边界，交互方式，交互内容等信息。该方案主要分为编码规范及接口设计两部分。接口设计分为以下几类：接口方式及交互系统范围，接口整体描述，接口方法描述，业务服务接口定义，关键业务流程描述，接口交换数据定义，ESB服务注册及调用方式。 编码规范：描述CMMB系统使用的编码体系。包括：数据版本标识编码、监控对象编码、设备类型编码、设备编码、人员编码。 接口方式及交互范围：描述中央级平台与省、地市级平台之间的接口交互方式和交换范围。 接口整体描述：描述服务接口的主要分类。 接口方法描述：描述接口服务的调用场景，系统间交互的数据，及对交互数据定义的规范。 关键业务流程描述：通过关键业务的流程图及对流程图的描述，来体现服务提供方和服务调用方之间的业务流程。 业务服务接口定义：描述服务提供者对外发布服务的服务名称，命名空间，服务参数，参数类型等内容。 接口交换数据定义：描述各级平台提交的数据所遵循数据定义规范。 编码规范 本方案中所涉及的数据版本标识、监控对象编码、设备类型编码、设备编码、人员编码均采用《CMMB监控系统软件技术方案-1227》中的编码规范。除此之外，由于各级平台提供的服务应部署在相应的监控中心，因此将各平台监控中心的监控对象编码作为其在ESB中的全局标识。 接口设计 接口方式及交互范围 CMMB三级平台包括：中央级平台、省级平台、地市级平台。平台之间的通讯通过ESB系统完成，对应的接口表现为WebService形式。 中央级平台同省、地市级平台的交互内容主要包括：各平台监控对象信息、CMMB相关设备的实时及历史信息、人员信息。 本方案用于中央级平台与省级平台、中央级平台与地市级平台之间的数据通讯。省级平台与地市级平台之间的通讯方式与数据协议不在此方案范围内。 接口整体描述 服务接口分为以下几类： 设备信息服务接口：中央级平台定义受监设备的类型和参数项，并下发给省、地市级平台；中央级平台定期对省、地市级平台的监控对象部署情况进行查询，并将各地市级平台采集的设备运行历史信息进行收集汇总；地市级平台将设备告警信息推送到中央、省级平台。 人员信息服务接口：中央级平台对省、地市级平台的工作人员信息进行查询。 监控对象信息服务接口：中央级平台对省、地市级平台的监控对象状态信息进行查询。 运维信息服务接口：中央级平台对省、地市级平台的运维日志进行查询和查询；各级平台之间发送运维消息（请求和通知）；中央级平台查询省、地市级平台监控对象的基础数据版本，以确定是否需要对基础数据进行更新。 服务名称 服务方法 接口提供方 接口使用方 设备信息服务 查询设备类型定义表 中央级平台 省、地市级平台 查询设备实例表 省、地市级平台 中央级平台 查询设备参数定义 中央级平台 省、地市级平台 查询设备参数实时信息 省、地市级平台 中央级平台 查询设备参数历史回放信息 省、地市级平台 中央级平台 查询生产数据 省、地市级平台 中央级平台 接收生产数据上传事件通知 中央级平台 省、地市级平台 设定日常生产数据上传时间 省、地市级平台 中央级平台 接收上报数据信息 中央级平台 省、地市级平台 查询设备逻辑拓扑 省、地市级平台 中央级平台 接收参数定义变更 省、地市级平台 中央级平台 接收设备类型变更 省、地市级平台 中央级平台 查询设备厂商列表 中央级平台 省、地市级平台 接收设备厂商更新列表 省、地市级平台 中央级平台 人员信息服务 查询隶属于某监控对象下的人员信息 省、地市级平台 中央级平台 监控对象信息服务 查询监控对象资源目录 省、地市级平台 中央级平台 查询监控对象状态 所有平台 所有平台 设置监控对象状态 省、地市级平台 中央级平台 查询地市级监控对象拓扑关系 省、地市级平台 中央级平台 运维信息服务 查询运维日志