普天海油 信息系统间统一通信工具BIT接口说明.docxVIP

信息系统间统一通信工具（BIT）接口说明文档编写：谭贺春提交日期： 2010-07-19审批人：北邮项目组2010-07-20文档修改记录撰写人修改时间原版本号修改内容介绍谭贺春2010-07-20V1.0编写文档目录1、综述42、术语43、软件的组成结构43.1配置信息加载43.1.1 配置文件43.1.2 配置信息加载接口53.2协议对象63.2.1 Request对象73.2.2 Response对象83.2.3 Notification对象93.2.4 Ack对象103.2.5 OneWay对象103.3编解码113.4安全机制123.5客户端操作123.6服务器端操作133.7日常功能144、数据处理机制144.1专门用来处理Request请求的RequestWork154.2专门用来处理Notification的NotificationWork174.3专门用来处理OneWay的OneWayWork175、使用说明185.1 软件包的组成185.2 如何准备数据库映射文件185.3 使用方法18综述 BIT软件是针对普天海油项目中诸多子系统间的数据通信，开发的一个Java的接口软件。普天海油项目存在着BOSS、GIS等这样的相对独立的子系统，系统间数据需要根据查询的方式、上报确认方式、上报不确认方式等来及时的通信。该软件提供公用的接口，完成上述需求。该软件的通信传输协议使用xml格式组织，数据获取采用hibernate的查询接口，故在软件的使用过程中服务器方需要产生支持hibernate的标准java Bean和相关配置文件。此外，BIT软件支持Http post和socket网络协议方式。术语序号术语描述1BIT网管通信接口(BUPT Interface toolkit)2Hibernate一个开放源代码的对象关系映射框架，它对JDBC进行了非常轻量级的对象封装，使得Java程序员可以随心所欲的使用对象编程思维来操纵数据库。3HQLHibernate配备的一种面向对象的查询语言4BOSS电动车基本信息的管理系统5GIS地理信息系统6javabeanJavaBean 是一种JAVA语言写成的可重用组件。为写成JavaBean，类必须是具体的和公共的，并且具有无参数的构造器。AVA语言写成的可重用组件。为写成JavaBean，类必须是具体的和公共的，并且具有无参数的构造器。软件的组成结构该软件根据协议文档要求，抽象出了Request、Response、Notification、Ack、OneWay等对象。软件可以解析符合协议标准的XML，将其内容封装到以上抽象出来的对象当中，并且也可以逆向的将对象内容解析后组织成XML格式。软件提供信息的接收和发送的功能。发送功能：组织Request对象，转换Request对象为协议规定格式的xml字符串，并发送给服务器端，接受符合Response协议规定的xml字符串；组织接收功能：接收符合Request消息协议规定的xml字符串，将其转化成Request对象，并对Request对象进行相关处理，处理后，组织Response对象，转换Response对象为符合Response消息协议规定的xml字符串，最后将这个字符串发送给客户端；接收符合Notification消息协议规定的xml字符串，将其转化成Notification对象，并对Notification对象进行相关处理，处理完成后，组织Ack对象，转换Ack对象为符合Ack消息协议规定的xml字符串，最后将这个字符串发送给服务器端；接收符合OneWay消息协议规定的xml字符串，将其转化成OneWay对象，并对OneWay对象进行相关处理.由此软件主要结构为：配置信息加载、协议对象、编解码、安全机制、发送功能、接收功能、日常功能等。3.1配置信息加载3.1.1 配置文件在使用该软件前，需对软件提供的配置文件根据实际使用情况进行修改。这主要是出于对软件的可维护性的考虑。config.xml配置文件结构：properties!-- 服务器端软件访问用户名密码 token论证--usernameqiyubin/usernamepassword123/passwordpeople username=qiyubin password=123/peoplepeople username=admin password=admin/people!-- Token生存周期秒为单位 --liveTime300/liveTime/properties作用：用来配置服务器端的服务器访问密码。参数解释：username服务器用户名。password服务器密码。Livetime?用户登陆后不活动的存活周期，单位是秒。使用场景：在服务器部署阶段使用