ActiveBPEL引擎流程部署描述符（pdd）文件概述

文章仅供大家参考，所有评论 , 错误报告 , 其他信息以及批评 , 请邮寄到 Jeffery.Lee AT gmail.com 或者访问我的个人blog同我交流 ( http://ibuddie.spaces.live.com/ ) 。本文遵从 GNU 的自由文档许可证 (Free Document License) 的条款，欢迎转载，如若修改、散布，请注明文章原始出处和来源。

---

PDD相关内容总结

概述

在ActiveBPEL引擎执行时需要用户定义一个流程部署描述符(Process Deployment Descriptor)文件来与引擎交互，这个文件后缀为pdd。pdd文件告诉ActiveBPEL引擎关于BPEL流程的相关信息。每一个流程文件 (*.bpel)部署之前都需要包含它对应的.pdd文件（一对多的关系）。pdd文件基于XML格式，它的元素包含了partner links 和 WSDL的描述。

关于pdd文件有必要说明以下两点：

首先，pdd文件格式虽然是基于XML的，但它并非标准的文件格式，它是我们采用的ActiveBPEL引擎特有的。因为目前关于BPEL流程部署时相关信息和引擎绑定这方面并没有事实的标准，不同的引擎提供商拥有各自不同的部署文件格式，并提供相应的可视化工具来实现部署文件的生成。

其次，Active-endpoints公司并没有提供任何API供创建pdd文件使用，目前也没有任何第三方提供相应的pdd创建工具。Active-endpoints公司免费提供的ActiveBPEL Designer是目前唯一支持可视化创建pdd的产品。

pdd文件格式

pdd本身是一个XML文件，其Schema定义在以下网址可以查看到：

http://schemas.active-endpoints.com/pdd/2006/08/pdd.xsd

其语法格式总结如下：

< process name ="qname"

xmlns =http://schemas.active-endpoints.com/pdd/2005/09/pdd.xsd

xmlns:wsa =http://schemas.xmlsoap.org/ws/2003/03/addressing

xmlns:bpelns =”qname”

location ="relativeDeploymentLocation"

persistenceType ="full|none" ? >

< partnerLinks >

< partnerLink name ="ncname" >

< partnerRole

endpointReference ="static|dynamic|invoker|principal"

<wsa:EndpointReference >

< wsa:Address > url </ wsa:Address >

< wsa:ServiceName PortName =”qname”>qname</wsa:ServiceName>

</wsa:EndpointReference >

[...endpointreference....]

</ partnerRole > ?

< myRole service ="name" allowedRoles ="namelist" ?

binding ="DocumentLiteral|RPCEncoded|RPCLiteral|External|PolicyDriven" /> ?

</ partnerLink > +

</ partnerLinks >

< references >

< wsdl location ="uri" namespace ="uri" /> +

</ references > ?

</ process >

<!--[if !supportLists]-->l <!--[endif]-->relativeDeploymentLocation属性定义了BPEL文件的路径，与BPEL引擎运行时的类路径相关。通常BPEL文件的路径是指与pdd文件在同一个bpr中的BPEL文件的相对路径。

<!--[if !supportLists]-->l <!--[endif]-->persistenceType属性将覆盖引擎自身的持久性设置，可选值为“full|none”。它将影响到所有在此pdd文件基础上由引擎创建的BPEL流程实例。

<!--[if !supportLists]-->n <!--[endif]-->full为默认值，表示所有的流程实例（该pdd基础上创建）将按照引擎配置的正常持久性机制运行；

<!--[if !supportLists]-->n <!--[endif]-->none表示流程实例不需要持久性支持。所有行为将按照ActiveBPEL引擎默认的in-memory设置进行；

<!--[if !supportLists]-->l <!--[endif]-->partnerLink 描述了流程中每个partner扮演的角色，endpointReference属性定义了一个partner的地址是从何处获得的。

<!--[if !supportLists]-->n <!--[endif]-->static 在PDD定义

<!--[if !supportLists]-->n <!--[endif]-->dynamic 从流程运行时从BPEL流程中映射

<!--[if !supportLists]-->n <!--[endif]-->invoker 从partnerde SOAP消息头获得（WS-Addressing）

<!--[if !supportLists]-->n <!--[endif]-->principal 从基于认证规则的partner定义文件（.pdef）获得

<!--[if !supportLists]-->l <!--[endif]-->EndpointReference元素基于WS-Addressing标准。

<!--[if !supportLists]-->n <!--[endif]-->Address子元素用于提供服务的地址；

<!--[if !supportLists]-->n <!--[endif]-->ServiceName与PortName分别对应相关服务的WSDL文件中的定义。

<!--[if !supportLists]-->l <!--[endif]-->myRole元素中的allowedRoles属性值必须为空，除非你使用应用服务器自带的安全机制。该属性的设置是希望能够利用应用服务器已经存在的Web安全机制。

<!--[if !supportLists]-->l <!--[endif]-->references元素列出了BPEL流程参考引用的WSDL文件，它被ActiveBPEL引擎用来创建WSDL在内存中的表示。在每个<wsdl>元素，namespace属性被用来将BPEL中的名空间映射到一个具体的location。location属性可以是一个文件名或者任何URL。首先，location的值将首先供bpr包中META-INF子目录下catalog.xml的定义来查找使用；接下来，引擎将根据location的值获得具体的wsdl的名字（忽略之前的URL或文件相应路径），如果该名字的文件可以在bpr包中的wsdl子目录下找到，那么该WSDL将被引擎读取，否则的话，该location将被视为一个URL，引擎将根据该地址去寻找并读取该WSDL。

pdd文件实例

具体pdd的例子可以参考下面这个例子（BPEL规范中的Loan Approval例子，服务wsdl文件（不含partnerLinkType定义）放置在服务器上通过url方式获得，本地建立wrapper包装wsdl，并在其中实现partnerLinkType定义）：

<? xmlversion="1.0"encoding="UTF-8" ?>
< process xmlns ="http://schemas.active-endpoints.com/pdd/2006/08/pdd.xsd"
xmlns:bpelns ="http://www.jefferylee.com/loan_approval"
xmlns:wsa ="http://schemas.xmlsoap.org/ws/2003/03/addressing"
location ="bpel/Loan_Approval_Remote/loan_approval.bpel"
name ="bpelns:loan_approval" persistenceType ="none" >
< partnerLinks >
< partnerLink name ="approver" >
< partnerRole endpointReference ="static" >
< wsa:EndpointReference xmlns:s ="http://example.com/loan-approval/wsdl/"
xmlns:wsa ="http://schemas.xmlsoap.org/ws/2003/03/addressing" >
< wsa:Address > http://localhost:8080/active-bpel/services/ApproverWebService </ wsa:Address >
< wsa:ServiceName PortName ="SOAPPort" > s:LoanApprover </ wsa:ServiceName >
</ wsa:EndpointReference >
</ partnerRole >
</ partnerLink >
< partnerLink name ="assessor" >
< partnerRole endpointReference ="static" >
< wsa:EndpointReference
xmlns:s ="http://example.com/loan-approval/wsdl/"
xmlns:wsa ="http://schemas.xmlsoap.org/ws/2003/03/addressing" >
< wsa:Address > http://localhost:8080/active-bpel/services/AssessorWebService </ wsa:Address >
< wsa:ServiceName PortName ="SOAPPort1" > s:LoanAssessor </ wsa:ServiceName >
</ wsa:EndpointReference >
</ partnerRole >
</ partnerLink >
< partnerLink name ="customer" >
< myRole allowedRoles ="" binding ="RPC" service ="LoanService" />
</ partnerLink >
</ partnerLinks >
< references >
< wsdl location ="http://10.3.5.37/loanServicePT.wsdl"
namespace ="http://example.com/loan-approval/wsdl/" />
< wsdl location ="project:/Loan_Approval_Remote/wsdl/wrapper.wsdl"
namespace ="http://example.com/loan-approval/wsdl/wrapper" />
</ references >
</ process >

---

参考引用
1 http://forums.active-endpoints.com/showthread.php?t=2426

Quote:

Why does the engine need such a non standard file format?

There is no standard defined for establishing the binding information required for a BPEL process deployment. Every vendors implementation will have it's own unique deployment file format and in many cases different due to the different capabilities that a vendor may choose to provide for their implementation.

Quote:

Is there an API to manage/create the PDD files?

There is no API that creates a pdd as it is dependent on many of the options that you awant to use. There are users that have created their own code to create a pdd which can either be very compex or complicated depending on the options you want to take advantage of.

I am not clear as to what you mean by manage. Can you provide any examples of this?

Quote:

Are there any GPL tools to manage/create PDD files?

Again I am not sure what you mean by manage here. I am not aware of any GPL tools that have been created. Note however the ActiveBPEL Desginer is a free product which provides an unparalleled development, deployment and testing (simulation and remote debugging) environment for all your BPEL needs.

2 http://www.active-endpoints.com/activebpel-pdd-for-version-2x.htm
官方早期关于pdd的格式说明，但基于ActiveBPEL2.0，在3.0以后有很大改动，本文基于ActiveBPEL4.0实现（不知何原因，目前官方从2.0后就不再透露pdd的格式具体细节）。