数据交换平台规范介绍.pdf

第1章数据交换平台规范 §1.1 基本技术规范 � 数据交换平台服务器采用满足J2EE 规范的应用服务器实现 � 数据交换平台包含的数据交换服务使用纯Java接口作为统一的抽象接口描述 � 数据交换平台包含的数据交换服务可以发布为多种形式，包括：EJB、Servlet、WebService 等 � 数据交换平台的数据，使用XML 格式进行表示 � 数据交换平台要求提供安全认证和授权访问机制，确保数据交换的安全 §1.2 数据交换接口规范 数据交换平台中的数据交换接口，统一通过纯Java接口来进行表述，对这类Java接口，要 求满足如下规范： � 接口方法的参数和返回值要求实现序列化接口 � 接口方法的参数和返回值，如果是数据集合，统一通过Rowset结构来实现，每个数据 集合参数，需要标明RowSet 结构的名字 下面是一个数据交换接口的例子： /** * * 接口: 客户基本信息查询 * 说明: 本接口提供对营销用点客户的基本信息查询功能 */ publicinterfacebo_cust_info{ /** * 查询客户基本信息 *@paramcustId: 客户号 *@return: 包含客户信息的结果集,如果没有该客户数据,返回空的结果集 * 返回结果集名:epm/ar_cust_info */ publicDSRowSet queryByCustId (String custId); } §1.3 RowSet 数据集合结构说明 数据交换过程中，由于数据格式的混乱，常常带来很多附加的工作，这些工作往往导致 系统出现错误，或降低了系统的效率，所以，应当采用尽量简单、统一的数据格式。数据集 是数据交换过程中经常会遇到的数据结构，例如，查询结果往往包含多行数据。结果集可以 有很多种实现方式，数据交换平台中，统一使用称为RowSet 的数据集结构。 通过如下的例子来说明RowSet 的结构： rowsetlabel=客户基本信息name=epm/AR_CUST_INFO row CUST_ID0000669375/CUST_ID CUST_SC_ICUST_SC_ID CUST_SNAME/CUST_SNAME CUST_NAME某客户名/CUST_NAME CUST_ADDR客户地址/CUST_ADDR CONTACT/CONTACT CONT_TEL/CONT_TEL CUST_TYPE22/CUST_TYPE AREA_SECT_ID0100009/AREA_SECT_ID SUPPLY_DATE/SUPPLY_DATE CUST_STATUS9/CUST_STATUS STATUS_CHG_DATE/STATUS_CHG_DATE ELEC_KIND1/ELEC_KIND CONTACT_CAPA4/CONTACT_CAPA INSTALL_CAPA0/INSTALL_CAPA BALANCE_ID0000669375/BALANCE_ID AREA_NO01/AREA_NO POWER_CUT_TAG0/POWER_CUT_TAG /row /rowset 如上是RowSet 的结构XML 表示，可见，这个结构很容易理解，每个rowset节点描述一个 数据集，每个row节点描述一个数据行，row节点下，每个子节点，描述一个数据列的值。 这里，需要注意rowset 节点的名字属性，每个名字唯一定义一个数据集的元数据结构，这 个结构称为RowSetDef，数据交换平台统一提供对这个名字的结构解释，下面是如上数据集 的结构描述： rowsetdefname=epm/train/AR_CUST_INFOlabel=客户基本信息 column index=0name=CUST_IDlabel=客户编号datatype=CHAR/column column index=1name=CUST_SC_IDlabel=客户快捷码datatype=VARCHAR/column column inde