基本的osworkflow API

接口选择：

osworkflow提供几种实现com.opensymphony.workflow.Workflow。

BasicWorkflow：

不提供事务支持，你可以通过持久层来实现事务处理。

Workflow wf = new BasicWorkflow(username)

这里的username是用来关联当前请求的用户。

EJBWorkflow：

用ejb容器来治理事务。在ejb-jar.XML中进行配置。

Workflow wf = new EJBWorkflow()

这里没有必要想basicworkflow和ofbizworkflow那样给出username。因为ejb容器已经校验过的。

Ofbizworkflow：

与basicworkflow比较相似，不同只在于需要事务支持的方法由ofbiz TransactionUtil calls来包装。

创建新的工作流实例：

这里是以basicworkflow为例子

Workflow wf = new BasicWorkflow(username);

HashMap inputs = new HashMap();

inputs.put("docTitle", request.getParameter("title"));

wf.initialize("workflowName", 1, inputs);

执行action：

Workflow wf = new BasicWorkflow(username);

HashMap inputs = new HashMap();

inputs.put("docTitle", request.getParameter("title"));

long id = Long.parseLong(request.getParameter("workflowId"));

wf.doAction(id, 1, inputs);

查询：

值得注重的是：并不是所有的 workflow stores支持查询。当前的hibernate，jdbc和内存工作流存储支持查询。Hibernate存储不支持mixed-type查询（如，一个查询使用到了历史和当前step contexts）。为了执行一个查询，需要构造出一个WorkflowEXPressionQuery对象。查询方法是在这个对象上被调用的。

简单查询、嵌套查询、mixed-context查询（不支持hibernate工作流存储）在docs文档的5.4部分都有。

2.7版的osworkflow提供一种配置接口。默认实现是DefaultConfiguration，通过AbstractWorkflow的setconfiguration方法来更改历史遗留的singleton静态模型使其不会被使用。应该避免每次都创建新的工作流实例。

遗留部分:

Workflow workflow = new BasicWorkflow("blah");

long workflowId = workflow.initialize("someflow", 1, new HashMap());

workflow.doAction(workflowId, 2, new HashMap());

...

//in some other class, called later on

Workflow workflow = new BasicWorkflow("blah");

workflow.doAction(workflowId, 3, new HashMap());

推荐方法:

Workflow workflow = new BasicWorkflow("blah");

Configuration config = new DefaultConfiguration();

workflow.setConfiguration(config);

long workflowId = workflow.initialize("someflow", 1, new HashMap());

workflow.doAction(workflowId, 2, new HashMap());

//keep track of Workflow object somewhere!

...

//in some other class, called later on

//look up Workflow instance that was held onto earlier

Workflow workflow = ...; //note, do NOT create a new one!

workflow.doAction(workflowId, 3, new HashMap());

实际当中还是需要到Javadoc中不断去查。