A
📖 Wiki
中

OA 办公自动化系统 · 总览与学习路线

📄 入门与总览 14 min read 102 views Updated 2026-10-25 Chinese only

导读

关于「OA 办公自动化系统 · 总览与学习路线」,这里按「结论 → 原理 → 追问」的顺序梳理,方便随时查阅。

OA(Office Automation,办公自动化)系统是企业内部最典型的信息系统之一。它把组织、人员、权限、审批流这些"管理动作"沉淀成可配置的软件能力。本系列文档围绕一个完整的 OA 教学项目展开,从零搭建到实现公文流转这一核心功能,覆盖经典 Java Web 技术栈的全部关键环节。

说明:文中所有包名统一写作 com.oa.*,示例数据与人员姓名均为演示用虚构数据,不涉及任何第三方机构或个人的内容。


一、系统是什么

本项目实现的是一个以审批流为核心的 OA 系统,功能模块可以分成三层:

层次 模块 作用
基础支撑 组织机构管理、人员管理 描述公司/部门/岗位的树形结构,人员挂靠在机构上
安全支撑 模块管理、角色管理、用户管理、授权管理(ACL) 定义"谁可以对什么资源做什么操作"
核心业务 流程管理(jBPM)、公文管理、动态表单 定义审批流程、发起公文、按流程逐级审批
扩展业务 会议室管理、会议室申请 资源预订与时间冲突检测

一句话概括业务流程:管理员先部署一条流程定义,并为它配置一张动态表单;普通用户选择该流程发起公文,填写表单内容后提交;公文按流程定义在不同审批人之间流转,每一步都可以选择不同的流向,直到流程结束。


二、技术栈

层次 技术 版本 职责
表现层 Struts 1.x(ActionServlet + DispatchAction) 1.2/1.3 请求分发、表单绑定、页面跳转
表现层 JSP + JSTL + 自定义 EL 函数(.tld) — 页面渲染、权限即时判断
表现层 Dojo(Tree 控件)+ DWR DWR 2.0 机构树展示、Ajax 异步交互
表现层 Freemarker 2.3 动态表单与机构树的模板渲染
业务层 Spring Framework 2.0 IoC 容器、声明式事务、Hibernate 与 Struts 的整合
持久层 Hibernate 3.x ORM 映射、HQL 查询、分页
持久层 XDoclet + Ant — 由 Java 注释自动生成 hbm.xml 映射文件
工作流 jBPM(JBoss jBPM)+ spring-modules-jbpm31 3.1 流程定义、流程实例、任务实例、流向
构建/日志 Ant、Log4j、JUnit — 编译打包、日志记录、单元测试
数据库 MySQL 5.x 数据存储
容器 Tomcat 5.x Web 容器

整合要点:Spring 通过 LocalSessionFactoryBean 管理 Hibernate 的 SessionFactory;Struts 的 Action 交给 Spring 容器创建(DelegatingActionProxy),从而在 Action 里直接注入业务层 Manager;jBPM 通过 LocalJbpmConfigurationFactoryBean 交给 Spring 创建 JbpmConfiguration,并把 jBPM 的 Hibernate Session 复用为当前 Session,实现业务数据与流程数据的同一事务。


三、架构分层

┌──────────────────────────────────────────────────────┐
│  JSP / Dojo / DWR / Freemarker                       │  表现层
├──────────────────────────────────────────────────────┤
│  Struts Action (DispatchAction / BaseAction)          │
│  ActionForm  ←→  DynaForm(Map 接收动态表单)          │  控制层
├──────────────────────────────────────────────────────┤
│  Manager 接口 / ManagerImpl 实现(orgManager、        │
│  aclManager、documentManager、workflowManager …)      │  业务层
├──────────────────────────────────────────────────────┤
│  AbstractManager(通用分页) + HibernateDaoSupport    │  持久层
│  jBPM API(GraphSession / TaskMgmtSession)           │
├──────────────────────────────────────────────────────┤
│  MySQL(业务表 T_* + jBPM 系统表 JBPM_*)             │  数据层
└──────────────────────────────────────────────────────┘

命名约定:

  • com.oa.model —— 实体类,类名与表名一一对应(XDoclet 注释写在字段上)
  • com.oa.managers —— 业务接口(OrgManager、AclManager、DocumentManager …)
  • com.oa.managers.impl —— 业务实现,统一继承 AbstractManager
  • com.oa.web.actions —— Struts Action
  • com.oa.web.forms —— ActionForm
  • com.oa.web —— Filter、自定义 EL 函数、类型转换器等 web 基础设施

四、核心领域模型

实体 说明
Organization 机构,自关联形成树,sn 保存从根到当前节点的 id 路径(如 1_3_7)
Person 人员,从属于某个机构,一个人员可对应一个登录账号
User 登录账号,与 Role 多对多(UsersRoles 带 orderNo 表示角色优先级)
Role 角色
Module 模块(受控资源),用 sn 作为唯一标识
ACL 授权记录:主体(用户/角色)+ 资源 + 权限位 + 是否继承
Workflow 流程定义(存 jBPM 的 XML 定义与流程图二进制)
Document 公文,绑定流程定义与流程实例 ID,props 保存动态表单的值
ApproveInfo 审批意见(谁、什么时候、批了什么)
FlowForm / FormField / FieldType / FieldInput / FieldItem 动态表单定义:表单 → 表单域 → 类型/输入形式/候选项
DocumentProperty 动态表单的值载体,用三个不同类型的字段承载 String / Integer / File
MeetingRoom / MeetingRoomApply 会议室与会议室申请

