Activiti5.8中文用户手册：入门与配置指南

PDF文件

下载需积分: 10 | 3.42MB | 更新于2024-07-21 | 179 浏览量 | 举报 1 收藏

立即下载

"activiti文档" 本文档是关于Activiti的中文用户手册，涵盖了从入门到高级使用的多个方面，包括许可信息、系统需求、配置、Spring集成、API介绍、部署流程以及BPMN标准的详细解释。一、简介 1.1 许可：Activiti遵循特定的许可协议，允许用户在合规条件下使用、修改和分发该开源工作流引擎。 1.2 下载：用户可以从官方网站或其他可信源获取Activiti的最新版本。 1.3 源码：对于开发者，可以访问源代码并参与贡献或自定义开发。 1.4 所需软件： Activiti需要JDK 5或更高版本，Ant 1.8.1或以上，以及Eclipse 3.6.2或更高版本。 1.5 报告问题：鼓励用户在遇到问题时通过官方渠道提交报告。 1.6 试验性特性：某些功能可能标记为实验性质，不稳定，需谨慎使用。 1.7 内部实现类：手册指出，某些类是内部实现细节，不建议直接使用。二、入门 2.1 一分钟版：快速了解如何启动和运行Activiti的基本步骤。 2.2 演示设置：提供了快速建立开发环境的指导。 2.3 示例项目：在workspace文件夹下包含示例流程，供学习参考。 2.4 类库依赖：列出了Activiti运行所依赖的外部库。 2.5 Eclipse设置：指导如何配置Eclipse开发环境。 2.6 查看数据库：讲解如何观察数据库中流程的状态和数据。 2.7 数据库表的命名说明：解释了Activiti在数据库中创建的表及其含义。三、配置 3.1 创建ProcessEngine：说明如何初始化和配置流程引擎。 3.2 ProcessEngineConfiguration bean：详述用于配置流程引擎的bean。 3.3 数据库配置：指导如何设置数据库连接和相关参数。 3.4 作业执行器的激活：配置定时任务执行器以处理异步任务。 3.5 邮件服务器的配置：教用户如何配置Activiti发送电子邮件。 3.6 历史的配置：关于记录和查询历史流程实例的设置。 3.7 在表达式、脚本中公布配置的beans：允许在流程中引用Spring beans。 3.8 支持的数据库：列出了Activiti支持的数据库类型。 3.9 创建数据库表：初始化数据库表的步骤。 3.10 数据库更新：当升级Activiti版本时，如何更新数据库。四、Spring的集成 4.1 ProcessEngineFactoryBean：在Spring环境中创建和管理流程引擎的方法。 4.2 事务：讨论Activiti与Spring事务管理的集成。 4.3 表达式：说明如何在流程定义中使用表达式语言。 4.4 自动资源部署：配置Activiti自动部署流程定义文件。 4.5 单元测试：指导如何编写和运行针对Activiti的单元测试。五、API 5.1 引擎API：介绍Activiti的核心API接口及其使用方法。 5.2 异常策略：解释了流程执行过程中异常处理的策略。 5.3 单元测试：详细阐述如何对Activiti相关代码进行单元测试。 5.4 调试单元测试：提供调试单元测试的技巧和方法。 5.5 web应用程序中的工作流引擎：指导如何在Web应用中集成Activiti。 5.6 流程虚拟机（PVM）API：深入理解流程执行的底层模型。 5.7 表达式：进一步探讨表达式语言在流程定义中的应用。六、部署 6.1 业务归档文件：描述了流程部署的各种方式。 6.1.1 编程式部署：通过代码部署流程定义。 6.1.2 使用ant部署：利用Ant构建工具自动化部署。 6.1.3 使用ActivitiExplorer部署：通过图形界面工具部署。 6.2 外部资源：讲解如何关联流程定义中的外部资源，如Java类和Spring beans。 6.2.1 Java类：在流程中调用Java方法。 6.2.2 使用Spring beans：集成Spring服务到流程实例中。 6.2.3 创建独立应用：构建不依赖Activiti Explorer的独立应用。 6.3 流程定义的版本：如何管理流程定义的不同版本。 6.4 提供流程图：展示流程图给用户查看。 6.5 生成流程图：说明如何自动生成流程图来可视化流程定义。七、BPMN 7.1 BPMN是什么：解释Business Process Modeling Notation (BPMN)标准的作用和重要性。 7.2 示例：通过具体例子展示BPMN符号的使用。 7.3 定义流程：介绍如何使用BPMN元素构建业务流程。 7.4 入门：10分钟指南：快速上手BPMN和Activiti的教程。 7.4.1 先决条件：列出开始学习BPMN所需的预备知识。 7.4.2 目标：阐明学习目标。 7.4.3 用例：提供一个实际的应用场景。 7.4.4 流程图：展示一个简单的BPMN流程图示例。 7.4.5 XML的描述：解释流程定义的XML表示。 7.4.6 启动流程实例：说明如何启动基于BPMN的流程实例。通过这份中文用户手册，开发者和业务分析师能够深入了解Activiti的工作原理，有效地利用其功能来设计、部署和管理业务流程。

