【精编版】电子数据交换平台规范.doc

电子数据交换平台规范
基本技术规范
数据交换平台服务器采用满足J2EE规范的应用服务器实现
数据交换平台包含的数据交换服务使用纯Java接口作为统一的抽象接口描述
数据交换平台包含的数据交换服务可以发布为多种形式,包括:EJB、Servlet、WebService等
数据交换平台的数据,使用XML格式进行表示
数据交换平台要求提供安全认证和授权访问机制,确保数据交换的安全
数据交换接口规范
数据交换平台中的数据交换接口,统一通过纯Java接口来进行表述,对这类Java接口,要求满足如下规范:
接口方法的参数和返回值要求实现序列化接口
接口方法的参数和返回值,如果是数据集合,统一通过Rowset结构来实现,每个数据集合参数,需要标明RowSet结构的名字
下面是一个数据交换接口的例子:
/**
*
* 接口: 客户基本信息查询
* 说明: 本接口提供对营销用点客户的基本信息查询功能
*/
public interface bo_cust_info {
/**
* 查询客户基本信息
* ***@param custId : 客户号
* ***@return : 包含客户信息的结果集,如果没有该客户数据,返回空的结果集
* 返回结果集名: epm/ar_cust_info
*/
public DSRowSet queryByCustId (String custId);

}
RowSet数据集合结构说明
数据交换过程中,由于数据格式的混乱,常常带来很多附加的工作,这些工作往往导致系统出现错误,或降低了系统的效率,所以,应当采用尽量简单、统一的数据格式。数据集是数据交换过程中经常会遇到的数据结构,例如,查询结果往往包含多行数据。结果集可以有很多种实现方式,数据交换平台中,统一使用称为
RowSet的数据集结构。
通过如下的例子来说明RowSet的结构:
<rowset label="客户基本信息" name="epm/AR_CUST_INFO">
<row >
<CUST_ID>0000669375</CUST_ID>
<CUST_SC_ID>11000082</CUST_SC_ID>
<CUST_SNAME></CUST_SNAME>
<CUST_NAME>某客户名</CUST_NAME>
<CUST_ADDR>客户地址</CUST_ADDR>
<CONTACT></CONTACT>
<CONT_TEL></CONT_TEL>
<CUST_TYPE>22</CUST_TYPE>
<AREA_SECT_ID>0100009</AREA_SECT_ID>
<SUPPLY_DATE></SUPPLY_DATE>
<CUST_STATUS>9</CUST_STATUS>
<STATUS_CHG_DATE></STATUS_CHG_DATE>
<ELEC_KIND>1</ELEC_KIND>
<CONTACT_CAPA>4</CONTACT_CAPA>
<INSTALL_CAPA>0</INSTALL_CAPA>
<BALANCE_ID>0000669375</BALANCE_ID>
<AREA_NO>01</ARE