<4D F736F F D E B7FECEF1BCAFB3C9BACDB6CCC1F7B3CCB9A6C4DCCAB9D3C3CAD6B2E12E646F63>

Size: px

Start display at page:

Download "<4D F736F F D E B7FECEF1BCAFB3C9BACDB6CCC1F7B3CCB9A6C4DCCAB9D3C3CAD6B2E12E646F63>"

甘却滕
5 years ago
Views:

1 PRIMETON TECHNOLOGIES, LTD. 上海普元信息技术有限责任公司 BPS 6.0 Express Web 服务集成和短流程使用手册第 1 页共 17 页

2 目录 1 Web 服务集成 Web 服务简述在 BPS 中使用 Web 服务功能使用 Web 服务活动的步骤生成 Java Stub 调用 Web 服务 BPS 支持的 Web 服务的 WSDL 技术规格 WebService 环境配置说明嵌入式安装锐捷版本短流程短流程简述如何在 BPS 中使用短流程短流程配置管理第 2 页共 17 页

3 1 Web 服务集成 1.1 Web 服务简述 Web 服务是一种面向服务的架构的技术, 通过标准的 Web 协议提供服务, 目的是保证不同平台的应用服务可以互操作根据 W3C 的定义,Web 服务 (Web service) 应当是一个软件系统, 用以支持网络间不同机器的互动操作网络服务通常是许多应用程序接口 (API) 所组成的, 它们通过网络, 例如国际互联网 (Internet) 的远程服务器端, 执行客户所提交服务的请求近年来,Web 服务在企业间的集成和企业内的应用集成中起着越来越重要的作用 1.2 在 BPS 中使用 Web 服务功能在 BPS6.0 SP2 中增加了对 Web 服务的直接支持用户可以通过图形化的方式实现服务编制, 轻松支持跨系统的 WEB 服务调用, 很方便地实现应用间的集成 BPS 对 Web 服务提供两种支持第一, 支持 Web 服务活动 ; 第二通过 WSDL 生成 Web 服务调用的客户端 JAVA 代码使用 Web 服务活动的步骤导入 WSDL 文件在项目资源管理器视图中右键点击包节点或项目节点, 选择导入 WSDL 菜单, 打开导入 WSDL 文件向导 : 第 3 页共 17 页

4 选择要导入的 WSDL 文件存放的包路径, 输入 WSDL 文件地址, 地址可以是本地文件路径, 也可以是 http 远程 URL, 也可以点击浏览按钮选择本地 WSDL 文件 (WSDL 地址为本地文件路径的情况 ) 第 4 页共 17 页

5 (WSDL 地址为 http URL 的情况 ) 点击完成, 将 WSDL 文件资源 ( 包含该文件已经可能引用的其他 WSDL 文件和 XSD 文件 ) 导入到指定的包下同时, 目标 WSDL 引用的 XSD 数据定义以及其他的 WSDL 也会被导入到相同的包下展开 WSDL 和 XSD 文件节点, 可以看到文件中定义的类型服务 port operation 等元素的结构, 拖拽 operation 节点到流程编辑器中可以自动生成调用该 operation 的 webservcie 活动图元第 5 页共 17 页

6 在流程中使用 Web 服务图元创建一个新的业务流程, 打开新建的业务流程有两种方法创建 Web 服务活动 : 方法一 : 拖动 WSDL 中的操作到流程编辑器产生 Web 服务图元如下图所示 : 第 6 页共 17 页

7 方法二 : 将选用板上的 Web 服务图元拖入业务流程编辑器中如下图所示 : 第 7 页共 17 页

1.2.1.3 配置 web 服务活动对于业务流程来说 Web 服务活动实质还是个自动活动, 因此除了新增下述配置 Tab 页面外, 其余配置项均和自动活动配置方式一致 WSDL 配置配置界面如下图所示 : WSDL: 通过浏览按钮, 定位所在项目中的 WSDL 文件, 填入 WSDL 输入框用于调用时读取并加载 WSDL 描述文件服务 : 浏览并确定 WSDL 文件后, 在

