更多的流程定义描述符概念

原创 2005年05月29日 14:50:00

h3 定义条件和函数

你也许已经注意到,到目前为止,我们定义的条件和函数类型都是“class”。这种类型的条件和函数接受一个参数:“class.name”,以此来指明一个实现FunctionProvider或Condition接口的完整类名。

在osworkflow里面也有一些其他内置的类型,包括beanshell,无状态的session bean,JNDI树上的函数等。我们在下面的例子里使用beanshell类型。

h3 Property sets

我们可能需要在工作流的任意步骤持久化一些少量数据。在osworkflow里,这是通过OpenSymphony的PropertySet library来实现。一个PropertySet基本上是一个可以持久化的类型安全map,你可以添加任意的数据到propertyset(一个工作流实例对应一个propertyset),并在以后的流程中再读取这些数据。除非你特别指定操作,否则propertyset中的数据不会被清空或者被删除。任意的函数和条件都可以和propertyset交互,以beanshell script来说,可以在脚本上下文中用“propertyset”这个名字来获取。下面来看具体写法是怎么样的,让我们增加如下的代码在“Start First Draft”动作的pre-functions里面:

<function type="beanshell">
  <arg name="script">propertySet.setString("foo", "bar")</arg>
</function>

这样我们就添加了一个持久化的属性“foo”,它的值是“bar”。这样在以后的流程中,我们就可以获得这个值了。

h3 Transient Map 临时变量

另外一个和propertyset变量相对的概念是临时变量:“transientVars”。临时变量是一个简单的map,只是在当前的工作流调用的上下文内有效。它包括当前的工作流实例,工作流定义等对应值的引用。你可以通过FunctionProvider的javadoc来查看这个map有那些可用的key。

还记得我们在教程的第2部分传入的那个null吗?如果我们不传入null的话,那么这些输入数据将会被添加到临时变量的map里。

h3 inputs 输入

每次调用workflow的动作时可以输入一个可选的map,可以在这个map里面包含供函数和条件使用的任何数据,它不会被持久化,只是一个简单的数据传递。

h3 Validators 校验器

为了让工作流能够校验输入的数据,引入了校验器的概念。一个校验器和函数,条件的实现方式非常类似(比如,它可以是一个class,脚本,或者EJB)。在这个教程里面,我们将会定义一个校验器,在“finish first draft”这个步骤,校验用户输入的数据“working.title”不能超过30个字符。这个校验器看起来是这样的:
package com.mycompany.validators;

public class TitleValidator implements Validator
{
  public void validate(Map transientVars, Map args, PropertySet ps) 
        throws InvalidInputException, WorkflowException
  {
    String title = (String)transientVars.get("working.title"); 
    if(title == null)
      throw new InvalidInputException("Missing working.title");
    if(title.length() > 30)
      throw new InvalidInputException("Working title too long");
  }
}

然后通过在流程定义文件添加validators元素,就可以登记这个校验器了:

<validators>
  <validator type="class">
    <arg name="class.name">
      com.mycompany.validators.TitleValidator
    </arg>
  </validator>
</validators>

这样,当我们执行动作2的时候,这个校验器将会被调用,并且检验我们的输入。这样在测试代码里面,如果加上:

Map inputs = new HashMap();
inputs.put("working.title", 
  "the quick brown fox jumped over the lazy dog," +
  " thus making this a very long title");
workflow.doAction(workflowId, 2, inputs);

我们将会得到一个InvalidInputException,这个动作将不会被执行。减少输入的title字符,将会让这个动作成功执行。

我们已经介绍了输入和校验,下面来看看寄存器。

h3 Registers 寄存器

寄存器是一个工作流的全局变量。和propertyset类似,它可以在工作流实例的任意地方被获取。和propertyset不同的是,它不是一个持久化的数据,而是每次调用时都需要重新计算的数据。

