webservice接口实现过程

说明：该文档以电子路演系统与ECM的WebService集成为例

创建服务端

一、搭建测试环境

1 新建web工程OARSInterface，引入jar包

将“E:\zhaodongmei\ECM\OARSandECM\IntegrationInterfaceCode\测试代码\WebService\WebJarFiles”目录下的jar包引入。

引入的具体jar包如下：activation.jar；apache_soap-2_3_1.jar；axis.jar；axis-ant.jar；CEOperterMonitor.jar；CEService_IIOP.jar；commons-collections-3.2.jar；commons-discovery-0.2.jar；commons-fileupload-1.2.1.jar；commons-io-1.3.2.jar；commons-logging-1.0.4.jar；dom4j-1.6.1.jar；dom4j-1.6.1.jar；jaxen-1.1.1.jar；jaxrpc.jar；log4j-1.2.8.jar；mail.jar；saaj.jar；wsdl4j-1.5.1.jar。其中可选包（发布服务及生成客户端程序是要用到的）：activation.jar；mail.jar。

2 配置web.xml文件

参照E:\zhaodongmei\ECM\OARSandECM\IntegrationInterfaceCode\测试代码\WebService\客户端测试项目\OARSTest\WebRoot\WEB-INF\ web.xml进行配置，不需要进行修改

二、接口开发

在开发之前，我们先介绍与接口实现相关的两个jar包：CEOperterMonitor.jar和CEService_IIOP.jar。

CEOperterMonitor.jar：实现的是对接口操作的监控。当电子路演系统调用我们的接口进行上传、下载、修改和删除操作时，可以在监控系统的数据库中查看到相关的操作记录。CEService_IIOP.jar：主要的功能是提供对文件夹或文件进行操作的各个接口供本文档中接口的开发时调用。当该jar包中的函数不能满足开发的需要时，可以对该jar包进行修改，即重写某些方法。

1 编写服务端程序src/services.OARSService/ OARSService.java

在该Java类中实现了10个方法：OARSService()；getProperties(String filename)；uploadRSFile( DataHandler file,Map parms)；deleteRSFile(String documentId)；downloadRSFile(String documentId)；updateFileProperyAndPermission(DataHandler xmlFile)；getParams(List affixfilebeanList)；writeXML(DataHandler xmlFile)；createFolder(String folderPath)；main(String[] args)

下面分别介绍这些函数的功能：

①OARSService()：构造函数，主要实现的功能是从OARS.config中取得参数值。并在

log文件中输出这些参数值。

②getProperties(String filename)：读取配置文件，定义一个打开文件的变量，并

通过这个变量加载文件内容。

③uploadRSFile( DataHandler file,Map parms)：上传文件，

通过迭代器遍历参数的key值，然后实例化通过ＸＭＬ解析类（XMLParser）并调用该类中的初始化方法initDocumentParams()实现参数的初始化，并将文件参数封装到ｍａｐ中，最后调用CEService的uploadFile(path, fileName, file, documentParams, "OARSDocument")方法，将结果赋给文件ID并返回。

④deleteRSFile(String documentId)：删除文件。由于当文件被删除时，伴随它的权

限也会被删除，所以要先调用权限管理类中的removePermInfoForDeleteFileLogical(documentId)方法，将其权限删除，如果权限删除成功，再调用CEService 的deleteDocument(documentId)方法，将文件删除。

⑤downloadRSFile(String documentId)：下载文件。调用CEService的

getDocByID(documentId)方法，返回值为DataHandler类型的文件流。

⑥updateFileProperyAndPermission(DataHandler xmlFile)：修改文件属性及权

限信息。首先调用XML解析类的getInfoBean()方法，获取文件属性。然后调用XML解析类中的getDocumentParams(bean)方法，将文件属性存储到HashMap中，然后通过循环，调用CEService的changeDocumentProperties(documentId, documentParams)方法修改文件属性，最后调用权限管理中的savePermInfoBeach(paramList, objsName)方法实现对这些属性的保存。

⑦getParams(List affixfilebeanList)：获取ＸＭＬ中所需要的

所有参数。

⑧writeXML(DataHandler xmlFile)：向本地写入XML，返回XML路径。

⑨createFolder(String folderPath)：采用两个ｆｏｒ循环，实现路径的拆分和拼接，