8 配置 web 服务活动对于业务流程来说 Web 服务活动实质还是个自动活动, 因此除了新增下述配置 Tab 页面外, 其余配置项均和自动活动配置方式一致 WSDL 配置配置界面如下图所示 : WSDL: 通过浏览按钮, 定位所在项目中的 WSDL 文件, 填入 WSDL 输入框用于调用时读取并加载 WSDL 描述文件服务 : 浏览并确定 WSDL 文件后, 在服务下拉框中列出 WSDL 文件中的所有服务, 选中待执行的服务即可 Port: 确定服务后, Port 下拉框内列出关联的所有 Port 接口, 选中待执行的 Port 即可 Operation: 确定服务后, Operation 下拉框内列出关联的所有 Operation 方法, 选中待执行的 Operation 方法即可 URL: 描述 WSDL 服务发布路径, 是一个 URL 路径 URL 地址中可以携带变量, 相关规则如下 : 第 8 页共 17 页

$变量格式为 ${ 变量 }( 比如 :${SERVICE_LOCATION1} /Service1 URL 地址中的变量为应用对应的 user-config.xml 当中的如下部分配置的变量 <module name="wslocation"> <group name="property"> <configvalue key=" SERVICE_LOCATION1">http://www.$

9 变量格式为 ${ 变量 }( 比如 :${SERVICE_LOCATION1} /Service1 URL 地址中的变量为应用对应的 user-config.xml 当中的如下部分配置的变量 <module name="wslocation"> <group name="property"> <configvalue key=" SERVICE_LOCATION1"> </group> </module> 下面注 :user-config.xml 文件位置在 $BPS_HOME/working/$APPNAME/config 目录参数配置表 : 参数列表中配置待执行的 Operation 方法的输入 / 输出参数规则同自动活动的应用调用参数配置规则相同 SOAP Header: 每次调用 Web 服务时, 作为 SOAP 协议的 Header 部分数据传给 Web 服务服务端 SOAP Header 的选项配置可以在 Eclipse 首选项的 Primeton BPS->SOAP Header 管理中进行附件配置 : 每次调用 Web 服务时, 可携带相关附件传输给 Web 服务服务端, 附件一定是文件所输入的值应该是附件所在的文件路径文件类型涵盖了绝大部分 MIME 类型的文件部署流程和资源流程编辑完毕以后, 就可以部署到流程引擎了, 包括 WSDL 相关资源的部署和流程的部署流程的部署 : 该操作和 BPS6.0GA 相同可以直接在 Studio 中提交, 也可以导出扩展名为 ecd 的部署包然后通过 BPS 管理监控部署 WSDL 相关资源的部署 : 流程引用的 WSDL 和 XSD 相关资源文件的部署方式和 class 相同, 需要部署到流程引擎的 WEB-INF/classes 目录下面目前对 WSDL 和 XSD 的部署不支持热部署, 如果对现有资源有修改, 需要重启动引擎应用第 9 页共 17 页

1.2.2 生成 Java Stub 调用 Web 服务 1.2.2.1 Java Stub 代码生成在项目资源管理器视图中右键 WSDL 文件节点, 选择

10 1.2.2 生成 Java Stub 调用 Web 服务 Java Stub 代码生成在项目资源管理器视图中右键 WSDL 文件节点, 选择生成 Java 客户端代码菜单, 打开生成 Java 客户端代码向导 : 选择要生成的 Java 客户端代码默认存放的包路径, 点击完成第 10 页共 17 页

11 完成后会在所选目录自动生成 WSDL 对应的 java 客户端代码, 用户可以直接使用本地 java API 的方式进行调用生成代码如下图所示第 11 页共 17 页

如果生成代码后编译出错, 报告找不到相关的类, 请检查项目是否导入了代码生成依赖库, 代码生成依赖库可以通过在项目的属性 > java 构建路径中的添加库按钮加载, 库类型名称为 BPS WebService CodeGen Support Libraries WSDL 引用的复杂类型会生成对应的

12 如果生成代码后编译出错, 报告找不到相关的类, 请检查项目是否导入了代码生成依赖库, 代码生成依赖库可以通过在项目的属性 > java 构建路径中的添加库按钮加载, 库类型名称为 BPS WebService CodeGen Support Libraries WSDL 引用的复杂类型会生成对应的 Java 类, 这些 Java 类的包名符合 http 路径和 Java 包命名的映射规则比如, 如果某复杂类型的命名空间是则生成的类会在 cn.com.webxml 下面如果生成的代码所在的目录具有相同的 Java 文件, 则会自动覆盖已有文件第 12 页共 17 页

1.2.2.2 Java Stub 的使用 JavaStub 代码生成会对每一个对应的 PortType 生成对应的接口, 同时生成命名为接口名 Stub 的实现类可以使用该实现类来实例化接口, 然后调用对应的方法系统同时为每个方法的调用产生了输入和输出的包装类以下代码为使用天气预报服务的方法 : public static void main(string[] args) throws

13 Java Stub 的使用 JavaStub 代码生成会对每一个对应的 PortType 生成对应的接口, 同时生成命名为接口名 Stub 的实现类可以使用该实现类来实例化接口, 然后调用对应的方法系统同时为每个方法的调用产生了输入和输出的包装类以下代码为使用天气预报服务的方法 : public static void main(string[] args) throws RemoteException { // 创建 PortType 类 WeatherWebService stub = new WeatherWebServiceStub(); // 创建参数类, 设置参数 GetWeatherbyCityName para = new GetWeatherbyCityName(); para.setthecityname(" 上海 "); // 执行操作 GetWeatherbyCityNameResponse ret = stub.getweatherbycityname(para); // 操作返回值 System.out.println(ret.getGetWeatherbyCityNameResult()); } 第 13 页共 17 页

14 1.3 BPS 支持的 Web 服务的 WSDL 技术规格 BPS 支持满足以下条件的 WSDL 支持 WSDL1.1 版本支持 WSDL:message 节点下有单 Part 多 Part 支持单 PortType 多 PortType 支持单服务多服务支持 WSDL: 服务下有单 Port 多 Port 支持 WSDL 引入另一个 WSDL, 如 : <WSDL:import location="abc.wsdl" namespace=" 支持 WSDL 文件中的 WSDL:types 中使用 import 或 include 引入另外的 XSD 文件, 如 : <XSD:import namespace=" schemalocation="c.xsd"/> <XSD:include schemalocation="echannel.xsd"/> 支持被引用的 WSDL 文件再引用 WSDL 或 XSD, 被引用的 XSD 在再引用其他 XSD 支持 WSDL:portType 有多个 Operation 支持 SOAP 1.1 和 SOAP 1.2 绑定支持 rpc/encoded rpc/literal document/literal document/literal wrapped 四种样式, 举例如下 : <binding name="time 服务 Soap" type="s0:time 服务 Soap"> <soap:binding style="document" transport=" </binding> 1.4 WebService 环境配置说明嵌入式安装 Weblogic Windows 环境 : 1) 需要修改 domain 目录下的 bin/setdomainenv.cmd 在文件最后新增一行如下: set CLASSPATH= bps.war 路径 /WEB-INF/lib/saaj-api-1.3.jar; bps.war 路径 /lib/saaj-impl jar;%classpath% 注意 : 对于嵌入式而言,saaj-api-1.3.jar,saaj-impl jar 这 2 个文件在 bps.war/web-inf/lib 目录下第 14 页共 17 页

15 2) 需要修改 domain 目录下的 bin/startweblogic.cmd 在 JAVA_OPTIONS 中新增如下内容 : ryimpl -Djavax.xml.soap.SAAJMetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFacto Linux/Unix 环境 : 1) 需要修改 domain 目录下的 bin/setdomainenv.sh 在 export CLASSPATH 之前新增一行如下 : CLASSPATH= bps.war 路径 /lib/saaj-api-1.3.jar: bps.war 路径 /lib/saaj-impl jar:$classpath 注意 : 对于嵌入式而言,saaj-api-1.3.jar,saaj-impl jar 这 2 个文件在 bps.war/web-inf/lib 目录下 2) 需要修改 domain 目录下的 bin/startweblogic.sh 在 JAVA_OPTIONS 中新增如下内容 : -Djavax.xml.soap.SAAJMetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaF actoryimpl WebSphere 1) 修改 WebShpere 安装目录下的 AppServer/lib/j2ee.jar 文件, 删除其中 javax.xml.soap 包的内容 2) 修改 WebShpere 安装目录下的 AppServer/bin/startServer.sh 文件, 在 D_ARGS 中增加如下内容 : -Djavax.xml.soap.SAAJMetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFacto ryimpl 注意事项 : 如果您使用的是 IBM JDK, 请将 xercesimpl.jar 放到 bps.war/web-inf/lib 目录下, 要同 saaj-api-1.3.jar,saaj-impl jar 放一起也可以修改启动脚本, 将 xercesimpl.jar 加到 CLASSPATH 变量中锐捷版本 WebSphere 修改 WebShpere 安装目录下的 AppServer/lib/j2ee.jar 文件, 删除其中 javax.xml.soap 包的内容避免和产品中自带的 saaj-api-1.3.jar 冲突 JBoss 第 15 页共 17 页

