（计算机应用技术专业论文）基于cgip的通用网关平台研究与实现.pdf

武汉科技大学硕士学位论文第1 页 摘要 随着3 g 推进实施，各种基于3 g 的新业务应用会不断增加，如何在原有平台、系统上 快速增加新应用，让原有系统平滑升级是各电信运营商和服务提供商迫切需要解决的问 题。 本文的通用网关平台立足于3 g 环境，为湖南移动提供一通用网关。该网关在深入研 究c m p p 3 0 的基础上自定义c g i p 协议，该协议主要包括基础、业务、监控、管理等类接 口约束，是系统实现的核心。在系统架构方面充分考虑系统高扩展、松耦合特性采用分层 设计。由于通用网关数据处理量大、实时性要求高，所以系统从两个层面考虑性能控制： 一方面从业务粒度对每个业务采取独立的流量控制；另一方面从系统粒度，对各网关节点 实现c a c h e 机制，保证各网关节点处理速度、防止拥塞。 该网关是业务系统与业务网关交互的桥梁，不同业务系统用同一协议与网关节点通 讯，网关节点再通过不同的协议适配器与不同的业务网关交互。网关节点是整个网关平台 的核心，具备基础服务、能力支撑、策略控制、数据持久等功能；网关主节点是一类特殊 的网关节点，主要完成各组件、节点初始化；适配器节点主要完成协议适配功能、日志记 录功能；管理平台是提供给通用网关管理员使用的管理软件，能够使管理人员灵活的增加、 修改、配置通用网关以及日志查询与统计等功能。 本论文首先对通用网关所需理论基础进行研究，对网关实现所需要的核心协议进行自 定义。在关键技术解决的基础上完成系统的总体设计、模块详细设计。在设计的基础上实 现系统各功能模块，并对核心组件的实现进行介绍。 关键词：3 g ；网关；c m p p ；c g i p ；适配器 a b s t r a c t a l o n gw i t hp r o m o t i n ga n di m p l e m e n t a t i o no f3 g ，a l lk i n d so fn e wb u s i n e s sa p p l i c a t i o n s b a s e d3 gw i l lb eo nt h ei n c r e a s e t h ep r o b l e m st h a tt e l e c o ma n d s e r v i c ep r o v i d e r sn e e dt 0b e a d d r e s s e du r g e n t l yi st h a th o wt oi n c r e a s en e w a p p l i c a t i o no nt h eo r i g i n a lp l a t f o r ma n dt h e s y s t e ma n dt os m o o t h l yu p d a t ef r o mo r i g i n a ls y s t e m t h ep a p e rd e s c r i b e st h ec o m m o n g a t e w a yp l a t f o r mt h a tb a s e so nt h e3 ge n v i r o 砌e n t w h i c hp r o v i d e sac o m m o ng a t e w a yf o rh u n a nm o b i l ec o m m u n i c a t i o nc o r p o r a t i o n i nt h e f o u n d a t i o no fi n t e n s i v es t u d y i n gt h ec m p p 3 0 ，w ed e f i n et h ec g i p ( c o m m o ng a t e w a y i n t e r f a c ep r o t o c 0 1 ) ，w h i c hi n c l u d e st h ef o u n d a t i o n ，b u s i n e s s ，m o n i t o r i n ga n dm a n a g 锄e n t i n t e r f a c ec o n s t r a i n t sa n di ti st h ek e yo f s y s t e m o ns y s t e ma r c h i t e c t u r ew et a k ef u l l ya c c o u n t o ft h es y s t e m sh i g h l ys c a l a b l ea n dl o o s e l yc o u p l e dp r o p e r t y ，s oc h o i c es p l i t 1 e v e l d e s i 盟 b e c a u s et h ec o m m o ng a t e w a y p r o c e s sal a r g eo f c o n s i d e rt h ep e r f o r m a n c eo fc o n t r o l i n gf r o mt h e d a t aa n dn e e dah i g hr e a lt i m ec a p a b i l i t y , t o ws i d e s ：o nt h eo n eh a n d ，b a s eo na b u s i n e s sg r a n u l a r i t y , t oc o n t r o ld a t a - f l o wf o re a c hn o d e ；o nt h eo t h e rh a n d ，b a s eo nas v s t e l i l g r a n u l a r i t y ，i m p l e m e n tc a c h em e c h a n i s mt oe n s u r et h ep r o c e s s i n g s p e e da n dp r e v e n t c o n g e s t i o no ft h eg a t e w a yn o d e s t h eg a t e w a yi s t h e b r i d g et h a tb u s i n e s ss y s t e m sc o n n e c t sw i t hb u s i n e s sg a t e 、v a y d i f f e r e n tb u s i n e s ss y s t e m sc o m r n u i c a t ew i t hg a t e w a yn o d e sb yt h es a m ep r o t o c 0 1 g a t e w a v n o d e sc o n n e c tw i t hd i f f e r e n tb u s i n e s ss y s t e m st h r o u g hd i f f e r e n ta d a p t e r s g a t e w a yn o d e s a r e t h ec o r eo ft h eg a t e w a y i th a ss o m e f u n c t i o n s ，s u ch a sb a s i cs e r v i c e , c a p a c i t y s u p p o r t p o l i c y c o n t r o l ，d a t ap e r s e v e r a n c ea n ds oo n t h em a i ng a t e w a yn o d e sa r et h es p e c i a lk i n do f g a t e w a y n o d e st h a tt h ef u n c t i o n sa r er e s p o n s i b l ef o r i n i t i a l i z i n gt h ec o m p o n e n t sa n dt h en o d e s a d a p t e r n o d e sa r er e s p o n s i b l ef o rt h ec a p a c i t yo f a d a p t e r i n gp r o t o c 0 1 m a n a g e m e n tp l a t f o r mp r o v i d e s m a n a g e m e n ts o f t w a r ef o rm ea d m i n i s t r a t o r s ，a n da d m i n i s t r a t o r sc a l lm a n a g et o i n c r e a s e m o d i f y ，c o n f i gt h eb a s i cg a t e w a y , a n dm a n a g et o q u e r yl o ga n ds t a t i s t i c s t h i s p a p e r d e s c r i b e st h eb a s i st h e o r yo ft h er e q u i r e dc o m m o ng a t e w a y ，d e f t n e st l l e c o r eo f p r o t o c o l t h a tg a t e w a yn e e d e dt oa c h i e v e ，c o m p l e t e sf u n c t i o nm o d u l e s o nt h eb a s eo f t h ed e s i g na n di n t r o d u c e s t h ec o r eo f c o m p o n e n t st h a ta r es l o v e d k e yw o r d s ：3 g ；g a t e w a y ；c m p p ；c g i p ；a d a p t e r 武汉科技大学 研究生学位论文创新性声明 本人郑重声明：所呈交的学位论文是本人在导师指导下，独立进行研 究所取得的成果。除了文中已经注明引用的内容或属合作研究共同完成盼 工作外，本论文不包含任何其他个人或集体已经发表或撰写过的作品成果 对本文的研究做出重要贡献的个人和集体，均已在文中以明确方式标明 申请学位论文与资料若有不实之处，本人承担一切相关责任 论文作者签名：至堡 日期：堡堕三! 三! 研究生学位论文版权使用授权声明 本论文的研究成果归武汉科技大学所有，其研究内容不得以其它单位 的名义发表。本人完全了解武汉科技大学有关保留、使用学位论文的规定， 同意学校保留并向有关部门( 按照武汉科技大学关于研究生学位论文收录 工作的规定执行) 送交论文的复印件和电子版本，允许论文被查阅和借阅， 同意学校将本论文的全部或部分内容编入学校认可的国家相关数据库进行 检索和对外服务。 论文作者签名： 垂笙 一 指导教师签名：吐 日 武汉科技大学硕士学位论文第1 页 第一章绪论 1 1 课题背景 近几年，在信息技术革命和经济全球化的推动下，世界电信业发生了巨大的变化，发 展和变革的浪潮席卷全球，一个以整合通信、网络技术为基础的“移动互联新生态”正在 世界范围内迅速发展，通讯技术正在从2 g 、2 5 g 向3 g 悄然迈进。目前，3 g 市场稳步发展， 2 0 0 8 年1 月n l o 月全球新增3 g 许可证l o 个，许可证总数达至1 j 1 6 4 张，涵盖了5 7 个国家，用户 总数达n 84 0 0 多万【。据预计，未来国内3 g 产业将衍生出2 5 万亿元的电信运营市场，以 及l 万亿元以上的电信增值业务市场，对g d p 的直接贡献比例将达到1 1 7 t 2 1 。随着民族 标准胪s c d m a 的成熟以及3 g 产业链的基本建成，目前t d 联盟已经在北京、上海、保定、 青岛、厦门等地进行3 + 2 模式的网络试验，这无疑是标志着中国3 g 市场即将启动的强烈信 号。3 g 将为电信行业带来新的机遇和挑战。 中国移动作为具有绝对竞争力的电信运营商在3 g 建设上也处于领先地位，在1 0 城市 t d s c d m a 试验网的基础上，中国移动已经在2 0 0 8 年末顺利完成了t d s c d m a 与2 g 网的 核心网融合的工程，实现现有的2 g 客户可以“不换号、不换卡、不登记”、只要换一部双 模手机就可以方便地使用3 g j 艮务。与此同时，t d s c d m a 的二期工程建设已经全面展开， 今年6 月可新增2 8 个城市的t d s c d m a t 3 1 的网络覆盖。根据公司的规划，至u 2 0 1 1 年， t d s c d m a 网络将覆盖全国1 0 0 的地市。 随着国内3 g 网络实施及各种应用的深入，如何将原有2 g 、2 5 g 上的众多应用系统进行 平滑升级，尽可能的降低重构成本是众多通讯应用开发商需解决的难题。 1 2 课题提出 湖南移动在推进3 g 应用的过程中也面临同样的问题。首先，运营支撑系统( b o s s ) 、 面向数据增值业务的综合平台( v g o p ) 、数据业务管理平台( d s m p ) 、应用数据中- i ) ( a d c ) 等信息化平台通过不同接1 2 1 访问移动相关数据中心，而与不同接口的交互运行着不同的协 议，如：短信网关运行c m p p 协议 4 1 、彩信中心则运8 彳】m m 5 t 5 】协议。其次，随着信息化的 深入，各种基于3 g 的信息化业务需求不断增加，新增业务系统需要无缝接入已有平台。相 关业务系统开发人员在实际的开发过程中需要关注太多的不同协议接口细节、底层通讯技 术，增加了开发人员的开发难度和开发成本。为了解决业务系统开发人员开发过程中面临 的问题，提出基于3 g 业务的通用网关平台立项需求。 1 3 论文结构 全文共由六章组成。第一章为绪论，介绍了3 g 应用现状，讨论了该通用网关的应用背 景。第二章对网关的理论基础c m p p 协议和结构模型进行了简要介绍。第三章给出了系统 核心解决方案整个系统软件体系结构和自定义接口协议c g i p 。第四章对系统总体设计和 网关节点、适配器节点、管理门户三模块设计进行描述。第五章分析了网关实现过程中的 第2 页武汉科技大学硕士学位论文 核心组件和这些组件实现的原理和所用技术。第六章总结立项、设计、开发等过程，并指 出改进方向。 武汉科技大学 硕士学位论文第3 页 第二章理论基础 2 1c m p p 3 0 协议 2 1 1 协议概述 c m p p 中国移动点对点协议，是c h i n am o b i l ep e e rt op e e r 的简称，是中国移动通信互 联短信网关接口协议【6 1 。它规定了以下三个方面的内容：信息资源站实体与互联网短信网关 之间的接口协议；互联网短信网关之间的接口协议：互联网短信网关与汇接网关的接口协 议。 c m p p 协议以t c p 口作为底层通信承载，各网元之间的交互过程中均采用异步方式， 即任一网元在收到请求消息后应立即回送响应消息。具体结构如下： s pi s m gi s 蛐gg n s c m p p c m p pc m p p c m p p t c pt c pt c pt c p i pi pi pi p 底层承载底层承载底层承载底层承载 图2 1c m p p 协议栈 2 1 2 通讯方式 由于c m p p 协议是以t c p 口协议作为底层承载，因此，s p 与i s m g 之间、i s m g 之间进 行信息交互时，可以采用长连接方式，也可以采用短连接方式。所谓长连接，指在一个t c p 连接上可以连续发送多个数据包，在t c p 连接保持期间，如果没有数据包发送，需要双方 发链路检测包以维持此连接。短连接是指通信双方有数据交互时，就建立一个t c p 连接， 数据发送完成后，则断开此t c p 连接，即每次t c p 连接只完成一对c m p p 消息的发送。 长连接 通信双方以客户服务器方式建立t c p 连接，用于双方信息的相互提交。当信道上没有 数据传输时，通信双方应每隔时间c 发送链路检测包以维持此连接，当链路检测包发出超 过时间t 后未收到响应，应立即再发送链路检测包，再连续发送n 1 次后仍未得到响应则断 开此连接。 参数c 、t 、n 原则上应可配置，默认取值为：c = 3 分钟，t = 6 0 秒，n = 3 。 网关与s p 之间、网关之问的消息发送后等待t 秒后未收到响应，应立即重发，再连续 发送n 1 次后仍未得到响应则停发。现阶段建议取值为：t = 6 0 秒，n = 3 。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数w 可配置，默认取值 为1 6 ，即接收方在应答前一次收到的消息最多不超过1 6 条。 短连接 第4 贞武汉科技大学硕 学位论文 通信双方以客户一服务器方式建立t c p 连接，应答与请求在同一个连接中完成。系统采 用客户服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。 刚关与s p 之间、m 关之问的消息发送后等待t 秒后末收到响应，j 越立叩重发，再连续 发送n 1 次后仍末得到响麻则停发。现阶段建议般值为：t = 6 0 秒，n = 3 。 2 2b s 结构模型 b s 模式n 即浏览器月慢务器模式，足以w e b 为中心采用t c p i p 8 州，h t t p 传输协议， 客户端通过浏览g - 器( b r o w s e r ) 访f 1 w e b 月t 务器( w e bs e r v e n 以及与w e b 相连的后台数据库 ( d a t a b a s e ) ，足一种从传统的_ 二层c s 模式发展起来的新的网络结构模式其本质是三层结 构c s 模式。如下网所示： ，s - 一一7 蝌器 i n t e m e t ? 、一、b， 闻”8 旬舒 埚l 型酊 a 矗“” 图2 2b 塌模式结构 b s 兰层结构分为3 个部分： f 1 ) 浏览器是用户界面层软件，负责用户与应用之自j 进行对话的任务。对用户输入进行 验证，尽早消除错误，减少网上数据1 输，加快响应速度。 f 2 ) w e b 服务器实体内存放有业务逻辑层软件，用束响应浏览器的请求，去完成相应的 业务处理或复杂的计算任务，如果有数据库访问任务时，则可进步向数据库服务器发送 相应的s q l 语句。 0 做据库服务器实体内则驻留有数据库服务层软件，用柬执行w e b 服务器发送来的 s q l 语句负责管理对数据库数据的读写，数据库查询与更新等任务。任务完成后逐层地 返回给浏览器的用户。 b s 结构利用人量成熟的w e b 浏览器技术，并结台中白j 件技术，实现了需要复杂软件设 计一可以实现的客户端功能，节约7 开发成本，同时解决了c ，s 模式客户端需要维护的缺 点，是一种全新的软件构造技术。b s 具有分靠性强、维护方便、开发简单、成本低、易 升级、且共享性强等优点。 在b s 结构下，整个系统的管理、资源分配、数据库操作、业务逻辑部件的管理及动 态加载等等工作都集中于应用服务器。同时，由_ 丁工作集中，可以降低客户机的管理难度 及客户汁算机配置。仅仅提高应用服务器及数据库服务器的品质，就可以提高整个系统的 运行效率，从而有效的降低了系统部署和管理的难度。 武汉科技大学硕士学位论文第5 页 目前，b s 多层体系结构已成为主流的开发模式，这极大地简化客户机的工作，客户 机上只要安装有浏览器即可，对数据库的访问和应用程序的执行都将在服务器上完成，允 许不同用户从不同的地点以不同的接入方式( 如l a n 、w a n 、i n t e m e t i n t r a n e t 等) 通过不同 的操作系统访问和操作公共数据库，异地办公性能优越，维护升级方便。 2 3 本章小结 本章对系统设计、实施过程中所需要的理论基础进行介绍。为后续的总体解决方案、 自定义接口协议和关键技术【lo 】提供理论依据，保证整个系统设计的合理和优越性。 第6 页武汉科技大学硕士学位论文 第三章系统解决方案 3 1 软件体系结构 为了降低系统各功能模块的耦合性、便于项目组分工协作开发、也便于代码维护和重 用，在深入理解b s 结构模型的基础上，充分借鉴文献 1 1 、 1 2 n 1 3 中的设计思想，整 个系统的软件体系结构采用分层设计思想，分为数据层、支撑层、通讯层、应用层、用户 层。数据层主要是数据的存储，t 要涉及开志文件、配置相关x m l 文件、o r a c l e “”数据表： 支撑层丰要部署相关的物理数据处理封装组件；通讯层毛要部署通讯相关的数据转换、协 议处理等基础组件：应用层主要部署业务处理逻辑帽关服务；用户层主要是用户使用接l 1 。 处理系统自下而上逐层提供服务，各层以接口相连，互不干扰，可分别独立设计和维护。 层级内部又按功能划分成相对更小独立模块。各独立模块被封装为独立的b e a n 服务“7 ”1 ， 所有服务则被注入s p r i n g 容器“9 州巾，被统一管理。结构如图3 1 所示； 图3 1 软件件系结构 3 2c 2 i p 协议 c g i p 一通用同关接口协议，是c o m m o ng a t e w a yi n t e r f a c ep r o t o c o l 的简称。是在奉 通用网关设计丌发过程中根据需要、参考c m p p 3 0 自定义的系统内部接口协议。 臣团 口圃 袁撵量 e 团 女暮熹qz 武汉科技大学硕士学位论文第7 页 3 2 1 协议应用环境 图3 0 接口总体视图 两缴节点接口类视图( 图3 2 ) 表明t c c i p 协议在系统中的使用环境和地位。 3 2 2 协议约束 通讯方式 适配器节点与网关节点之间进行信息交互时，采用长连接方式。所谓长连接，指在一 个t c p 连接上可以连续发送多个数据包，e t c p 连接保持期间，如果没有数据包发送，需要 双方发链路检测包以维持此连接。 通信双方采用长连接方式。以客户一服务器方式建立t c p 连接，用于双方信息的相互提 交。当信道上没有数据传输时，通信双方应每隔时间c 发送链路榆测包以维持此连接，当 链路检测包发出的时间超过t 后未收到响应，应立即再发送链路检测包，再连续发送n 1 次 后仍未得到响应则断丌此连接。 参数c 、t 、n 可配置，默认取值为：c - 3 分钟。t - 6 0 秒，n - 3 。 网关与s p 之间、网关之间的消息发送后等待t 秒后未收到响应，应立即重发，再连续 发送n 一1 次后仍未得到响应则停发。现阶段建议取值为：t6 0 秒n3 。 消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数w 可配置，现阶段建 议为1 6 ，即接收方在应答前一次收到的消息晟多不超过1 6 条。 x m lo v e rs o c k e t 消息 此类接口描述了基于) ( m lo v e rs o c k e t 。”协议而进行的通信机制。交易消息( 包括请求 第8 页武汉科技大学硕士学位论文 和应答) 是以x m l 格式表达的，包括三个部分：消息总长度、m e s s a g eh e a d e r ( 消息头) 与 m e s s a g eb o d y ( 消息体) 。其中，m e s s a g eh e a d e r 用于存储交易请求以及应答的公共部分和 消息的控制数据，而m e s s a g eb o d y 包含交易请求和应答的业务数据，m e s s a g eb o d y 的数据 应该是适配器节点提供的w s d l 对应协议数据，该部分数据可以是压缩或非压缩，如果是压 缩数据，可以选择用b a s e 6 4 进行编码传输。 基础类接口 登录( c g i p l o g i n ) 操作 该接口协议适用于： 适配器节点一登录到一网关节点 管理客户端一登录到一专任意节点 监控客户端一一登录到一专任意节点 c g i p l o g i n r e q 操作的目的是客户端向服务端登录作为一个合法客户端身份，若登录 成功后即建立了应用层的连接，此后客户端可以通过此连接进行其他接口协议的操作。 服务端以c g i p _ l o g i n r e s p 消息响应客户端的请求。 c g i p l o g i n r e q 消息定义 表3 1c g i p - - l o g r n _ r e q 字段名 字1 了数 属性描述 c 1 i e n ti d6o c t e ts t r i n g客户端i d a u t h e n tic a t o r s o u r c e1 6o c t e ts t r i n g用丁鉴别源地址。其值通过单向m d 5 h a s h 计算得出，表示如下： a u t h e n t i c a t o r c li e n t = m d 5 ( c 1l e n t i d + 9 字节的0 + l o g i n _ p a s s + t i m e s t a m p ) l o g i n _ p a s s 由通用网关平台管理员 分配，t i m e s t a m p 格式为：m m d d h h m m s s ，即月日时分秒，1 0 位 v e r s i o n1u n s i g n e d双方协商的版本号( 高位4 h i t 表示主 i n t e g e r版本号，低位4 b i t 表示次版本号) t i m e s t a m p 4 u n s i g n e d时间戳的明文，由客户端产生，格式为 i n t e g e r删d d h h m m s s ，即月日时分秒，l o 位数 字的整型，右对齐 夺c g i p _ l o g i n r e s p 消息定义 表3 2c g i p - - l o g i n _ r e s p 字段名字节数 属性 描述 s t a t u sl u n s i g n e d0 ：止确 i n t e g e r1 ：消息结构错 武汉科技大学硕士学位论文第9 页 录。 2 ：非法客户端 3 ：认证错 4 ：版本太高 5 ：其他错误 a u t h e n t i c a t o r s e r v e1 6o c t e ts t r i n g服务端认证码，用于鉴别是否合法服 r 务端。 其值通过单向m d 5h a s h 计算得出，表 示如下： a u t h e n ti c a t o r s e r v e r = m d 5 ( s t a t u s + a u t h e n t i c a t o r c li e n t + l o g i np a s s ) ，l o g i n _ p a s s 由通用网关管理员分 配，h u t h e n t i c a t o r c l i e n t 为客户端 实体发送给服务端的对应消息 c g i p _ l o g i n _ r e q 中的值。 认证出错时，此项为空。 v e r s i o n1 u n s i g n e d服务器支持的最高版本号 i n t e g e r 登出( c g i pl o g o u t ) 操作 该接口协议适用于： 适配器节点登录到一专网关节点 管理客户端一登录到一一一任意节点 监控客户端一登录到一专任意节点 c g i pl o g o u tr e q 操作的目的是客户端成功登录到服务端后，需要从服务端中退出登 服务端以c g i p _ l o g o u t _ r e s p 消息响应。 令c g i p o g o u t _ r e q 消息定义 该消息包只需要有消息头，无消息体。 令c g i p _ l o g o u t r e s p 消息定义 表3 3c g i pl o g o u tr e s p 字段名字节数属性描述 r e s u l tl u n s i g n e d o ：正确 i n t e g e r l ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：无效的客户端 第1 0 页武汉科技大学硕士学位论文 心跳( c g i pa c t i v e ) 操作 c g i pa c t i v e 操作的目的是适用于通信双方采用长连接通信方式时用于保持连接。 夺c g i p _ a c t i v e _ r e q 消息定义 该消息包只有包头，没有包体。 夺c g i p _ a c t i v e _ r e s p 消息定义 表3 4c g i pa c t i v er e s p l 字段名字节数 属性 描述 l r e s e r v e d l u n s i g n e di n t e g e r保留 业务类接口 转发异步业务( c g i pt r a n sa s y n cb u s i ) 操作 异步转发业务操作是指所有外部节点向通用网关发起请求的转发，此种请求不需要等 待业务系统的处理结果，通用网关可以马上返回，比如短信能力上行。 令c g i p _ t r a n s _ _ a s y n c _ b u s i r e q 消息定义 表3 5c g i p j r a n sa s v n cb u s i _ r e q 字段名字节数属性描述 s o u r c e _ n o d e i d 1 0o c t e ts t r i n g源节点i d 。 d e s t _ n o d e i d 1 0 o c t e ts t r i n g目标节点i d i nt e r f a c e _ i d1 0o c t e ts t r i n g接口i d s e n d e r _ i d 1 0o c t e ts t r i n g发送者i d r e c ei v e r _ i d1 0 o c t e ts t r i n g接收者i d w s d l _ n a m e 2 0o c t e ts t r i n g该接口的w s d l 描述文件名 b u si m s g _ b o d y l u n s i g n e d 业务包体是否压缩 c o m p r e s s i n t e g e rl 为压缩 0 为末压缩 b u s im s gb o d y _1 u n s i g n e d业务包体是否使用b a s e 6 4 编码 b a s e 6 4i n t e g e r1 为使用b a s e 6 4 编码 0 为未使用b a s e 6 4 编码 b u s im s g _ n a m e2 0o c t e ts t r i n g业务消息名称，该消息名是适配器根据适 配的协议抽象出的w s d l 描述的消息名， 具体名称适配器会填在该字段 r e s e r v e8o c t e ts t r i n g保留 b u s im s g _ b o d y 4 u n s i g n e d业务消息长度 l e n g t hi n t e g e r 武汉科技大学硕士学位论文第1 1 页 b u s i _ m s g _ b o d yi b u s im s g _ b o d y i b i nd a t ab 1 一i 适配器需要转发的实际业务数据包，改字 ll e n g t hlo c ki 段的解码需要利用w s d l _ n a m e 指定的描述 文件进行解包 令c g i pt r a n s _ a s y n c b u s i r e s p 消息定义 表3 6c g i pt r a n sa s y n c _ b u s i _ r e s p 字段名 字节数属性描述 r e s u l t 4 u n s i g n e d结果 i n t e g e r o ：正确 l ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信息长 7 ：业务代码错 8 ：流量控制错 9 ：其他错误 转发同步业务( c g i p _ t r a n s _ s y n c b u s i ) 操作 同步转发业务操作是指所有外部节点向通用网关发起请求的转发，此种请求需要等待 业务系统的处理结果，通用网关才可以返回。 令c g i p _ t r a n s _ s y n c _ b u s i r e q 消息定义 表3 7c g i p j r a n s _ s y n c _ b u s i _ r e q 字段名字节数属性描述 s o u r c e _ n o d e _ i d 1 0 o c t e ts t r i n g源节点i d d e s t _ n o d e i d 1 0o c t e ts t r i n g目标节点i d i n t e r f a c e i d 1 0o c t e ts t r i n g接口i d s e n d e r _ i d 1 0o c t e ts t r i n g发送者i d r e c eiv e r _ i d1 0o c t e ts t r i n g接收者i d w s d l _ n a m e 2 0o c t e ts t r i n g该接口的w s d l 描述文件名 b u si _ m s gb o d y lu n s ig n e d 业务包体是否压缩 c o m p r e s s i n t e g e rl 为压缩 0 为未压缩 b u s i j s gb o d y _ l u n si g n e d 业务包体是否使用b a s e 6 4 编码 b a s e 6 4i n t e g e rl 为使用b a s e 6 4 编码 o 为未使用b a s e 6 4 编码 第1 2 页武汉科技大学硕士学位论文 b u s ii d s gn a m e2 0o c t e ts t r i n g业务消息名称，该消息名是适配器根据适 配的协议抽象出的w s d l 描述的消息名， 具体名称适配器会填在该字段 r e s e r v e8o c t e ts t r i n g 保留 b u s i s g _ b o d y 4 u n s i g n e d业务消息长度 l e n g t h i n t e g e r b u si m s g _ b o d yb u si _ m s gb o d yb i nd a t a适配器需要转发的实际业务数据包，改字 l e n g t h b l o - 段的解码需要利用w s d l _ n a m e 指定的描述 c k 文件进行解包 令c g i p _ t r a n s _ s y n c _ b u s i _ r e s p 消息定义 表3 8c g i pt r a n ss y n cb u s ir e s p 字段名字节属性描述 数 r e s u l t4u n s ig n e d 结果 i n t e g e r o ：正确 1 ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信息长 7 ：业务代码错 8 ：流量控制错 w s d ln a m e 2 0 o c t e t该接口的w s d l 描述文件名 s t r i n g b u si m s gb o d y _ c o m p 1 u n s i g n e d 业务包体是否压缩 r e s s i n t e g e r 1 为压缩 0 为未压缩 b u s i _ m s g _ b o d x 里a s e l u n s i g n e d 业务包体是否使用b a s e 6 4 编码 6 4 i n t e g e r1 为使用b a s e 6 4 编码 0 为未使用b a s e 6 4 编码 b u si s g _ n a m e2 0o c t e ts t r i n g 业务消息名称，该消息名是适配器根据适 配的协议抽象出的w s d l 描述的消息名， 具体名称适配器会填在该字段 r e s e r v e 8 o c t e ts t r i n g保留 b u si _ m s g _ b o d yl e n 一4 u n s ig n e d业务消息长度，如果该字段为0 ，表示没 武汉科技大学硕士学位论文第1 3 页 g t hi n t e g e r有业务消息包 b u si _ m s g _ b o d y b u s ib i nd a t a 适配器需要转发的实际业务数据包，改字 - m s g b l o c k 段的解码需要利用w s d ln a m e 指定的描述 b o d 文件进行解包 yl e n g t h 监控类接口 c g i p _ m o n i t o r 操作是客户端登录上节点进行监控请求的操作。 夺c g i p _ m o n i t o r _ r e q 消息定义 表3 9c g i p _ m o n i t o r _ r e q 字段名字节数属性描述 f i l t e r _ k e y 5 0o c t e ts t r i n g 过滤关键字，客户端设置需要监控的关 键字 夺c g i pm o n i t o r _ r e s p 消息定义 表3 i oc g i pm o n i t o rr e s p 字段名字节数属性描述 r e s u l t4 u n s i g n e d结果 i n t e g e r0 ：监控关键字设置成功正确 1 ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信息长 7 ：业务代码错 8 ：流量控制错 管理类接口 参数变更( c g i p _ p a r a _ c h g ) 操作 c g i p _ p a r a _ c h g 操作的目的是管理客户端可以向节点发出参数变更操作。 c gip _ p a r a _ c h g _ r e q 消息定义 表3 1 1c g i p _ p a r ac h g _ r e q 字段名 字节数属性描述 p a r a _ n a m e 2 0o c t e ts t r i n g参数名 p a r a _ v a l u e 2 0 0o c t e ts t r i n g参数值 c g i p _ p a r a _ c h g _ r e s p 消息定义 表3 1 2c g i pp a r ac h gr e s p 第1 4 页武汉科技大学 硕士学位论文 字段名字节数 属性描述 r e s u l t 4 u n s i g n e d 结果 i n t e g e r0 ：参数变更成功 l ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信息长 7 ：业务代码错 8 ：流量控制错 查询参数( c g i p _ p a p , a _ q u e r y ) 操作 c g i p _ p a r a _ o u e r y 操作的目的是管理客户端可以向节点发出参数查询操作。 夺c g i p _ p a p , a _ q u e r y r e q 消息定义 表3 1 3c g i p _ p a r a _ q u e r yr e q 字段名字节数 属性描述 q u e r y _ t y p e 1 u n s i g n e d查询类型 i n t e g e r1 查询所有参数 2 查询指定参数 p a r a _ n a m e 2 0 o c t e ts t r i n g参数名 令c g i p _ p a r a _ o u e r y r e s p 消息定义 表3 1 4c g i p _ p a r aq u e r y _ r e s p 字段名 字节数属性描述 r e s u l t4u n s i g n e d结果 i n t e g e r0 ：参数变更成功 1 ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信息欧 7 ：业务代码错 8 ：流量控制错 p a r ac o u n t4 u n s i g n e d 参数个数 i n t e g e r p a r a _ n a m e 2 0 o c t e ts t r i n g参数名 武汉科技大学硕士学位论文第1 5 页 l p a r a _ v a l u e l 2 0 0 i o c t e ts t r i n gl 参数值 l 运行状态查询( c g i p r t s t a t u s q u e r y ) 操作 c g i p r t s t a t u s _ q u e r y 操作的目的是管理客户端可以向节点发出运行状态查询操作。 令c g i pr ts t a t u s _ q u e r y _ r e q 消息定义 没有包体 令c g i p r ts t a t u s _ q u e r y r e s p 消息定义 表3 1 5c g i pr ts t a t u s _ q u e r y _ r e s p 字段名字节数 属性描述 r e s u l t4 u n s i g n e d结果 i n t e g e ro ：成功 l ：消息结构错 2 ：命令字错 3 ：消息序号重复 4 ：消息长度错 5 ：资费代码错 6 ：超过最大信