最后通过调用ＣＥＳｅｒｖｉｃｅ的isExistFolder(dbPath)和createFolder(pathHome, pathName[j])方法实现循环创建文件夹。

⑩相关的类文件：

?PermissionDao.java

该类中主要实现底层对权限的操作。电子路演中有关权限的操作包括：权限的修改（insertPermInfoBeach）和权限的删除（deletePermInfo）。

权限修改的实现：先批量删除已存在的权限信息，再批量增加权限信息。采用JDBC实现对数据库中数据的增加和删除，需要编写两个ＳＱＬ语句（删除和插入），实现权限的修改。

权限删除的实现：文件删除时，删除所有权限信息（删除数据）。

?XMLParser.java（XML文件解析类）

见《接口代码分析.doc》

?PermissionManager.java(权限管理类)

该类实现的是对权限的管理：文件上传接口插入权限信息数据库操作（savePermInfoBeach）和逻辑删除所有权限信息（removePermInfoForDeleteFileLogical）。这两个方法，分别由修改权限接口和删除文件接口调用。

?相关ｂｅａn：InfoBean：对应XML报文中的Info节点下参数信息；AffixFileBean：对

应XML报文中的AffixFile节点下参数信息；PermInfoBean：对应XML报文中的PermInfo节点下参数信息。一个bean对应XML报文的一层节点。

具体的接口实现过程见《接口代码分析.doc》

2 创建deploy.bat文件

在Myeclipse中的OARSInterface\WebRoot\WEB-INF目录下创建deploy.bat文件。

内容如下：

set Axis_Lib=.\lib

set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%

set Axis_Servlet=http://10.60.108.138:9080/OARSInterface/servlet/AxisServlet

%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

pause

其中标蓝的部分应该与后来发布到was上的应用名称（上下文根）一致。

3 创建deploy.wsdd文件

在Myeclipse中的OARSInterface\WebRoot\WEB-INF目录下创建deploy.wsdd文件。

内容如下：

xmlns:java="https://www.360docs.net/doc/6610848772.html,/axis/wsdd/providers/java">

value="uploadRSFile,deleteRSFile,downloadRSFile,updateFileProperyAndPermission"/>

其中需要修改的地方：

OARSService：接口服务名称

services.OARSService.OARSService：接口实现类名

uploadRSFile,deleteRSFile,downloadRSFile,updateFileProperyAndPermission：接口中实现的方法，一定要和实现类中的名字一致。实现类中的方法名字一定要和集成方案中的一致。

4 创建OARS.Config文件

该文件放在服务端项目中的src目录下。

#uri=corbaloc::bejnrg001:9811,:bejnrg002:9811/cell/clusters/ECM_CLUSTER/FileNet/Engine

uri=iiop://10.60.108.138:2809/FileNet/Engine

#uri=http://10.60.108.138:9080/wsi/FNCEWS40DIME

#username=ecmadmin

username=administrator

#password=Ecm&Kk2

password=gds

#domain=ECMDomain

domain=admin

objectstore=OARSOBJ

xmlPath=D:\\xmlFile\\

#xmlPath=/ECMData/xmlFile

创建客户端

一、搭建环境

1. 创建表空间和用户

访问http://10.60.108.136:5505/em/以SYSDB身份登陆，账户和密码：sys/gds

<1>创建默认表空间oars_sp，临时表空间：temp

<2>创建用户oarsuser/gds，（角色增加RESOURCE）

<3>创建权限信息表（PERM_REF_INFO_OARS）及相关数据字典表（perm_method：授权方式和perm_type：权限操作类型）。

2. 测试环境所需目录创建和所需文件上传

<1> OARSOBJ文件存储目录创建

创建ObjectStore之前要创建oars_storage_files目录，登陆到138远程控制台：运行mstsc,用户名：administrator，密码：gds,在D:\FileNet 目录下，创建oars_storage_files目录。

<2>配置文件OARS.config上传

将文件OARS.config上传到FileNetManager的D:\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\GDS-20 Node01Cell\OARSInterface_war.ear\OARSInterface.war\WEB-INF\classe s目录下，可以先将文件拷到共享文件夹，然后在FileNetManager上将文件从共享文件夹拷贝到上面所提的路径下。