五、开发演进路线(12 个阶段)

项目按"先基础、后核心、再扩展"的顺序推进,每一阶段都对应一个可运行的工程快照:

阶段 主题 关键产出
1 搭建 SSH 环境、机构管理 CRUD、通用异常处理、Log4j、pager-taglib 分页 Organization 实体、Hibernate 映射、分页雏形
2 分页逻辑封装 PagerModel、SystemContext(ThreadLocal)、PagerFilter、AbstractManager
3 重构与人员管理 包重命名、Person 完整 CRUD
4 权限实体与授权认证 Module/Role/User/UsersRoles/ACL、AclManager
5 数据初始化 InitSystemDatas + init_datas.xml
6 DWR 集成与权限落地到页面 登录导航菜单、即时认证、JSTL 权限函数
7 集成 jBPM 建表、与 Spring 整合、WorkflowManagerImpl
8 公文管理与流程管理实现 Document、DocumentManagerImpl、动态表单实体模型
9 动态表单定义 FormManager、批量提交表单域、AutoArrayList
10 Freemarker 渲染动态表单 FreemarkerManager + 模板文件
11 流程流向按用户查询 searchNextTransitions(username, processInstanceId)
12 机构树与会议室管理 tree.ftl 递归模板、MeetingRoomManagerImpl

推荐的阅读顺序(如果你是要学这套技术):先用「框架与环境」打地基,再读「组织与权限」理解权限模型(这是 OA 的灵魂),然后攻「业务模块」里的公文流转与动态表单,最后用「数据与运维」两篇做查漏补缺。如果是要快速上手改代码,直接看《数据库设计与数据初始化》与《常见问题与排错手册》。


六、文档索引

本系列按模块分为五个分类,阅读时按分类顺序推进即可:

分类 文档 内容
入门与总览 总览与学习路线 技术栈全景、12 阶段演进、阅读顺序
框架与环境 SSH 环境搭建与工程结构 依赖包、目录结构、三大配置文件、Ant + XDoclet 自动生成映射
框架与环境 通用基础设施:分页、异常与日志 ThreadLocal 传参、通用分页 DAO、OpenSessionInView、编码过滤器、异常与 Log4j
框架与环境 呈现层:Struts 与 JSP DispatchAction、BaseAction 登录拦截、ActionForm、自定义 EL 函数、日期转换
框架与环境 DWR 异步交互 DWR 配置、返回值与参数处理、同步/异步
组织与权限 组织机构与人员管理 树形结构、sn 路径、懒加载、删除校验、人员管理
组织与权限 权限管理:ACL 授权与即时认证 主体/资源/权限位、授权、继承、角色优先级、即时认证
业务模块 公文流转与 jBPM 工作流 jBPM 集成三步、流程定义部署、流程实例、任务实例、流向、审批
业务模块 动态表单与 Freemarker 渲染 表单领域模型、模板渲染、Map 接收输入、类型转换与文件上传
业务模块 会议室管理与时间冲突检测 时间段重叠判断、会议室日历视图
数据与运维 数据库设计与数据初始化 全部表结构、jBPM 系统表、初始化数据流程
数据与运维 常见问题与排错手册 中文乱码、Session 关闭、auto-import 冲突、事务等

七、运行前置条件

  • JDK 5+(示例代码大量使用泛型前的写法与 Integer 自动装箱,JDK 6 亦可)
  • MySQL 5.x,创建数据库 oa,字符集建议 gb2312/gbk(老版本 MySQL 对 UTF-8 支持有限,见排错手册)
  • Tomcat 5.x,JDK 与容器版本匹配
  • Ant 已安装并加入 PATH(用于 XDoclet 生成映射文件)
  • 依赖 jar 全部放在 WebRoot/WEB-INF/lib:struts、spring、hibernate3、dwr、freemarker、jbpm-jpdl、jbpm-identity、spring-modules-jbpm31、mysql-connector、log4j、jstl/standard、pager-taglib、commons-* 等

启动前修改 hibernate.cfg.xml 中的连接串与账号密码,然后启动 Tomcat,hbm2ddl.auto=update 会自动建表;若需要演示数据,再执行初始化程序(见《数据库设计与数据初始化》)。

要点小结

  • 公文按流程定义在不同审批人之间流转,每一步都可以选择不同的流向,直到流程结束。
  • 本项目实现的是一个以审批流为核心的 OA 系统,功能模块可以分成三层: | 层次 | 模块 | 作用 | |---|---|---| | 基础支撑 | 组织机构管理…
  • | 层次 | 技术 | 版本 | 职责 | |---|---|---|---| | 表现层 | Struts 1.x(ActionServlet + DispatchActi…
  • 
    
    

由站内小编编辑整理