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 引擎进行开发的开发者来说是非常有帮助的。
