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 >

        [... endpoint reference....]

       </ partnerRole > ?

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

        binding ="Document Literal|RPC Encoded|RPC Literal|External|Policy Driven" /> ?

     </ partnerLink > +

   </ partnerLinks >

   < references >

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

   </ references > ?

</ process >

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

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

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

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

l  partnerLink 描述了流程中每个partner扮演的角色，endpointReference属性定义了一个partner的地址是从何处获得的。

n  static       在PDD定义

n  dynamic     从流程运行时从BPEL流程中映射

n  invoker      从partnerde SOAP消息头获得（WS-Addressing）

n  principal     从基于认证规则的partner定义文件（.pdef）获得

l  EndpointReference元素基于WS-Addressing标准。

n  Address子元素用于提供服务的地址；

n  ServiceName与PortName分别对应相关服务的WSDL文件中的定义。

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

l  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定义）：

<? xml version="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的格式具体细节）。