Activiti 5.8 中文用户手册：入门与配置指南

需积分: 10 40 浏览量更新于2024-07-24 收藏 3.42MB PDF 举报

"Activiti_5.8_用户指南(中文版)" 是一本关于Activiti 5.8的中文用户手册，旨在帮助读者理解和使用这个开源工作流引擎。手册覆盖了从入门到高级特性的详细内容，包括Activiti的安装、配置、Spring集成、API使用、流程部署以及BPMN标准的解释。一、简介 1.1 许可: Activiti遵循Apache 2.0许可协议，允许用户免费使用和修改源代码。 1.2 下载: 用户可以从官方网站或其他可信源下载Activiti 5.8的发行版。 1.3 源码: 开源的Activiti允许用户获取并研究其源代码，以适应特定需求或进行定制开发。 1.4 所需软件: 运行和开发Activiti需要JDK 5或更高版本，Ant 1.8.1+，以及Eclipse 3.6.2。 1.5 报告问题: 用户可以通过指定的渠道报告遇到的问题，参与到社区支持和改进中。 1.6 试验性特性: Activiti可能包含一些正在测试的特性，用户应谨慎使用。二、入门 2.1 一分钟版: 快速了解如何安装和运行Activiti的基础步骤。 2.2 演示设置: 提供一个快速的环境配置示例，以便用户能够立即开始试验。 2.3 示例项目: 提供的workspace文件夹内包含示例项目，帮助用户理解Activiti的用法。 2.4 类库依赖: 阐述了运行和开发Activiti所需的相关依赖库。 2.5 Eclipse设置: 指导用户如何在Eclipse中配置项目以便开发Activiti应用。 2.6 查看数据库: 解释如何检查数据库中的流程状态和数据。 2.7 数据库表的命名说明: 介绍Activiti在数据库中使用的表名和结构。三、配置 3.1 创建ProcessEngine: 描述如何初始化和配置流程引擎，这是使用Activiti的第一步。 3.2 ProcessEngineConfiguration bean: 说明如何通过bean配置流程引擎的详细设置。 3.3 数据库配置: 阐述如何连接到数据库并配置相关的连接参数。 3.4 作业执行器的激活: 介绍如何启用后台任务执行，如定时器和消息事件。 3.5 邮件服务器的配置: 解释如何设置邮件通知，以便在流程中发送邮件。 3.6 历史的配置: 详述如何配置历史记录以保存流程实例的审计日志。 3.7 公布配置的beans: 在表达式和脚本中如何使用应用的其他beans。 3.8 支持的数据库: 列出Activiti兼容的数据库类型。 3.9 创建数据库表: 解释如何自动生成或更新流程引擎所需的数据库表。 3.10 数据库更新: 提供了数据库表升级的指导。四、Spring的集成 4.1 ProcessEngineFactoryBean: 展示如何在Spring应用中创建和管理ProcessEngine。 4.2 事务: 说明Activiti如何与Spring的事务管理相结合。 4.3 表达式: 介绍在流程定义中使用表达式来控制流程行为。 4.4 自动资源部署: 如何配置Activiti自动部署流程定义文件。 4.5 单元测试: 提供使用Activiti进行单元测试的方法和最佳实践。 4.6 流程引擎在Web应用程序中的使用: 说明如何在Web环境中集成和使用Activiti。五、API 5.1 引擎API: 详述了Activiti提供的主要API接口，用于操作流程实例、任务、变量等。 5.2 异常策略: 介绍处理流程运行时异常的方法。 5.3 单元测试: 提供编写和运行针对Activiti的单元测试的指南。 5.4 调试单元测试: 教程如何有效地调试与Activiti相关的测试。 5.5 web应用程序中的工作流引擎: 解释如何在Web应用中嵌入和管理工作流引擎。 5.6 流程虚拟机（PVM）API: 描述了流程虚拟机的底层运行机制。 5.7 表达式: 进一步探讨如何在流程中使用表达式语言。六、部署 6.1 业务归档文件: 说明流程定义文件（.bpmn20.xml）的作用和部署方式。 6.1.1 编程式部署: 如何通过API动态部署流程定义。 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的独立可执行应用程序。 6.3 流程定义的版本: 管理流程定义的不同版本，允许升级和回滚。 6.4 提供流程图: 如何显示和导出流程图以供分析和审查。 6.5 生成流程图: 解释如何从流程定义文件生成可视化流程图。七、BPMN 7.1 BPMN是什么: 简介Business Process Model and Notation (BPMN)标准及其用途。 7.2 示例: 提供BPMN元素的实例，帮助理解其用法。 7.3 定义流程: 详细解释如何使用BPMN符号创建流程模型。 7.4 入门：10分钟指南: 一个快速教程，引导用户开始创建和理解BPMN流程。 7.4.1 先决条件: 需要的基本知识和工具。 7.4.2 目标: 学习创建简单流程的目标。 7.4.3 用例: 描述一个简单的业务场景作为练习。 7.4.4 流程图: 逐步绘制流程图的过程。 7.4.5 XML的描述: 与流程图对应的XML代码结构。 7.4.6 启动流程实例: 如何通过API或用户界面启动基于BPMN的流程。这本用户指南全面涵盖了Activiti 5.8的各个方面，是开发者和流程管理员深入了解和使用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页未读，继续阅读

风过无痕0103

粉丝: 0
资源: 8

Activiti 5.8 中文用户手册：入门与配置指南

Activiti_5.8_用户指南中文版

中文版Activiti5.8用户指南

Activiti 5.8中文版用户指南：快速入门与配置详解

Activiti 5.8 用户指南

Activiti 5.8 用户指南（中文版）

Activiti 5.8 中文用户指南：入门与配置

Activiti5.8中文用户手册速查指南

Activiti 5.8 中文用户指南详解与API深度解析

Activiti5.8 BPMN流程管理实战指南

Activiti5.8中文完全指南：用户手册翻译

最新资源