ofbiz工作流源代码学习（2）--WfExecutionObject接口

WfExecutionObject接口与实现

1．概述

WfExecutionObject接口是一个抽象基类接口，它定义了WfProcess和WfActivity公有的属性，状态和操作。WfExecutionObject的操作返回的状态与流程状态是不同的。WfExecutionObject提供了方法来获取当前的状态并完成从当前状态向另一状态的转变。但WfExecutionObject的状态是执行对象的状态，WfProcess的状态是流程的状态，他们之间并没有必然的关系。

 <!----><o:p></o:p>

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();

 <o:p></o:p>

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

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

        return dataObject.getTimestamp("lastStatusUpdate");

}

 <o:p></o:p>

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)方法。

 <o:p></o:p>

 <o:p></o:p>

 <o:p></o:p>