数据库设计与数据初始化
导读
「数据库设计与数据初始化」的回答要点集中在下面几节,建议先记住结论再看推导过程。
这一篇给出完整的表清单、关键表结构、jBPM 系统表说明,以及演示数据是怎么灌进去的。
一、表清单
业务表统一 T_ 前缀,共 18 张:
| 表 | 对应实体 | 说明 |
|---|---|---|
T_Organization |
Organization |
机构(自关联树,含 pid、sn) |
T_Person |
Person |
人员 |
T_User |
User |
登录账号 |
T_Role |
Role |
角色 |
T_UsersRoles |
UsersRoles |
用户-角色关联(含 orderNo 优先级) |
T_Module |
Module |
受控模块(含 sn、url、orderNo) |
T_ACL |
ACL |
授权记录 |
T_Workflow |
Workflow |
流程定义(XML + 流程图二进制) |
T_Document |
Document |
公文 |
T_Document_Properties |
DocumentProperty |
公文动态属性值 |
T_ApproveInfo |
ApproveInfo |
审批意见 |
T_FlowForm |
FlowForm |
流程表单 |
T_FormField |
FormField |
表单域 |
T_FieldType |
FieldType |
字段数据类型 |
T_FieldInput |
FieldInput |
字段输入形式 |
T_FieldItem |
FieldItem |
下拉/单选候选项 |
T_MeetingRoom |
MeetingRoom |
会议室 |
T_MeetingRoomApply |
MeetingRoomApply |
会议室申请 |
表结构由
hbm2ddl.auto=update自动生成,字段名与实体属性一致,外键列名由 Hibernate 默认规则生成(parent→pid,org→orgId等),如需固定列名请在 XDoclet 注释里显式写column="..."。
二、关键表结构
2.1 T_Organization(机构树)
CREATE TABLE T_Organization (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(255),
sn VARCHAR(255), -- 路径,如 '1_3_7'
description VARCHAR(255),
pid INT -- 父机构 id,顶级为 NULL
);
| id | name | pid | sn |
|---|---|---|---|
| 1 | 总公司 | NULL | 1 |
| 3 | 研发部 | 1 | 1_3 |
| 7 | 一组 | 3 | 1_3_7 |
2.2 T_ACL(授权)
CREATE TABLE T_ACL (
id INT PRIMARY KEY AUTO_INCREMENT,
principalType VARCHAR(255) NOT NULL, -- 'User' 或 'Role'
principalSn INT NOT NULL, -- 用户 id 或角色 id
resourceSn INT NOT NULL, -- 模块 id
aclState INT NOT NULL, -- 权限位:1增 2查 4改 8删
aclTriState INT NOT NULL -- 0:不继承;-1(0xFFFFFFFF):继承
);
示例数据解读:
| principalType | principalSn | resourceSn | aclState | aclTriState | 含义 |
|---|---|---|---|---|---|
| Role | 2 | 20 | 15 | 0 | 角色 2 对模块 20 有全部权限 |
| Role | 2 | 21 | 2 | 0 | 角色 2 对模块 21 只有读权限 |
| User | 5 | 20 | 15 | 0 | 用户 5 直接被授予模块 20 全权限(覆盖角色) |
| User | 5 | 21 | 0 | -1 | 用户 5 对模块 21 不表态,继承角色授权 |
2.3 T_Document 与 T_Document_Properties
CREATE TABLE T_Document (
id INT PRIMARY KEY AUTO_INCREMENT,
title VARCHAR(255),
description VARCHAR(255),
content LONGBLOB, -- 公文正文附件
creatorId INT,
createTime DATETIME,
workflowId INT, -- 使用的流程定义
processInstanceId BIGINT, -- jBPM 流程实例 id
status VARCHAR(255) -- 当前节点名 / '新建' / '完成'
);
CREATE TABLE T_Document_Properties (
documentId INT, -- 外键 → T_Document.id
propertyName VARCHAR(255), -- Map 的 key,如 'money'
java_lang_String VARCHAR(255),
java_lang_Integer INT,
java_io_File LONGBLOB
);
2.4 T_Module(模块)
CREATE TABLE T_Module (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(255) UNIQUE, -- '公文维护'
sn VARCHAR(255) UNIQUE, -- 'document'
url VARCHAR(255), -- 'document.do'
orderNo INT, -- 展示顺序
parentId INT -- 支持两级菜单
);
sn 是硬编码在 JSP 权限判断里的资源代号,改 sn 必须同步改页面。
三、jBPM 系统表
集成 jBPM 后会自动创建一批 JBPM_* 表,常用的有:
| 分类 | 表 |
|---|---|
| 流程定义 | JBPM_PROCESSDEFINITION、JBPM_NODE、JBPM_TRANSITION、JBPM_ACTION、JBPM_DELEGATION、JBPM_EVENT、JBPM_SWIMLANE、JBPM_TASK、JBPM_TASKCONTROLLER、JBPM_MODULEDEFINITION |
| 流程实例 | JBPM_PROCESSINSTANCE、JBPM_TOKEN、JBPM_TASKINSTANCE、JBPM_MODULEINSTANCE、JBPM_VARIABLEINSTANCE、JBPM_BYTEARRAY、JBPM_BYTEBLOCK、JBPM_COMMENT |
| 身份 | JBPM_ID_USER、JBPM_ID_GROUP、JBPM_ID_MEMBERSHIP |
| 调度与日志 | JBPM_JOB、JBPM_TIMER、JBPM_LOG、JBPM_MESSAGE |
关键关联:
T_Document.processInstanceId → JBPM_PROCESSINSTANCE.ID_
JBPM_PROCESSINSTANCE.ID_ → JBPM_VARIABLEINSTANCE(变量 'document' = 公文 id)
JBPM_TASKINSTANCE.ACTORID_ → T_User.username ← 任务指派用的是登录名
注意:
<assignment actor-id="zy"/>里的zy必须是User.username,不是用户 id。所以WorkflowManagerImpl里查任务用的是user.getUsername()而不是 id。
四、初始化数据
4.1 数据文件 init_datas.xml
放在类路径根,结构是四块:
<InitDatas>
<!-- 1. 模块树 -->
<Modules>
<Module name="个人办公" sn="personaloffice" url="" orderNo="10">
<Module name="我的办公桌" sn="myworkbeach" url="task.do?method=doesTask" orderNo="1010"/>
<Module name="我的便签" sn="notepad" url="notepad.do" orderNo="1020"/>
...
</Module>
<Module name="公文管理" sn="doc" url="" orderNo="20">
<Module name="公文维护" sn="document" url="document.do" orderNo="2010"/>
<Module name="归档处理" sn="arch" url="document.do?method=searchAllFinishedDocuments" orderNo="2020"/>
</Module>
<Module name="工作流程" sn="workflow" url="" orderNo="60">
<Module name="流程管理" sn="flow" url="workflow.do" orderNo="6010"/>
<Module name="表单定义" sn="formdef" url="workflow.do?formdef=true" orderNo="6020"/>
</Module>
<Module name="权限管理" sn="auth" url="" orderNo="80">
<Module name="模块管理" sn="module" url="module.do" orderNo="8010"/>
<Module name="角色管理" sn="role" url="role.do" orderNo="8020"/>
<Module name="用户管理" sn="user" url="user.do" orderNo="8030"/>
</Module>
...
</Modules>
<!-- 2. 角色及其授权 -->
<Roles>
<Role name="系统管理员">
<Acl module="个人办公" C="true" R="true" U="true" D="true"/>
<Acl module="公文维护" C="true" R="true" U="true" D="true"/>
...
</Role>
</Roles>
<!-- 3. 机构、人员、账号、角色分配 -->
<Organizations>
<Org name="总公司">
<Person name="张三" duty="总经理">
<User username="admin" password="admin">
<Role name="系统管理员"/>
</User>
</Person>
<Org name="研发部">
<Person name="李四" duty="工程师"> ... </Person>
</Org>
</Org>
</Organizations>
<!-- 4. 动态表单的基础数据 -->
<FieldInputs>
<FieldInput name="文本输入框" template="text.ftl"/>
<FieldInput name="下拉列表框" template="select.ftl"/>
<FieldInput name="文件输入框" template="file.ftl"/>
</FieldInputs>
<FieldTypes>
<FieldType name="字符串" type="java.lang.String"/>
<FieldType name="整数" type="java.lang.Integer"/>
<FieldType name="文件" type="java.io.File"/>
</FieldTypes>
</InitDatas>
4.2 导入程序
public class InitSystemDatasImpl extends AbstractManager implements InitSystemDatas {
public void addOrUpdateInitDatas(String xmlFilePath) {
// 用 DOM4J 解析 XML
Document document = new SAXReader().read(new File(xmlFilePath));
importModules(document.selectNodes("//Modules/Module"), null);
importRoleAndAcl(document.selectNodes("//Roles/Role"));
importOrgAndPerson(document.selectNodes("//Organizations/Org"), null);
importFieldDefinition(document.selectNodes("//FieldTypes/FieldType"),
document.selectNodes("//FieldInputs/FieldInput"));
}
...
}
四个导入步骤的顺序不能乱:
1. importModules 模块(资源)必须先存在,才能授权
2. importRoleAndAcl 角色 + 该角色对每个模块的 C/R/U/D
3. importOrgAndPerson 机构树 → 人员 → 分配登录账号 → 给用户分配角色
4. importFieldDefinition 表单类型与输入形式(先 FieldInput 再 FieldType)
其中 importOrgAndPerson 是递归的:导入机构 → 导入该机构下的人员 → 给人员建账号 → 给账号分配角色 → 递归处理子机构。
4.3 执行方式
public class InitSystemDatasTest extends TestCase {
public void testInit() {
BeanFactory factory = new ClassPathXmlApplicationContext("applicationContext-*.xml");
InitSystemDatas init = (InitSystemDatas) factory.getBean("initSystemDatas");
init.addOrUpdateInitDatas("init_datas.xml");
}
}
完整步骤:
# 1. 删库重建
mysql -uroot -p -e "drop database oa; create database oa;"
# 2. 运行初始化(JUnit 或 main 方法)
# 启动时会由 hbm2ddl 建表,然后灌入演示数据
# 3. 用 admin/admin 登录,部署一个流程,再定义表单
五、字符集与中文
老版本 MySQL(5.0 及更早)对 UTF-8 支持不完整,导入中文会抛异常。解决办法:
- 修改 MySQL 配置文件
my.ini:
[mysql]
default-character-set=gb2312
[mysqld]
default-character-set=gb2312
- 重启 MySQL;
- 删掉原库重建(已建的表不会自动改字符集);
- 再跑初始化程序。
如果是新版本 MySQL,直接用 utf8mb4 即可:
CREATE DATABASE oa DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
连接串也对应调整:
jdbc:mysql://127.0.0.1/oa?useUnicode=true&characterEncoding=UTF-8
同时别忘了 web.xml 的 CharacterEncodingFilter 与 JSP 页面的 pageEncoding 保持一致。
六、ER 关系速览
T_Organization ──pid──> T_Organization (自关联树)
T_Person ──orgId─> T_Organization
T_Person ──userId─> T_User (一对一,可为空)
T_User ──< T_UsersRoles >── T_Role (多对多,带 orderNo)
T_ACL ──principalSn──> T_User | T_Role
T_ACL ──resourceSn───> T_Module
T_Workflow ──< T_FlowForm ──< T_FormField >── T_FieldType
└──────> T_FieldInput
└──────> T_FieldItem
T_Document ──workflowId──> T_Workflow
T_Document ──processInstanceId ──> JBPM_PROCESSINSTANCE
T_Document ──< T_Document_Properties (Map,key=propertyName)
T_Document ──< T_ApproveInfo >── T_User (审批人)
T_MeetingRoom ──< T_MeetingRoomApply
七、维护建议
- 生产环境关掉
hbm2ddl.auto=update,改为维护 SQL 脚本,避免 Hibernate 擅自改表; - 给高频查询列加索引:
T_ACL(principalType, principalSn, resourceSn)、T_Document(creatorId)、T_Document(status)、T_MeetingRoomApply(roomId, beginDate, endDate)、T_Organization(sn); T_Document_Properties数据量会随公文数线性增长,注意java_io_File的 LONGBLOB 体积,必要时把附件移出数据库,只在表里存路径;- 定期归档已结束的流程实例(jBPM 提供删除 API),避免
JBPM_*表无限膨胀。
要点小结
- 业务表统一
T_前缀,共 18 张: | 表 | 对应实体 | 说明 | |---|---|---| |T_Organization| `Organizati… - 集成 jBPM 后会自动创建一批
JBPM_表,常用的有: | 分类 | 表 | |---|---| | 流程定义 | `JBPM_PROCESSDEFINITIO… - 老版本 MySQL(5.0 及更早)对 UTF-8 支持不完整,导入中文会抛异常
-
由站内小编编辑整理