共计 3677 个字符,预计需要花费 10 分钟才能阅读完成。
本文适合刚学习完 Java 语言基础的人群,跟着本文可了解和运行项目,本示例是在 Windows 操作系统下演示。
本文作者:HelloGitHub-秦人
大家好!这里是 HelloGitHub 推出的《讲解开源项目》系列,今天给大家带来一款基于 Java 语言的人力资源管理开源项目——微人事
微人事是一个前后端分离的人力资源管理系统,项目采用 SpringBoot + Vue 架构。该系统是管理员对员工信息的一些列的操作。首先管理员需要登入系统,可对员工信息进行增删查改操作,也可以对员工进行奖罚,工资等信息的增删查改。然后实现对部门员工信息的统计和修改。所有的操作都在系统中有日志记录。下面是项目搭建完成的效果图:
微人事的项目地址:https://github.com/lenve/vhr
想要快速搭建一套微人事管理系统,那就跟着本文的步骤。你只需要花 10 分钟,就能拥有一个属于自己的微人事管理系统,并且可以对前后端分离的项目有一个完成的概念和感觉。下面是搭建完成的效果图:
一、技术栈
微人事这个项目采用:
1.1 后端技术栈
- SpringBoot:SpringBoot 是基于 Spring4 进行设计,目的是为了简化 Spring 应用的初始搭建以及开发过程。该框架使用特定的方式 (集成 starter,约定优于配置) 来进行配置,从而使开发人员不需要再定义样板化的配置。
- SpringSecurity:SpringSecurity 是一个强大的和高度可定制的身份验证和访问控制框架。它着重于为 Java 应用程序提供身份验证和授权。
- MyBatis:MyBatis 是一款优秀的持久层框架,它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。
- MySQL:MySQL 是一个轻量级关系型数据库管理系统,由瑞典 MySQL AB 公司开发,目前属于 Oracle 公司。
1.2 前端技术栈
- Vue:Vue 是一套构建用户界面的渐进式框架。数据驱动,组件化是 Vue 的两大核心思想。
- ElementUI:ElementUI 时一套基于 Vue 2.0 的组件库,提供了配套设计资源。由饿了么公司前端团队开源。
- Axios:Axios 是一个基于 Promise 的 HTTP 库,可以用在浏览器和 Node.js 中。
- Vue-router:Vue-router 是 Vue 的路由,根据不同的路径映射到不同的视图。
二、项目结构
2.1 后端项目 hrserver 项目结构如下图:
后端项目采用 MVC 模式,使用现在流行的 SpringBoot 框架。SpringBoot 是基于 SpringMVC 衍生出来的框架。宗旨是较少配置,让开发者快速上手做项目。
目录说明:
- bean:数据模型目录,包括数据库模型,参数模型,业务模型。
- common:基础工具包目录,包括日期工具类,邮件工具类等。
- config:基础配置目录,包括权限认证,安全认证,菜单权限等类。
- controller:业务的控制器目录,包括员工信息,工资,系统公共功能等控制器。
- exception:自定义异常目录。公用的异常处理实现类。
- mapper:数据库操作层目录。包括数据接口的定义,查询 SQL 的业务实现。
- service:业务层目录,包括部门、员工、菜单、角色、工资等业务的业务类。
- HrserverApplication:SpringBoot 框架的入口类,在 IDE 中可直接运行 main 方法。
- resources/static:静态资源存放目录
- resources/templates:前台页面模板路径,包括 email 模板。
- resources/application.properties:环境配置文件,包括关系型数据库 mysql 连接信息,mybatis 配置文件路径,非关系型数据 redis 的连接信息,邮件服务的配置等。
- resources/mybatis-config.xml:mybatis 配置文件,目前包括日志带引的配置。
- resources/vhr.sql:MySQL 数据库脚本,(注:数据库表有外键约束,适当修改 sql 遇见的执行顺序)
2.2 前端项目 vuehr 项目结构如下图:
前端项目采用 MVVM 架构,就是 MVC 架构中多了一个 ViewMode。它是 Model 和 Controller 之间的一座桥梁。
目录说明:
- build:Vue 项目构建配置目录,包括 vue 加载器的基础配置,webpack 的环境配置。
- config:Web 项目的环境配置目录,包括代理配置、开发环境配置、生成环境配置。
- node_modules:第三方依赖目录,包括项目引用的三方依赖模块。
- src/components:前端组件目录,包括聊天组件、员工组件、个人组件、统计组件等。
- src/lib:三方依赖目录,包括 SockJS,SockJS 是一个浏览器 JavaScript 库,提供类似 WebSocket 的对象。
- src/router:路由目录,包括项目前端路由的配置信息。
- src/store:全局数据商店,存放供全局使用的一些数据。
- src/utils:工具包路径,包括前台 API 接口和常用的工具类。
- src/App.vue:Vue 前端的入口组件。
- src/main.js:Vue 前端入口 JS 事件定义的文件。
- src/index.html:微人事前端首页。
- src/package*.json:Vue 前端项目打包的配置文件,类似于 maven 项目的 pom.xml 文件。声明了项目需要的三方依赖。
三、实战操作
3.1 准备工作
1. 确保本地已安装 Java8 开发环境;
2. 确保本地以安装 maven 工具;
3. 确保本地以安装 Node.js;
3.2 下载项目
git clone https://github.com/lenve/vhr.git
3.3 运行项目
3.3.1 初始化数据库
数据库脚本存放的路径在:hrserversrcmainresourcesvhr.sql,我本地使用的可视化工具 Navcat。新建一个名称为 vhr 的数据库。
导入 vhr.sql 文件数据到 mysql 数据库。
3.3.2 修改后台项目的环境配置文件
修改后台项目的环境配置文件 hrserversrcmainresourcesapplication.properties
# MySQL 配置
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
spring.datasource.url=jdbc:mysql://IP:3306/vhr?useUnicode=true&characterEncoding=UTF-8
spring.datasource.username=root
spring.datasource.password=root
3.3.3 IDE 里运行项目
- 运行后端项目
a. 导入后端项目到 IDEA 开发工具
b. 运行后端项目
打开后台项目的入口类 HrserverApplication.java
c. 项目启动成功如下图
- 运行前端项目
a. 导入前端项目到 VSCode 开发工具
b. 运行前端项目
c. 在 VSCode 左侧导航栏,NPM SCRIPTS 中直接运行 dev。
d.Ctrl+shift+Y 呼出控制台,在控制台终端依次执行如下命令:
# 安装依赖
npm install
# 在 localhost:8080 启动项目
npm run dev
- 项目运行成功如下图
3.3.4 命令行运行项目
Win + R 打开 Wndows 命令行窗口
-
运行后端项目
a. 切换目录到 vhrhrserver 下
b. 打包后台项目
mvn clean package
c. 命令行运行微人事后台项目
切换目录到 hrservertarget,执行如下命令可启动项目
java -jar hrserver-0.0.1-SNAPSHOT.jar
d. 项目运行成功成功入下图
-
运行前端项目
a. 切换目录到 vhrvuehr 下
b. 在命令行依次执行如下命令
# 安装依赖 npm install # 在 localhost:8080 启动项目 npm run dev
c. 项目运行成功成功入下图
3.3.5 项目启动成功效果
- 员工基本信息维护
- 基础信息设置
四、最后
教程至此,你应该对前后端分离的项目有了一些简单的认识。并且你也已经在本地将项目跑起来了。所谓前后端分离,其实你也可以搞定的!项目涉及的技术比较多,你可以选择感兴趣的技术去学习。后面怎么玩就看你自己了:部署到服务器正式上线、定制自己专属的功能、给项目贡献代码等,都是可以的。
本教程是针对有一定 Java 编程基础,但又不知道如果运行本项目的小伙伴。如果你是老手欢迎直接阅读项目的说明文档,获取更多更详细的资料。
五、参考文章:
- SpringBoot wiki
- Spring Security wiki
- MyBatis wiki
- MVVM 框架 wiki
欢迎关注 HelloGitHub 公众号,获取更多开源项目的资料和内容
『讲解开源项目系列』启动——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章,你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎联系我们给我们投稿,让更多人爱上开源、贡献开源~