Activiti 5.4 用户指南中文版：快速入门和配置指南

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

Activiti 5.4 用户指南（中文版） Activiti 5.4 用户指南（中文版）是一本详细的用户手册，涵盖了 Activiti 5.4 的各个方面。以下是根据手册的内容生成的知识点： ** Activiti 简介 ** Activiti 是一个开源的业务流程管理系统（BPM），提供了强大的流程引擎和工作流引擎。Activiti 5.4 是 Activiti 的一个版本，提供了许多新的特性和改进。 ** 许可和下载 ** Activiti 5.4 提供了多种许可证，包括 Apache 许可证和 GNU 许可证。用户可以根据需要选择合适的许可证。Activiti 5.4 的下载地址是 activiti.org。 ** 源码和所需软件 ** Activiti 5.4 的源码可以在 GitHub 上下载。Activiti 5.4 需要 JDK 5+、Ant 1.8.1+ 和 Eclipse 3.6.2 以上的软件支持。 ** 报告问题和试验性的特性 ** 用户可以通过 Activiti 的社区论坛报告问题和反馈意见。Activiti 5.4 还提供了许多试验性的特性，例如流程虚拟机（PVM）API。 ** 开始使用 Activiti ** 用户可以通过一分钟版快速开始使用 Activiti。Activiti 提供了演示设置和 workspace 文件夹下的示例项目。 ** 配置和数据库 ** Activiti 5.4 提供了多种配置选项，例如创建 ProcessEngine、ProcessEngineConfiguration bean 和数据库配置。Activiti 5.4 支持多种数据库，例如 Oracle、MySQL 和 PostgreSQL。 ** Spring 的集成 ** Activiti 5.4 提供了 Spring 的集成，例如 ProcessEngineFactoryBean 和事务支持。Activiti 5.4 还提供了表达式和自动资源部署。 ** API 和单元测试 ** Activiti 5.4 提供了多种 API，例如引擎 API 和流程虚拟机（PVM）API。Activiti 5.4 还提供了单元测试支持，例如 JUnit。 ** 部署和流程定义 ** Activiti 5.4 提供了多种部署选项，例如使用 ActivitiProbe 部署和编程式部署。Activiti 5.4 还提供了流程定义的版本控制和流程图生成。 ** BPMN 和流程定义 ** Activiti 5.4 支持 BPMN 2.0 规范，提供了流程定义和流程图生成。Activiti 5.4 还提供了 BPMN 示例和入门指南。 Activiti 5.4 用户指南（中文版）是一本详细的用户手册，涵盖了 Activiti 5.4 的各个方面，帮助用户快速开始使用 Activiti 5.4。

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

第三章、配置

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页未读，继续阅读

fcl_lingzi

粉丝: 0
资源: 5

Activiti 5.4 用户指南中文版：快速入门和配置指南

Activiti 5.4 用户指南：从入门到配置详解

Activiti 5.4用户指南：从入门到配置与集成

Activiti5.4中文指南：从入门到精通

Activiti5.4 用户指南-中文版

Activiti5.4 用户指南（中文版）

Activiti5.4 用户指南（中文版）良心版

Activiti 5.4 用户指南

Activiti5.4 用户指南

Activiti5.4 用户指南（中文版） .pdf

Activiti 5.4 用户指南（中文版） .pdf

最新资源