小觑夜漫酒作伴，破晓黎明当笑言

第三章、配置

3.1

创建

ProcessEngine

Activiti 流程引擎是通过 acitiviti.cfg.xml 文件进行配置的。注意，这不适用于使用 Spring 构建流程引擎的情况。

获得 ProcessEngine 最简单的方式是使用 org.activiti.engine.ProcessEngines 类：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine()

它会查找类路径下的 activiti.cfg.xml 文件，然后根据文件中的配置构建引擎。下面的片段展示了一个示例配置。下一节将

对配置属性做详细的介绍。

<beansxmlns="http://www.springframework.org/schema/beans"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://www.springframework.org/schema/beans

http://www.springframework.org/schema/beans/spring-beans.xsd">

<beanid="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">

<propertyname="jdbcUrl"value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000"/>

<propertyname="jdbcDriver"value="org.h2.Driver"/>

<propertyname="jdbcUsername"value="sa"/>

<propertyname="jdbcPassword"value=""/>

<propertyname="databaseSchemaUpdate"value="true"/>

<propertyname="jobExecutorActivate"value="false"/>

<propertyname="mailServerHost"value="mail.my-corp.com"/>

<propertyname="mailServerPort"value="5025"/>

</bean>

</beans>

注意该 xml 配置文件实际上是一个 Spring 配置文件。

这并不意味着

Activiti

只能在

Spring

环境下使用！

我们只是利用 Spring

的解析和依赖注入能力来构建引擎。

也可以以编程的方式使用配置文件创建 PrcessEngineConfiguration 对象。也可以使用 bean 的 id（例子，见第 3 行）。

ProcessEngineConfiguration.createProcessEngineConfigurationFromResourceDefault();

ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource);

ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(String resource, String beanName);

ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(InputStream inputStream);

ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(InputStream inputStream, String beanName);

也可以不使用配置文件，创建默认的配置对象（更多信息，参看所支持的其它类）。

小觑夜漫酒作伴，破晓黎明当笑言

ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();

ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration();

所有这些 ProcessEngineConfiguration.createXXX()方法都会返回 ProcessEngineConfiguration 对象，可以进一步对其做必要的

调整。调用 buildProcessEngine()方法后，会创建一个 ProcessEngine：

ProcessEngine processEngine = ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration()

.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_FALSE)

.setJdbcUrl("jdbc:h2:mem:my-own-db;DB_CLOSE_DELAY=1000")

.setJobExecutorActivate(true)

.buildProcessEngine();

3.2 ProcessEngineConfiguration bean

activiti.cfg.xml 文件内必须包含一个 id 为’ processEngineConfiguration’的 bean。

<beanid="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">

这个 bean 接下来被用来构造 ProcessEngine。存在多个可用于定义 processEngineConfiguration 的类。这些类代表着不同的

环境，有相应的默认设置。最好选择（最）适合你环境的那个类，这样会尽量减小需要配置流程引擎属性的数量。以下

是目前可用的类（将来可能会更多）：

 org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration：此流程引擎用于独立环境下。Acitviti 会处理事务。

默认，只在该引擎启动时检查数据库（不存在 Activiti 数据库模式或模式版本不合适都会抛出异常）。

 org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration：这是一个方便单元测试的类。Acitviti 会处理

事务。默认使用 H2 内存数据库。此数据库在流程引擎启动与关闭时进行创建和删除。使用这个类时，可能不需要进

行额外的配置（除了在使用作业执行器（job executor）或邮件功能时）。

 org.activiti.spring.SpringProcessEngineConfiguration：Spring 环境下使用流程引擎的情况下使用。更多信息，参看

Spring

集成一节。

 org.activiti.engine.impl.cfg.JtaProcessEngineConfiguration：（[试验性的]）使用 JTA 事务，以独立模式运行的流程引擎

的环境下使用。

3.3

数据库配置

有两种方式来配置 Activiti 引擎使用的数据库。第一个选择就是定义数据库的 jdbc 属性：

 jdbcUrl：数据库的 jdbc url。

 jdbcDriver：特定数据库类型驱动的实现。

 jdbcUsername：连接数据库的用户名。

 jdbcPassword：连接数据库的密码。

根据提供的 jdbc 属性创建的 datasource 使用默认配置的 MyBatis 连接池。可以选择性地设置以下属性来调整连接池（出

自 MyBatis 文档）：

小觑夜漫酒作伴，破晓黎明当笑言

 jdbcMaxActiveConnections：任何时候连接池所包含有效连接的最大个数。默认是 10。

 jdbcMaxIdleConnections：任何时候连接池所包含闲置连接的最大个数。

 jdbcMaxCheckoutTime：连接从连接池‘检出’到真正获取到之间的毫秒数。默认为 20000（20 秒）。

 jdbcMaxWaitTime：这是一个低层次的设置，当一个连接占用了过长时间，它让连接池有机会打印日志，并重新

尝试获取连接

（以避免如果误配了连接池，发生永久性失败）。默认为 20000（20 秒）。

