OA 办公自动化系统 · 总览与学习路线
导读
关于「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—— 业务实现,统一继承AbstractManagercom.oa.web.actions—— Struts Actioncom.oa.web.forms—— ActionFormcom.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…
-
由站内小编编辑整理