act_ge_property详解

一、概述

act_ge_property 表是 Activiti 引擎的核心数据表之一，主要用于存储引擎的属性配置信息，例如数据库版本号、对于流程和任务的编号生成方式、查询方言、历史数据清理策略等等。

act_ge_property 表是 Activiti 引擎的公共配置表，全局唯一。

二、Schema

表结构

+-----------------+--------------+------+-----+---------+-------+
| Field           | Type         | Null | Key | Default | Extra |
+-----------------+--------------+------+-----+---------+-------+
| NAME_           | varchar(255) | NO   | PRI | NULL    |       |
| REV_            | int(11)      | NO   |     | NULL    |       |
| VALUE_          | varchar(255) | YES  |     | NULL    |       |
| VALUE_BLOB_     | blob         | YES  |     | NULL    |       |
| DEPLOYMENT_ID_  | varchar(64)  | YES  |     | NULL    |       |
+-----------------+--------------+------+-----+---------+-------+

字段说明

NAME_：

该属性的名称。名字必须在 Activiti 引擎中唯一。在代码中，使用该属性必须 specified by a static field ，最好在类开头定义。

REV_ ：

版本号，每当更改 VALUE_ 或 VALUE_BLOB_ 时增加。可避免并发更新此值的问题，同时也使在数据迁移期间将属性更改为会产生新版本的属性（具有不同的元版本）变得可能。Rev 值遵循规则：2 REV 值相同的属性必须具有相同的值。

DEPLOYMENT_ID_：

引用的部署，该属性与特定部署相关联。例如，查询方言可能会有不同的部署。为了与实际部署相关的属性，一个实例必须与部署关联。如果特定属性属于特定部署，则此列将包含指向确切部署的指针。如果该属性为全局配置，则该列将显式设为空。

VALUE_：

属性值。如果数据太大，则在VALUE_BLOB_列中存储。

VALUE_BLOB_：

大冗长 / 二进制值的透明存储机制。例如，这是 XML 的嵌入式模型数据。

三、数据字典清单

下面，我们来逐一解析每个数据字典：

1. NAME_

描述

该属性的名称。

取值范围

varchar(255)

是否唯一

是

是否可以为空：

否

示例

public static final String DB_SCHEMA_UPDATE = "schema.update";
public static final String DB_SCHEMA_UPDATE_HISTORY = "schema.history";
public static final String PROCESS_DEFINITIONS_CACHE = "process.definitions.cache";
...

2. REV_

描述

版本号。

取值范围

int(11)

是否唯一

否

是否可以为空

否

示例

int DATABASE_SCHEMA_UPDATE_VERSION = 7;
int ACTIVITI_VERSION_MAJOR = 7;
int ACTIVITI_VERSION_MINOR = 0;
...

3. VALUE_

描述

属性值。

取值范围

varchar(255)

是否唯一

否

是否可以为空

是

示例

updateSchema()
createSchema()
selectOneTaskVariable()
...

4. VALUE_BLOB_

描述

大冗长/二进制值的透明存储机制。

取值范围

blob

是否唯一

否

是否可以为空

是

示例

暂无示例。

5. DEPLOYMENT_ID_

描述

引用的部署。

取值范围

varchar(64)

是否唯一

否

是否可以为空

是

示例

DeploymentBuilder deploymentBuilder = repositoryService.createDeployment().addClasspathResource("processes/myProcess.bpmn").deploymentProperty("deploymentName", "deploymentOne");

四、常见用法

1. 查询数据库版本信息

查询之前，要先获取到ProcessEngine对象：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

通过ProcessEngine对象获取到RepositoryService对象，并调用getRepositoryService对象中的getProperties方法获取act_ge_property表中的数据库版本信息。

RepositoryService repositoryService = processEngine.getRepositoryService();
List properties = repositoryService.getDeploymentProperties("", DATABASE_TYPE_PROPERTY);

2. 查询任务表中一个任务属性的值

查询之前，要先获取到ProcessEngine对象：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

通过ProcessEngine对象获取到TaskService对象，并调用getVariable方法获取act_ge_property表中的任务属性对应的值。

TaskService taskService = processEngine.getTaskService();
String businessKey = (String) taskService.getVariable(taskId, "businessKey");

3. 更新任务表中一个任务属性的值

更新之前，要先获取到ProcessEngine对象：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

通过ProcessEngine对象获取到TaskService对象，并调用setVariable方法更新act_ge_property表中的任务属性对应的值。

TaskService taskService = processEngine.getTaskService();
taskService.setVariable(taskId, "businessKey", "newBusinessKey");

五、总结

在 Activiti 的架构里，act_ge_property 表是非常重要的一张表。我们可以通过 act_ge_property 表存储引擎的属性配置信息，例如数据库版本号、对于流程和任务的编号生成方式、查询方言、历史数据清理策略等等。

通过本文的介绍，我们了解了 act_ge_property 表的含义、结构和常见用法，这对需要使用 Activiti 引擎进行开发的开发者来说是非常有帮助的。