接口规范协议测试工具操作手册.doc

广东省道路运政管理信息系统卫星定位数据管理子系统接口规范协议测试工具操作手册目录1前言31.1 编写目的31.2 术语定义32 测试工具操作指南32.1 系统配置32.2 程序主界面31 前言1.1 编写目的本文档针对运营商平台开发人员及地市级平台系统实施人员编写，目的在于介绍本测试工具在进行平台接入的对调过程中应如何使用，帮助相关人员快速有效的运用本测试工具发现问题并解决问题，规范平台接入流程。1.2 术语定义（1） 数据接口按照接口规范中定义的通信协议规范与接入的企业平台（运营商平台）进行数据交换的服务端程序，如验证企业平台（运营商平台）的登录的合法性，以及接收企业平台（运营商平台）递交的车辆实时定位等数据。数据接口程序将接收的数据分发到业务逻辑层的各种服务器程序，以便进一步完成各种类型的数据处理。（2） 车辆基本资料接口规范中定义的递交通信协议流程，当企业平台（运营商平台）收到市级平台的“车辆基本资料上传申请”后，需及时向申请方递交“车辆基本资料”。（3） 接入客户端接入本程序的企业平台（运营商平台）数据量。2 测试工具操作指南2.1 系统配置打开程序所在文件夹下的“Config.xml”配置文件，可看到配置文件内容如图1所示：图1（1） connection节点的accessPort参数用于配置运营商平台接入的监听端口。（2） record节点的saveGPSData参数用于配置是否记录所有车辆的当前定位数据，生成记录文件“record.dat”保存在程序所在文件夹下；saveLoop参数用于配置记录时间间隔，单位为秒。（3） access节点的keepAliveTime参数用于配置无效连接（即无任何数据传输动作的连接）维持时间，单位为秒。（4） center节点的centerID参数用于配置中心ID号，即本测试程序发送的数据包中的GPS Center ID字段都使用该中心ID号。（5） user节点用于配置营运商登录的用户编号和密码，其中name参数用于配置用户编号；password参数用于配置密码；centerID参数用于配置绑定中心ID；ip参数用于配置绑定IP地址。2.2 程序主界面程序主界面包括菜单栏、状态信息框、消息框以及状态栏，如图2所示：菜单栏状态信息框消息框状态栏图2（4） 菜单栏中的“系统”菜单项，共有5个子菜单下，如图3所示：图3程序默认消息框中的消息显示处于关闭状态，勾选“显示消息”菜单项，可以开启消息框中的消息显示功能；勾选“显示HEX数据”菜单项，程序发送及接受的16进制原始数据可在消息框中显示出来，如图4所示，图中红色区域为程序发送及接受的16进制原始数据：图4单击“记录车辆”菜单项可打开接入车辆详细信息窗口，在该窗口中可查看运营商上传的车辆的详细信息，选择右边命令列表中的“搜索车辆”，并在“关键字”中输入车牌号码，可搜索指定车辆的详细信息，如图5所示：图5单击“接入客户端”菜单项可打开客户端连接窗口，该窗口由两部分构成：客户端连接列表及历史消息记录。单击位于窗口左侧的指定客户端连接，窗口右侧的消息框会显示与该连接有关的最近1000条历史消息记录。由于“客户端连接”及“历史消息记录”这两类信息并不是实时刷新的，用户需手动点击“刷新客户端连接”及“刷新历史信息”按钮以获得这两类信息的最新记录情况，如图6所示：图6（5） 状态信息框中的“记录车辆”，统计显示接入的车辆数目；“接入客户端”统计显示与本测试程序建立TCP连接数目。（6） 消息框用于显示本程序与接入运营商之间的数据通信过程中的提示信息，包括建立TCP连接、断开TC