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

需积分: 17 103 浏览量更新于2024-07-19 1 收藏 4.2MB PDF 举报

"Activiti中文版用户手册" Activiti 是一个流行的工作流和业务流程管理（BPM）系统，它基于模型驱动的架构，适用于企业级应用。本手册是Activiti 5.4的中文版，由栗建涛翻译，为用户提供了详细的操作指南。在第一章"简介"中，提到了Activiti的许可信息，它遵循Apache 2.0许可证，允许免费使用和分发。此外，你可以从官方网站下载最新版本，并了解到项目源码托管在GitHub上。要运行Activiti，需要准备JDK 5或更高版本、Ant 1.8.1及以上以及Eclipse 3.6.2。如果遇到问题，可以通过官方渠道报告。本章还提到实验性特性和内部实现类的注意事项。第二章"开始"介绍了快速启动Activiti的步骤，包括一分钟快速启动指南，演示环境的设置，如何查看workspace文件夹下的示例项目，理解依赖库，以及在Eclipse中的配置。此外，还讲解了如何查看数据库内容和了解数据库表的命名规则。第三章"配置"详述了创建ProcessEngine的过程，以及ProcessEngineConfiguration bean的配置。数据库配置包括连接信息，作业执行器（Jobexecutor）的激活用于定时任务，邮件服务器的配置支持流程通知，历史配置则涉及流程历史数据的存储。本章还讨论了如何公布配置的beans用于表达式和脚本，以及Activiti支持的数据库类型和数据库的修改方法，如下载Oracle驱动和执行数据库更新脚本。第四章"Spring的集成"说明了如何在Spring应用中使用Activiti，包括ProcessEngineFactoryBean的使用，事务管理，表达式支持，自动资源部署以简化应用开发，以及如何进行单元测试。第五章"API"涵盖了引擎API的详细信息，如异常策略，单元测试的执行，调试技巧，以及在Web应用中集成工作流引擎。流程虚拟机（PVM）API和表达式的使用也在此部分进行深入讨论。第六章"部署"讲解了不同方式部署业务归档文件，包括Activiti Probe工具，编程式部署，以及通过Ant脚本部署。此外，介绍了如何处理外部资源，如Java类，Spring beans的注入，创建独立应用的方法，流程定义的版本控制，以及流程图的查看和生成。第七章"BPMN"深入探讨了Business Process Modeling Notation（业务流程建模符号），包括其基本概念、示例流程图，以及如何定义和入门BPMN，指导用户在10分钟内了解并开始创建BPMN流程。综上，Activiti中文版用户手册为开发者提供了全面的指导，从安装配置到实际操作，再到深入的API理解和BPMN流程设计，覆盖了使用Activiti进行业务流程管理的各个层面。

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

第三章、配置

3.1

创建

ProcessEngine

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

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

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine()

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

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

<beans xmlns="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">

</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。

接下来使用这个 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 使用默认配置的 MyBatic 连接池。可以选择性地设置以下属性来调整连接池（出

自 MyBatis 文档）：

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

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

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

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

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

尝试获取连接

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

数据库配置的示例：

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

</bean>

...

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

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

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

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

在不使用默认的

数据库时，这个属

性是必须的

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

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

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

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

常。

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

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

3.4

作业执行器的（

Job executor

）激活

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

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

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

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

 编辑 setup/build.${db}.propertyies，将 JDBC 连接参数修改成你安装的数据库的参数。

要想根据你在 build.*.properties 文件指定的属性来创建数据的配置文件，请在 setup 文件内运行（译注，指的是将命令行

窗体导航到此文件夹）

ant cfg.create

可以在 setup/build/activti.cfg 内找到生成的配置文件。同时，方便起见，可以在 setup/build 下找到包含了配置文件的 jar

文件 activiti-cfg.jar。

如果想要在另一个数据库上运行演示设置，首先要使用

ant demo.stop demo.clean demo.start

来结束演示设置。然后使用

ant demo.clean demo.start

将演示设置进行清理、重启。

3.10

下载

Oracle

驱动

当你要运行使用 oracle 作为数据源的演示设置时，在调用 ant 任务 demo.start 前，要进行额外的一步操作。

 许可的原因，我们没有再发布 Oracle JDBC 的驱动，你需要自行下载：

http://www.oracle.com/technetwork/database/enterprise-edition/jdbc-112010-090769.html。确保你下载的是

ojdbc5.jar（我们是在 10g ojdbc 上使用 11.2.0.1 进行的测试）。

 将下载的 ojdbc5.jar 复制到 setup/files/dependencies/libs/。确保其文件名为‘ojdbc5.jar’以便被 Activiti 的演示

安装程序找到（例如，从 maven repo 获取该驱动程序）。

3.11

数据库更新

[

试验性的

]

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

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

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

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

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

<bean id="processEngineConfiguration"

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

剩余180页未读，继续阅读

guan_1989

粉丝: 0
资源: 5

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

activiti-6.0 官网

activiti中文api（用户手册）

Activiti6.0下载

Activiti汉化文件

Activiti 5.22.0版本Demo代码

activiti

Activiti

activiti6.0汉化版的patch包

Activiti5.15中文版操作手册

activiti中文api

最新资源