信息系统间统一通信工具（信息系统间统一通信工具（BIT） 接口说明接口说明文档编写文档编写： 谭贺春 提交日期提交日期： 2010-07-19 审审 批批 人：人： 北邮项目组北邮项目组2010-07-202010-07-20文档修改记录撰写人修改时间原版本号修改内容介绍谭贺春2010-07-20V1.0编写文档目目 录录1、综述.4 2、术语.4 3、软件的组成结构.4 3.1 配置信息加载.4 3.1.1 配置文件.4 3.1.2 配置信息加载接口.5 3.2 协议对象.6 3.2.1 Request 对象.7 3.2.2 Response 对象.8 3.2.3 Notification 对象.9 3.2.4 Ack 对象.10 3.2.5 OneWay 对象 .10 3.3 编解码.11 3.4 安全机制.12 3.5 客户端操作.12 3.6 服务器端操作.13 3.7 日常功能.14 4、数据处理机制.14 4.1 专门用来处理 Request 请求的 RequestWork.15 4.2 专门用来处理 Notification 的 NotificationWork.17 4.3 专门用来处理 OneWay 的 OneWayWork.17 5、使用说明.18 5.1 软件包的组成.18 5.2 如何准备数据库映射文件.18 5.3 使用方法.181、综述综述BIT 软件是针对普天海油项目中诸多子系统间的数据通信，开发的一个 Java 的接口软 件。普天海油项目存在着 BOSS、GIS 等这样的相对独立的子系统，系统间数据需要根据查 询的方式、上报确认方式、上报不确认方式等来及时的通信。该软件提供公用的接口，完 成上述需求。该软件的通信传输协议使用 xml 格式组织，数据获取采用 hibernate 的查询 接口，故在软件的使用过程中服务器方需要产生支持 hibernate 的标准 java Bean 和相关 配置文件。此外，BIT 软件支持 Http post 和 socket 网络协议方式。2、术语术语序号术语描述1BIT网管通信接口网管通信接口网管通信接口(BUPT(BUPT(BUPT InterfaceInterfaceInterface toolkit)toolkit)toolkit)2Hibernate一个开放源代码的对象关系映射框架，它对 JDBC 进 行了非常轻量级的对象封装，使得 Java 程序员可以 随心所欲的使用对象编程思维来操纵数据库。3HQLHibernate 配备的一种面向对象的查询语言4BOSS电动车基本信息的管理系统5GIS地理信息系统6javabeanJavaBean 是一种 JAVA 语言写成的可重用组件。为写 成 JavaBean，类必须是具体的和公共的，并且具有无 参数的构造器。AVA 语言写成的可重用组件。为写成 JavaBean，类必须是具体的和公共的，并且具有无参 数的构造器。3、软件的组成结构软件的组成结构该软件根据协议文档要求，抽象出了 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.13.1 配置信息加载配置信息加载3.1.1 配置文件配置文件在使用该软件前，需对软件提供的配置文件根据实际使用情况进行修改。这主要是出 于对软件的可维护性的考虑。 1、 config.xml 配置文件 结构：结构：qiyubin123300作用：作用： 用来配置服务器端的服务器访问密码。 参数解释：参数解释： username 服务器用户名。 password 服务器密码。 Livetime 用户登陆后不活动的存活周期，单位是秒。 使用场景：使用场景： 在服务器部署阶段使用，配置好相应的信息。 2、 destination.properties配置文件 结构：结构：socket.北京普天发电