学习（史帝芬）osworkflow入门教程后的一些体会

可以这么说史帝芬的http://my.so-net.net.tw/idealist/OSWorkflow/osworkflow资料是目前华文osworkflow资料中最好的一份入门教程。去面的时候在mssql中中实践过这份入门资料，感觉非常顺利。但感觉按作者的顺序把教程中的例子跑完了，还不完全清楚的明白osworkflow的架构。前些在mysql5.0中重做一次，遇到了挺多问题，我通过一步一步的跟踪原代码调试终于把这些问题搞定。下图是把osworkflow所提供的mysql下的数据表的ER图:

如果你的osworkflow持久化到mysql中你的osworkflow.xml文件内如必需按如下格式来写:

<osworkflow>
<persistence class="com.opensymphony.workflow.spi.jdbc.MySQLWorkflowStore">
<property key="datasource" value="jdbc/DefaultDS"/>

    <property key="step.sequence.increment" value="INSERT INTO OS_STEPIDS (ID) values (null)"/>
    <property key="step.sequence.retrieve"   value="SELECT count(ID) FROM OS_STEPIDS"/>
    <property key="entry.sequence.increment" value="INSERT INTO OS_ENTRYIDS (ID) values (null)"/>
    <property key="entry.sequence.retrieve" value="SELECT count(ID) FROM OS_ENTRYIDS"/>

<property key="entry.table" value="OS_WFENTRY"/>
<property key="entry.id" value="ID"/>
<property key="entry.name" value="NAME"/>
<property key="entry.state" value="STATE"/>

</persistence>

<factory class="com.opensymphony.workflow.loader.XMLWorkflowFactory">
  <property key="resource" value="workflows.xml"/>
</factory>
</osworkflow>
propertyset.xml文件格式如下：
<?xml version="1.0" encoding="UTF-8"?>
<propertysets>
    <propertyset name="jdbc"
      class="com.opensymphony.module.propertyset.database.JDBCPropertySet">
        <arg name="datasource" value="java:comp/env/jdbc/DefaultDS"/>
        <arg name="table.name" value="OS_PROPERTYENTRY"/>
        <arg name="col.globalKey" value="GLOBAL_KEY"/>
        <arg name="col.itemKey" value="ITEM_KEY"/>
        <arg name="col.itemType" value="ITEM_TYPE"/>
        <arg name="col.string" value="STRING_VALUE"/>
        <arg name="col.date" value="DATE_VALUE"/>
        <arg name="col.data" value="DATA_VALUE"/>
        <arg name="col.float" value="FLOAT_VALUE"/>
        <arg name="col.number" value="NUMBER_VALUE"/>
    </propertyset>
</propertysets>
workflows.xml文件格式如下：

<workflows>
<workflow name="leave" type="resource" location="leave.xml"/>
</workflows>

osuser.xml文件格式如下：
<?xml version="1.0" encoding="UTF-8"?>
<opensymphony-user>
         <provider class="com.opensymphony.user.provider.jdbc.JDBCAccessProvider">
         <property name="user.table">os_user</property>
         <property name="group.table">os_group</property>
         <property name="membership.table">os_membership</property>
         <property name="user.name" >username</property>
         <property name="user.password">passwordhash</property>
         <property name="group.name">groupname</property>
         <property name="membership.userName" >username</property>
         <property name="membership.groupName">groupname</property>
         <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
       </provider>
       <provider class="com.opensymphony.user.provider.jdbc.JDBCCredentialsProvider">
         <property name="user.table">os_user</property>
         <property name="group.table">os_group</property>
         <property name="membership.table">os_membership</property>
         <property name="user.name" >username</property>
         <property name="user.password">passwordhash</property>
         <property name="group.name">groupname</property>
         <property name="membership.userName" >username</property>
         <property name="membership.groupName">groupname</property>
         <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
       </provider>
       <provider class="com.opensymphony.user.provider.jdbc.JDBCProfileProvider">
         <property name="user.table">os_user</property>
         <property name="group.table">os_group</property>
         <property name="membership.table">os_membership</property>
         <property name="user.name" >username</property>
         <property name="user.password">passwordhash</property>
         <property name="group.name">groupname</property>
         <property name="membership.userName" >username</property>
         <property name="membership.groupName">groupname</property>
         <property name="datasource">java:comp/env/jdbc/DefaultDS</property>
       </provider>
       <authenticator class="com.opensymphony.user.authenticator.SmartAuthenticator" />
     </opensymphony-user>

请假列子的配置如下：

package com.pdw.wfbo;

import java.util.HashMap;
import java.util.Map;

import com.opensymphony.workflow.*;
import com.opensymphony.workflow.basic.BasicWorkflow;
import com.opensymphony.workflow.config.DefaultConfiguration;

public class LeaveWFBO {

   /**
    * 送出假单
    * @param employee
    * @return
    */
public long send(String employee) {
  Workflow workflow=new BasicWorkflow("peidw");
  DefaultConfiguration config=new DefaultConfiguration();
  workflow.setConfiguration(config);
  long workflowId=-1;
  try {
   workflowId=workflow.initialize("leave",0,null);//leave是workflows.xml里配置的工作流名称
   workflow.doAction(workflowId,1,null);
  }catch(Exception e) {
   e.printStackTrace();
  }
  return workflowId;
}

    /**
     * 批假
     * @param workflowId 工作流编号
     * @param actionId 工作编号，2 准许，3 驳回
     */
public void allow(long workflowId,int actionId) {
  Workflow workflow=new BasicWorkflow("peidw");
  DefaultConfiguration config=new DefaultConfiguration();
  workflow.setConfiguration(config);
  try {
   System.out.println("actionId->"+actionId);
   System.out.println("workflowId->"+workflowId);
   workflow.doAction(workflowId,actionId,null);
  }catch(Exception e) {
   e.printStackTrace();
  }
}

}

这是上面的这个例子的一个说明

(史帝芬, 2005/6/6, [email protected])

看完第一支程式，相信讀者會有許多疑問，這些先就流程的設定做初步的介紹。首先，讀者應該注意到了，第一支程式的用到三個xml設定檔，沒錯，這三個是設定流程的設定檔。

osworkflow.xml：這個檔案是設定流程是否存在資料庫或存在記憶體，前面的內容是存在MS SQL Server的寫法。
leave.xml：請假流程寫在這個檔案，這也是osworkflow的重點之一。
workflows.xml：指定系統啟動時要載入那些流程。

這裡針對leave.xml做些說明…

initial-actions：每個流程都至少需定義一個initial-actions，這是流程的起點。
action：導致流程變動的動作，每個action都有個編號，且不能重複。
step：雖然它的名稱是步驟，似乎它會有動作? 其實將它視為流程位置可能比較恰當，osworkflow真正的動作在action發生。
result：執行動作後的結果，result有兩種conditional-result和unconditional-result，每個result一定有unconditional-result，當conditional-result的條件都不滿足時，就執行unconditional-result。
status：流程在某個action時的狀態。
old-status：流程執行某個action後的狀態。
caller：這是OSWorkflow的保留字，可取得呼叫此工作流的user，即Workflow workflow = new BasicWorkflow(caller); 在資料庫中會記錄於Table OS_HISTORYSTEP如下:

記得在pre-functions加上如下設定…
```
<pre-functions>
  <function type="class">
    <arg name="class.name">com.opensymphony.workflow.util.Caller</arg>
  </function>
</pre-functions>
```

学习（史帝芬）osworkflow入门教程后的一些体会

你可能感兴趣的:(学习（史帝芬）osworkflow入门教程后的一些体会)