16 删除 server/default/lib 目录下的 jboss-saaj.jar 避免和产品中自带的 saaj-api-1.3.jar 冲突 2 短流程 2.1 短流程简述当前高端的电信金融等行业除了人工参与的长流程之外, 还有无需人工参与的短流程, 比如电信的自动化服务开通流程短流程的特点是流程实例数量很大, 甚至达到每天上百万以上的流程实例, 基本无需等待, 流程完成, 对流程引擎的性能压力很高为了应对这些短流程的场景,BPS 引入对短流程的支持 2.2 如何在 BPS 中使用短流程 BPS 引入对短流程的支持, 使用方法很简单只需要在流程定义中配置相关属性即可第 16 页共 17 页

17 上图可见长流程复选框, 默认值为长流程, 复选框去掉后则表示本流程定义为短流程注 :BPS 中短流程不能包含人工活动, 其他配置特性和 BPS 中的长流程相同 2.3 短流程配置管理在 BPS 配置管理中新增短流程配置项 : 总是持久化流程实例总是持久化自动活动实例和自动删除完成的短流程实例如下图所示: 注意 : 如果选择总是持久化短流程的自动活动实例, 则总是持久化短流程的流程实例也要一并选中各选项含义如下 : 总是持久化流程实例 : 如果选择了该项, 则短流程运行过程中产生的流程实例 (WFProcessInst) 总是持久化的如果没有选择, 则流程引擎会根据优化策略可能不会产生流程实例的持久化记录, 以达到较好的运行性能总是持久化活动实例 : 如果选择了该项, 则短流程运行过程中产生的自动活动实例 (WFActivityInst) 总是持久化的如果没有选择, 则流程引擎会根据优化策略可能不会产生流程实例的持久化记录, 以达到较好的运行性能自动删除完成的短流程实例 : 如果选择了该项, 对于持久化的短流程实例数据库记录, 在流程运行完毕以后系统会自动删除, 从而使得流程实例库中总是保持较少量的数据, 保证流程引擎的性能不随数据量的增加而过分降低如果没有选择该项, 则流程引擎不会自动删除运行完毕的短流程实例第 17 页共 17 页

BPS6.0 Web服务集成和短流程功能使用手册

BPS6.0 Web服务集成和短流程功能使用手册 PRIMETON TECHNOLOGIES, LTD. 上海普元信息技术有限责任公司 BPS6.0 Web 服务集成和短流程使用手册 2009-9-1 第 1 页共 16 页目录 1 Web 服务集成... 3 1.1 Web 服务简述... 3 1.2 在 BPS 中使用 Web 服务功能... 3 1.2.1 使用 Web