ofbiz工作流程原始碼學習（2）–WfExecutionObject介面

WfExecutionObject介面與實現

1．概述

WfExecutionObject介面是一個抽象基類介面，它定義了WfProcess和WfActivity公有的屬性，狀態和操作。WfExecutionObject的操作返回的狀態與流程狀態是不同的。WfExecutionObject提供了方法來擷取當前的狀態並完成從目前狀態向另一狀態的轉變。但WfExecutionObject的狀態是執行對象的狀態，WfProcess的狀態是流程的狀態，他們之間並沒有必然的關係。

 

2．屬性及相應方法

2.1 name

   name屬性是工作流程執行對象的描述性名字，name屬性的擷取和設定是通過GenericDelegator和workEffortId來完成的：

    public String name() throws WfException {

        return getRuntimeObject().getString("workEffortName");

    }

    public void setName(String newValue) throws WfException {

        GenericValue dataObject = getRuntimeObject();

        try {

            dataObject.set("workEffortName", newValue);

            dataObject.store();

        } catch (GenericEntityException e) {

            throw new WfException(e.getMessage(), e);

        }

    }

  

2.2 key

   key是工作流程執行對象的唯一標示符。一個特定的工作流程管理器產生的流程集合中，每個流程都有一個唯一的key;一個流程包含的活動集合中，每個活動都有一個唯一的key。當工作流程執行對象產生時，由工作流程管理器為它分配一個特定的key。

   Key不同於對象標示符，它是工作流程執行對象生命週期中流程或活動的reference。它由activityId或processId來表示。

2.3 process_context

   process_context是定義執行對象環境的流程相關資料，它由一系列的名字屬性來描述。process_context由一系列的名值對來表達，process_context的擷取和設定是通過runtimeDataId和GenericValue來實現的。

2.4 priority

   priority的有效值在0到5之間，一個為highest,三個為normal,另外一個為其它情況。

2.5 last_state_time

   表示上次狀態改變的時間，如下：

    public Timestamp lastStateTime() throws WfException {

        GenericValue dataObject = getRuntimeObject();

 

        if (dataObject == null || dataObject.get("lastStatusUpdate") == null)

            throw new WfException("No runtime object or status has never been set.");

        return dataObject.getTimestamp("lastStatusUpdate");

}

 

3．狀態

   總的狀態分為open和closed。

   Open分為open.running和open.not_running。

   Open.not_running分為not_running.not_started和not_running.suspended。

   Closed分為closed.completed，closed.terminated和closed.aborted。

   從not_running.suspended到open.running應該用resume()方法。另外調用terminate()方法，abort()方法或complete()方法,suspend()方法可以到相應的狀態。當然了，最通用的改變狀態的方法是用changeState(int state)方法。