A
📖 Wiki
中

数据库设计与数据初始化

📄 数据与运维 24 min read 111 views Updated 2026-10-25 Chinese only

导读

「数据库设计与数据初始化」的回答要点集中在下面几节,建议先记住结论再看推导过程。

这一篇给出完整的表清单、关键表结构、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 支持不完整,导入中文会抛异常。解决办法:

  1. 修改 MySQL 配置文件 my.ini:
[mysql]
default-character-set=gb2312
[mysqld]
default-character-set=gb2312
  1. 重启 MySQL;
  2. 删掉原库重建(已建的表不会自动改字符集);
  3. 再跑初始化程序。

如果是新版本 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 支持不完整,导入中文会抛异常
  • 
    
    

由站内小编编辑整理

Related