它可以被用在什么地方呢?在我们的文档管理系统里面,如果定义了一个“document”的寄存器,那么对于函数、条件、脚本来说就是非常有用的:可以用它来获得正在被编辑的文档。

寄存器地值会被放在临时变量(transientVars map)里,这样能够在任意地方获得它。

定义一个寄存器和函数、条件的一个重要区别是,它并不是依靠特定的调用(不用关心当前的步骤,或者是输入数据,它只是简单地暴露一些数据而已),所以它不用临时变量里的值。

寄存器必须实现Register接口,并且被定义在流程定义文件的头部,在初始化动作之前。

举例来说,我们将会使用一个osworkflow内置的寄存器:LogRegister。这个寄存器简单的添加一个“log”变量,能够让你使用Jakarta的commons-logging输出日志信息。它的好处是会在每条信息前添加工作流实例的ID。

<registers>
  <register type="class" variable-name="log">
    <arg name="class.name">
      com.opensymphony.workflow.util.LogRegister
    </arg>
    <arg name="addInstanceId">true</arg>
    <arg name="Category">workflow</arg>
  </register>
</registers>

这样我们定义了一个可用的“log”变量,可以通过其他的pre-function的脚本里面使用它:

<function type="beanshell">
  <arg name="script">transientVars.get("log").info("executing action 2")</arg>
</function>

日志输出将会在前面添加工作流实例的ID

h3 结论

这个教程的目的是希望可以阐明一些主要的osworkflow概念。你还可以通过API和流程定义格式去获取更多的信息。有一些更高级的特性没有在此提到,比如splits 分支、joins 连接, nested conditions 复合条件、auto stpes 自动步骤等等。你可以通过阅读手册来获得更进一步的理解。

如果你遇到任何的困难,可以在osworkflow的email list上询问。

数据库系统概论学习笔记(二):更多的概念

其实这还是概念(关系数据库)

Delegate 类 概念 与MVC模式不同,model/view结构没有用于与用户交互的完全独立的组件。一般来讲, view负责把数据展示给用户,也处理用户的输入。为了获得更多的灵性性,交互通过d

阿达
  • dwhghw
  • dwhghw
  • 2016年08月08日 15:57
  • 909

支持下拉刷新和上划加载更多的自定义RecyclerView(仿XListView效果)

在项目更新的过程中,遇到了一个将XListView换成recyclerView的需求,而且更换完之后大体效果不能变,但是对于下拉刷新这样的效果,谷歌给出的解决方案是把RecyclerView放在一个S...

SwipeRefreshLayout+RecyclerView 完成下拉刷新,上拉加载更多的自定义控件,简单好用

下拉刷新,上拉加载更多在许多应用中都频频用到,特别是需要分页加载数据时.之前在项目中经常用到的是网上非常普遍的PullToRefreshLayout.该框架比较好用,不过是比较旧了.就想着重新找一个控...
  • wzhseu
  • wzhseu
  • 2016年12月06日 14:18
  • 458

YRecyclerView自定义下拉刷新上拉加载更多的RecyclerView

不可描述
  • YYXXLL2
  • YYXXLL2
  • 2016年09月23日 13:25
  • 281

Android 自定义一个可以展开显示更多的文本布局

在查阅其他博主的博文中,发现了一个比较不错的文本伸展的效果,在此借鉴学习。可以先看看到底是什么样的效果 看起来很眼熟吧,很多应用中都有这样的使用场景,其实就是控制textview的m...
  • jdsjlzx
  • jdsjlzx
  • 2016年01月31日 22:08
  • 3181

利用MAVEN打包时,如何包含更多的资源文件

首先,来看下MAVENx项目标准的目录结构: 一般情况下,我们用到的资源文件(各种xml,properites,xsd文件等)都放在src/main/resources下面,利用maven打包时,ma...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:更多的流程定义描述符概念
举报原因:
原因补充:

(最多只允许输入30个字)