ICS 35.240.60 V 07 MH 中华人民共和国民用航空行业标准 MH/T 0048.2 —2015 民用机场共用旅客处理系统技术规范 第 2部分：应用软件数据交换 Specification of common use passenger proce ssing systems in civil aviation airports Part 2：Interface between applications 2015 - 09 - 30 发布 2015 - 12 -01 实施 中国民用航空局 发布 MH/T 0048.2 —2015 I 目 次 前言 ............................................................. ................... II 1 范围 ........................................................... ................... 1 2 术语和定义 ........................................................ ................ 1 3 数据交换 接口通用标准 ................................................... ........... 1 4 数据交换 接口消息处理规则 ................................................. ........ 23 附录 A（资料性附录） 数据交换接口及消息处理示例 ..................................... 32 MH/T 0048.2 —2015 II 前 言 MH/T 0048分为以下三个部分： ——第 1 部分：系统结构； ——第 2 部分：应用软件数据交换； ——第 3 部分：硬件设备数据交换。 本部分为MH/T 0048的第2部分。 本部分按照GB/T 1.1-2009给出的规则起草。 本部分由中国民用航空局人教司提出。 本部分由中国民用航空局航空器适航审定司批准立项。 本部分由中国民航科学技术研究院归口。 本部分起草单位：中国民航大学、中国民航信息网络股份有限公司。 本部分主要起草人：李建伏、孙皓、贺怀清、张博、惠康华、丁玎、徐涛、武佳、孙启玲、李斌。 MHMH/T 0048.2 —2015 1 民用机场共用旅客处理系统技术规范 第 2部分：应用软件数据交换 1 范围 MH/T 0048的本部分规定了共用旅客处理系统的应用软件与管理平台之间数据交换接口技术规范。 本部分适用于中国民用机场共用旅客处理系统的建设。 2 术语和定义 2.1 共用旅客处理系统 CUPPS Common Use Passe nger Processing Systems 由国际航协定义，用于航空公司使用机场的终端设备的信息处理规范。 [MH/T 0048.1-2014中的3.1] 2.2 CUPPS工作站 CUPPS Workstation 运行于CUPPS平台上的硬件和操作系统软件。硬件包括计算机、移动终端设备、智能手机、简易客 户终端等。 [MH/T0048.1-2014中的3.2] 2.3 CUPPS应用 CUPPS Application 运行在CUPPS平台上，使用CUPPS平台接口的应用程序。 [MH/T 0048.1-2014中的3.3] 3 数据交换接口通用标准 3.1 平台架构 平台管理所有连接到平台的请求，并为这些连接提供标准接口来访问机场资源和其他系统。 平台可使用多种体系架构，见图1。 MH/T 0048.2 —2015 2 图1 平台架构 平台架构由以下组成，应用程序1使用设备1和2，应用程序2使用设备1，应用程序3使用设备3： —— (a)实现架构：表示在该平台上应用程序通过一个节点(节点 1)连接到所有设备，每个逻辑设 备由一个独立的物理设备实现； —— (b)实现架构：表示在该平台上应用程序通过两个节点(节点 1 和2)连接到设备，节点 1 提供 了物理设备 1 的逻辑接口。节点 2 为一个多功能物理设备提供逻辑接口； —— (c)实现架构：表示在该平台上，应用程序首先连接到节点 1，该节点提供了一个逻辑分配机 制，使应用程序可重定向到其他节点。当应用程序 1 连接到平台上的节点 1 获取逻辑设备 1 和 2 时，该平台分别将应用程序 1重定向到节点 2 和3；当应用 2 连接到平台上的节点 1 获取逻辑设备 2时，该平台将应用 2 重定向到节点 3；当应用 3连接到平台上的节点 1获取逻辑设备 3，该平台将应用程序 3 重定向到节点 4。其中，所有的逻辑设备是通过一个多功能物理设 MHMH/T 0048.2 —2015 3 备来实现。 注：应用程序通过设备的名称和接口访问设备，与设备所在位置无关，名称和接口都由环境变量指定。应用程序不 能推理出平台组件的任何特定实现方法，以及设备与平台连接的任何特定物理实现方法。 3.2 接口状态 CUPPS接口的不同状态如表1所示。 在生产环境中， 如果应用程序试图使用支持状态之外的接口， 平台应记录相应的信息供管理员审查， 并触发警报。 表1 CUPPS接口状态 状态 描述 提出 接口已经被提出，但是还没计划 计划 接口正在计划中 开发 接口处于实验性测试状态，不能在生产环境中使用 支持 接口处于正常的生产状态 不建议 接口仍然被支持，但不推荐使用。该接口即将进入过时状态。在生产过程中对该接口的任何使用，都将产 生一个警告，且被平台记录下来 废弃 接口不再被支持。在生产中任何试图使用这种接口的行为都产生一个错误 3.3 接口版本 3.3.1 在每个单独的 TCP(Transmission Control Protocol 传输控制协议)端口上的平台和设备端应同 时支持多个版本的 CUPPS 接口。当应用程序连接到 CUPPS 平台后，首先应请求得到该平台支持的接口版本列表，然后从获取的接口版本列表中选择一个版本进行后续的会话。 3.3.2 会话消息需通过已选择的接口版本的校验。如果校验失败，则触发<sessionEr rorEvent>消息， 并立即关闭该会话。 3.3.3 如果应用程序在版本列表中没有找到支持的接口，应用程序应做以下处理： a) 记录错误； b) 发送一个错误事件； c) 通知终端用户。终端用户根据提示信息，咨询相应的技术支持人员。 所有的 CUPPS接口都遵守一套通用的基本规则。所有 CUPPS接口应使用 TCP套接字，消息交换内容 应符合已定义 XSD(XML Schemas Definition，XML 结构定义)的 W3C(World Wide Web Consortium,万维网 联盟 ) XML(Extensible Markup Language ，可扩展标记语言 )消息格式。 3.4 平台主机名和端口 应用程序通过TCP/IP(In ternet Protocol，网络间通信协议)连接服务器，服务器应向应用程序提 供对应的服务器主机名和端口。应用程序根据CUPPSPN与CUPPSPP环境变量确定平台的主机名和端口。考虑到生产和测试环境的灵活性，可使用IP地址127.0.0.1。 3.5 会话原则 3.5.1 会话流程 应用程序和平台之间的会话流程图如图2所示，主要包括以下几个步骤： MH/T 0048.2 —2015 4 a) 平台监听一个已知的节点和端口； b) 应用程序连接到平台的相应节点和端口。在连接时，应用程序向平台发出可用接口版本列表请 求，平台收到请求后返回可用接口列表； c) 应用程序向平台发送期望使用的接口版本。该接口版本经平台确认后，将用于后续会话消息的验证； d) 平台验证应用程序的合法性，并返回验证结果。如果验证成功，则应在验证结果中包含令牌信息。该令牌信息应用于所有后续通信以及验证设备连接。当平台连接关闭后，令牌失效，基于此令牌的连接也应立即断开； e) 应用程序使用已定义消息集与平台进行通信。对于每个设备会话，应用程序在断开连接之前，均应发送<deviceRelea seRequest>并获得平台对应的响应； f) 应用程序断开。当应用程序关闭时，应向平台发送<byeRequest>消息，获取<byeResponse>消息后方可断开连接。 建立连接 设置接口版本 认证 使用 断开连接重定向 图2 会话流程 基本的会话连接序列图原型参见附录A.1。 3.5.2 消息处理流程 3.5.2.1 建立连接后,当接收端收到消息时，应判断消息流的合法性。 3.5.2.2 消息从接收到处理的流程见图 3。处理流程如下： a) 接收端逐字节地读取消息头：如果接收端读取到无效字符，则接收端立即停止读取，发送 <sessionErrorEvent>的通知，并在该通知中包含信息 eventType = “headerVersion” ，随后 关闭连接。如果接收端读取的消息长度越界，则接收端发送<sessio nErrorE