JYUOA项目介绍——适合刚学完SSH的朋友
前言
我最近在复习和汇总以前学习过的知识和做过的东西，JYUOA（JYU全称是Jiaying University）是我在大二刚学完SSH框架的时候，做的第一个SSH的项目。怎么说呢，这可以说是我的启蒙项目，通过这个项目，我学到很多东西，像什么框架之间的整合，还有SSH框架的具体实战使用，还有三层架构设计，以及权限管理等知识，所以我觉得这是一个十分适合刚学完SSH框架的朋友的项目。
项目简介
OA是Office Automation的缩写，本意为利用技术的手段提高办公的效率，进而实现办公的自动化处理。实现信息化、无纸化办公，可方便的生成统计报表等。
当然了，真正的一个OA系统的功能是很多的，下面这张图是说一个OA系统能够具有的全部功能，现在的OA系统的功能基本上就是下面这张图的子集。
而JYUOA只是实现了其中很小的一部分功能，不够这样也够呛了，也需要具备很多知识的了，在后面我会介绍一下它的整体架构和里面的功能。下面是项目的主页
项目整体架构
一般这个时候就要扯到三层架构和MVC模式了，不管很多人都这两个其实会搞混，说不出个所以然来，这里我强烈建议你去看看对三层和MVC的认识过程。
现在回到我们这个项目，这个项目有采用MVC模式，至于三层嘛，其实这个项目最开始用的也是三层，但后来进行重构，直接把业务逻辑层与数据访问层合并了，所以变成了两层，为什么要这么做呢，因为这个项目的业务逻辑并不是特别复杂，普遍都是增删改查操作，这样一来的话业务逻辑层的Service类的方法只是简单地调用一下数据访问层的Dao类的方法，所以干脆把它们整合一起。
还是普遍增删改查的问题还有分页等公共功能，所以把这些普通的功能都抽取出来了，如在界面层（UI）就抽取了Action，抽取出来一个edu.jyu.oa.base.BaseAction和edu.jyu.oa.base.ModelDrivenBaseAction<T>，其中ModelDrivenBaseAction继承了BaseAction，一个Action类如果需要用到Struts2的ModelDriven的话，k就继承ModelDrivenBaseAction，否则继承BaseAction，例如edu.jyu.oa.view.action.ProcessDefinitionAction。
那么就以部门为例，整个项目的层次结构如下图
还有就是实体类图，可能在这里看不清楚，但是我已经放在相关资料那里了
所用框架、技术
- Struts2 2.1.8.1
- Hibernate 3.6.0
- Spring 2.5
- jBPM 4.4：工作流支持
- Junit 4：单元测试
- jQuery 1.4
说明：还有jQuery.validate与jQuery.treeview等小插件
项目目录结构与包结构
目录结构
- 源码文件夹
src：项目源代码
conf：配置文件
test：单元测试 - WebContent文件夹下
script：JavaScript脚本文件
style：CSS样式文件
WEB-INF/jsp：jsp页面文件（再创建子文件夹分类存放）
包结构
- edu.jyu.oa.base：抽取公共功能的一些类
- edu.jyu.oa.cfg：管理配置信息
- edu.jyu.oa.domain：实体
- edu.jyu.oa.install：安装程序所在包
- edu.jyu.oa.service：Service接口
- edu.jyu.oa.service.impl：Service的实现类
- edu.jyu.oa.view.action：Struts的Action
- edu.jyu.oa.util：一些工具类
项目功能
系统管理
岗位管理
这个岗位管理其实可以看作是角色管理了，而角色有什么用呢？角色其实就是用户跟权限中间的一个桥梁，一个用户可以拥有很多权限，但是如果有些用户的所拥有的权限是一样的，那么分别跟这些用户分配权限的话就会很麻烦，所以不如就将权限分配到角色去，然后给用户分配角色，这样子，用户就拥有了角色所拥有的权限。一个用户可以有多个角色，一个角色可以有多个权限。如果一个用户没有某一项权限，那么就不会显示那个权限对应的操作给该用户看。
岗位管理有以下功能：
- 查看岗位列表
- 添加岗位
- 修改岗位
- 设置岗位权限：可以给岗位设置多个权限
- 删除岗位：一个用户如果关联着该岗位，则会取消关联该岗位
岗位对应的实体类是edu.jyu.oa.domain.Role
部门管理
部门呢，就是部门咯，它可以有一个上级部门，也可以有多个下级部门，没有上级部门的可以称作顶级部门，一个部门下面可以有多个用户，即用户与部门的关系是1对多。
部门管理有以下功能：
- 查看所有顶级部门列表
- 查看一个部门所有的子部门
- 查看一个部门的上级部门
- 添加部门
- 修改部门
- 删除部门：会将下级部门一并删除，原本在这部门上的用户就没有所属部门了
部门对应的实体类是edu.jyu.oa.domain.Department
用户管理
用户管理呢，真的没什么好说的，大家都懂的。
用户管理有以下功能：
- 查看用户列表
- 添加用户：可以在这里设置岗位和部门
- 修改用户：可以在这里设置岗位和部门
- 删除用户
- 初始化用户密码：其实用户创建出来密码默认就是1234，所以初始化也是1234，修改用户密码可以在个人设置中修改，不过我没做这个功能……大家喜欢的话可以补上
用户对应的实体类是edu.jyu.oa.domain.User
网上交流
论坛管理
这里应该说称作论坛版块管理比较适合点。
论坛管理有以下功能：
- 添加板块
- 查看论坛列表
- 修改板块
- 删除板块
- 对列表中的板块进行上移下移排序：板块的顺序在论坛列表中的顺序相同
论坛版块对应的实体类是edu.jyu.oa.domain.Forum
论坛
这里就是真正可以去论坛版块交流的地方了，你可以选择一个版块，然后再该版块上发帖子
论坛有以下功能：
- 查看论坛版块以及相关信息，如论坛版块的帖子数等
- 查看一个论坛板块的所有帖子，还可以根据各种条件进行排序
- 发帖
- 回帖
编辑帖子和删除帖子功能没有做。置顶和精华也没做，其实就是修改edu.jyu.oa.domain.Topic的type值。有兴趣的也可以做一下，也不是很难的。
论坛中的帖子对应着实体类edu.jyu.oa.domain.Topic和edu.jyu.oa.domain.Article，其中Topic继承了Article
审批流转
审批流程管理
你要要申请一个东西，就要有一个流程，比如说请假，先给谁审批，再给谁审批。这里就可以部署一个流程的定义文件了，这个流程定义文件是用Eclipse的JBPM插件做的。
审批流程管理有以下功能：
- 查看流程定义列表
- 部署流程定义文档：如果是具有同一个name的流程定义文档的话，再次部署相当于修改，就是将已部署的该文档的版本号加1，比如说我部署了一个请假流程名称为“员工请假流程”，流程步骤是 开始-》提交申请-》总经理审批-》结束，后来改成 开始-》提交申请-》部门经理审批-》总经理审批-》结束，这样子的话，即使流程改变，流程的name没有改变的话，再次部署就会把该流程版本+1，每次使用流程定义的时候都是用最新版本的
- 删除流程定义：会删除该流程定义以及与它具有相同name或者说key值的所有版本的流程定义
- 查看流程图：查看部署的的文件中xxx.png
流程定义对应的是org.jbpm.api.ProcessDefinition，这是一个接口，由JBPM提供的
申请模板管理
有了流程定义，我们就可以创建一个申请模板了，该申请模板可以引用一个流程定义，并且关联一个申请文件（.doc格式），员工可以根据该申请模板进行申请事务。
申请模板管理有以下功能：
- 查看申请模板列表
- 添加申请模板：要关联一个流程，上传一个模板文件
- 修改申请模板
- 删除申请模板
- 下载申请模板中的相关模板文件.doc
申请模板对应的实体类是edu.jyu.oa.domain.Template
起草申请
有了申请模板以后，就可以起草申请了。
起草申请有以下功能：
- 查看所有的申请模板
- 选择一个申请模板然后填写申请，申请后跳到我的申请查询
申请对应的实体类是edu.jyu.oa.domain.Application
待我审批
在申请以后，就需要对申请进行审批。
待我审批有以下功能：
- 显示出待我审批的申请记录
- 审批记录：可以同意申请和不同意申请，如果有多条路线选择的话，还可以在同意后指定下一条路线，比如说在部门经理审批同意后，可以直接结束，也可以转到总经理，这时候部门经理就可以选择走哪条路线。
- 查看流转记录
审批有关的实体类是edu.jyu.oa.domain.ApproveInfo
我的申请查询
在这里可以看到历史申请记录的和正在申请的记录。
我的申请查询有以下功能：
- 查看申请的记录：可以根据申请模板和状态来作为查询条件
- 查看流转记录
项目搭建
整个项目大概就介绍到这里，现在就来说说怎么在你的机器上泡起来。我在本机运行这个项目的时候，用的JDK版本是1.7，Tomcat版本是8，千万不要用JDK 1.8，因为这个项目的Spring版本跟JDK 1.8不兼容，所以关于一些环境版本的选择，你要小心咯。
- 你要创建一个数据库，我的是
jyuoa，如果你创建的数据库名不是这个的话，就得到config中的jdbc.properties里修改一下数据库配置，还有就是数据库账号密码什么也是在那修改的，注意了，你创建的这个数据库要选择UTF-8编码。 - 下载这个项目的代码，然后在你自己的IDE中创建Web工程，随便起你喜欢的名字，把下载好的代码拷贝到工程的对应位置中。你可以发现我没有上传
.project文件，因为我用的是Eclipse，你可能用的是其它工具。我也没有上传.classpath，因为像Eclipse的WebContent到了MyEclipse就是WebRoot，.classpath文件可能会让产生一些让你疑惑的问题，比如说同时出现了WebContent和WebRoot，反正我就被懵过，至于其它的IDE我也没用过了，也不知道会出现什么问题，所以你要记得把src、test还有config文件夹Build Path为源码目录(Source Folder)。 - 在配置好工程后，找到
edu.jyu.oa.install.Installer类，运行一下，把项目的基本信息插入到数据库中，像超级管理员信息还有一些权限的信息，不过可能第一次运行会比较慢，因为要建很多表。 - 然后就是部署到你的Web容器中啦，我只试过在在Tomcat 8中部署。
大概就是这样子吧，出了错别慌，尽情地谷歌和百度，实在不行你找我。
总结
这个项目可能对于以后我遇到的项目来讲，是a piece of cake，但是这对于我来说是一个很好的开始，每次积累一点点，最后整合起来就是一大块。但是这个项目也有很多缺点，比如说日志没怎么做，异常处理也不好，有些功能没有完成，不过只要花点时间，肯定是能行的！最后需要说的是，这个项目我是学习传智播客的OA项目的，所以非常感谢传智播客将他们的教学资源分享出来。
项目地址https://github.com/HuangFromJYU/JYUOA