3. 配置WebSphere上的数据源

<1> 创建JNDI数据源

登陆地址为https://10.60.108.138:9043/ibm/console/logon.jsp 的WebSphere控制台，用户名：administrator，密码：gds。进入【资源】－【JDBC】－【数据源】菜单下。如图2-1-2-3-1-1

图2-1-2-3-1-1

点击【新建】按钮，进入新建数据库界面。填写数据源名：OARS_DS和JNDI

名称：OARS_DS

点击【下一步】进入选择JDBC驱动配置界面，如图选择Oracel JDBC Driver.如图2-1-2-3-1-2所示

图2-1-2-3-1-2

点击【下一步】进入JDBC的url配置界面，填写URL名称：

jdbc:oracle:thin:@10.60.108.136:1521:ECMSysMonitor，选择【数据存储器helper类名】为【Oracle10g数据存储器helper】，如图2-1-2-3-1-3所示：

图2-1-2-3-1-3

点击【下一步】进入创建数据源总结页面，点击【完成】，并保存配置。在数据源列表中，点击刚建好的数据源OARS_DS，进入到数据源详细信息页面。如图2-1-2-3-1-4所示

图2-1-2-3-1-4

点击【相关项】中的【JAAS-J2C认证数据】，进入到认证数据界面。如

图2-1-2-3-1-5所示

图2-1-2-3-1-5

点击【新建】，进入到用户名和密码的新建页面，如图所示，填写相关信

息，并点击【应用】完成操作。如图2-1-2-3-1-6所示

将新建的认证数据加入到数据源中，如图2-1-2-3-1-7所示

图2-1-2-3-1-7

<2>创建JNDI XA配置数据源

进入【资源】－【JDBC】－【数据源】菜单下。如图2-1-2-3-2-1

图2-1-2-3-2-1

点击【新建】按钮，进入新建数据库界面。填写数据源名：OARS_XADS和JNDI 名称：OARS_XADS,【组件管理的认证别名和XA恢复认证别名】选择oarsuser。

如图2-1-2-3-2-2

图2-1-2-3-2-2

点击【下一步】进入选择JDBC驱动配置界面，如图选择Oracel JDBC Driver(XA).如图2-1-2-3-2-3所示

图2-1-2-3-2-3

点击【下一步】进入JDBC的url配置界面，填写URL名称：

jdbc:oracle:thin:@10.60.108.136:1521:ECMSysMonitor，选择【数据存储器helper类名】为【Oracle10g数据存储器helper】，如图2-1-2-3-2-4所示：

图2-1-2-3-2-4

点击【下一步】进入创建数据源总结页面，点击【完成】，并保存配置。

4. 创建ObjectStore：OARSOBJ

运行mstsc，进入FileNet控制台登陆界面，用户名：administrator，密码：gds。然后登陆FileNet Enterprise Manager SnapIn 4.0，进入到管理界面。

<1>右键“Object Stores”,选择“Create a new Object Store”.

注：Symbolic Name必须以字母字符开头。

<3>输入JNDI DataSource 以及JNDI XA DataSource 名称.

<4>选择Object Store的存储类型,选择“File Storage Area”。单击“下一步”继续。

Database Storage Area：数据库存储，文档内容以blob字段的形式存储到数据库中。

File Storage Area：文件存储，文档内容以文件的方式保存在磁盘上。

Fixed Storage Area：混合存储。

<5>指定文件存储路径(目标需要预先创建)，如图，

<6>指定Object Store管理员.指定Administrator为系统管理员.

<7>指定使用此Object Store的用户或组.(注:这里指定的用户和组只有访问的权限,而没有管理的权限).单击“下一步”.

<8>单击“完成”.

<9>如下图,OARSOBJ已经创建成功.

5.创建对象库DocumentClass属性

1.登陆FileNet Enterprise Manager SnapIn 4.0，进入到管理界面。

进入提示页面

3.点击【下一步】，进入DocumentClass创建页面，填写Name：

OARSDocument;

Symbolic Name：OARSDocument；Description：OARSDocument。

4.点击【下一步】，进入属性设置页面。

5.点击【new】，弹出属性创建提示页面。

6.点击【下一步】，进入属性创建页面，按照文档《OARS文件属性定

义.doc》内容填写属性信息。该文档内容如下：