数据库配置的示例：

<propertyname="jdbcUrl"value="jdbc:h2:mem:activiti;DB_CLOSE_DELAY=1000"/>

<propertyname="jdbcDriver"value="org.h2.Driver"/>

<propertyname="jdbcUsername"value="sa"/>

<propertyname="jdbcPassword"value=""/>

或者，可以使用 javax.sql.DataSource 的实现（例如，Apache Commons 的 DBCP）：

<beanid="dataSource"class="org.apache.commons.dbcp.BasicDataSource">

<propertyname="driverClassName"value="com.mysql.jdbc.Driver"/>

<propertyname="url"value="jdbc:mysql://localhost:3306/activiti"/>

<propertyname="username"value="activiti"/>

<propertyname="password"value="activiti"/>

<propertyname="defaultAutoCommit"value="false"/>

</bean>

<beanid="processEngineConfiguration"class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">

<propertyname="dataSource"ref="dataSource"/>

...

注意，Activiti 中没有包含支持 datasource 的类库。所以你必须要确保类路径下存在那些类库（比如，DBCP）。

不管是使用 jdbc 还是 datasource，都可以设置以下属性：

 databaseType：一般不需要指定这个属性，因为引擎自动会从数据库连接元数据分析得到。只在为防止万一自

动检测失败时指定。可能的值有：{h2, mysql, oracle, postgrs, mssql, db2}。

在不使用默认的

数据库时，这个属

性是必须的

。该设置决定了使用哪种 create/drop 脚本和查询。（译注，这句话的意思是，使用哪种数据风格的

DML、DCL）见‘支持的数据库’一节来查看支持哪种数据库。

 databaseSchemaUpdate：允许在流程引擎启动和关闭时设置处理数据库模式的策略。

 false（默认）：创建流程引擎时检查数据库模式的版本是否与类库匹配，如果版本不匹配就会抛出异常。

 true：构建流程引擎时，执行检查，如果有必要会更新数据库模式。如果数据库模式不存在，就创建一个。

 create-drop：创建流程引擎时创建数据库模式，关闭流程引擎时删除数据库模式。

3.4

作业执行器的激活

JobExecutor 是管理触发定时器线程的组件（以及接下来介绍的异步消息）。进行单元测试时，处理多线程是很多余的。因

此该 API 允许对作业（jobs）进行查询（ManagementService.createJobQuery）和执行（ManagementService.executeJob），

这样一来就可以在单元测试中控制作业的执行了。要想避免该作业执行器接口，可以将其关闭。

默认，JobExecutor 在流程引擎启动时被激活。当不想让 JobExecutor 在流程引擎启动时被激活，指定

小觑夜漫酒作伴，破晓黎明当笑言

 添加适当的数据库驱动

 添加 Activiti 的配置文件（activiti.cfg.xml）到你的 classpath 下，配置文件指向你的数据库（见数据库配置一节）

 执行 DbSchemaCreate 类的 main 方法

然而，通常只有数据库管理员才能够在数据库上执行 DDL 语句。此 DDL 的 SQL 语句可以在 Activiti 引擎的 jar 文件

（activiti-engine-x.jar）中的 org/activiti/db/create 包（drop 文件夹包含了 dorp 语句）找到。sql 文件的格式为

activiti.{db}.{create|drop}.{type}.sql

其中 db 是任何所支持的数据库，type 为

 engine

：

引擎执行所需的表。必需的。

 identity

：

可选表，在使用随引擎分发的默认 identity 管理时使用。

 history

：

包含历史和审核信息。可选：当历史级别设置为 none 时不需要。

3.10

数据库更新

[

试验性的

]

对于更新的完整测试我们还没有充分的信心。这就是为什么我们将其标记为试验性的原因。在运行更新前，确保将数据

库进行了备份（利用你数据库的备份能力）。

默认，每次创建流程引擎时都会执行版本的检查。这一般发生在你的应用程序或 Activiti web 应用启动的时候。如果 Activiti

的类库发现类库的版本与 Activiti 数据库表的版本不一样，就会抛出异常。

要想更新，必须在你的 activiti.cfg.xml 配置文件配置以下配置属性：

<beans... >

<beanid="processEngineConfiguration"

class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">

<propertyname="databaseSchemaUpdate"value="true"/>

</bean>

</beans>

同时，将与你的数据库相适应的数据库驱动置于

classpath

下。

更新你的应用程序下的 Activiti 类库。或者启动新版本的

Activiti，然后将它指到包含老版本的数据库。databaseSchemaUpdate 为 true 时，Activiti 会在第一次发现其类库与数据库

模式不同步时自动将数据库模式更新到一个比较新的版本。

剩余169页未读，继续阅读

ksf博客

粉丝: 3

Activiti5.8中文用户手册：入门与配置指南

工作流activiti文档

activiti中文文档

activiti 文档

Activiti文档代码基于SpringBoot

SpringBoot下的Activiti文档代码实践指南

jQueryUI与Activiti文档开发包下载指南

activiti 学习文档

activiti调研文档

activiti学习文档

activiti帮助文档

最新资源