简介本资源是一套基于SSM框架SpringSpringMVCMyBatis与JSP技术实现的企业级人事管理系统完整开发包面向计算机专业本科生、毕业设计学生及Java Web初学者解决企业员工信息管理、考勤统计、薪资核算等核心HR业务场景的系统化开发需求。压缩包共987个文件涵盖96个Java后端逻辑类、46个JSP页面模板、242个JS交互脚本、161个PNG与141个GIF图形资源、125个CSS样式文件及2个SQL数据库脚本总大小11.32MB结构清晰便于分层学习与部署调试。已有23人下载学习适合通过真实项目掌握MVC分层架构、RESTful接口设计、MySQL数据库建模及前端页面联动等关键技能。资源包含可直接运行的源码、详细设计文档含模块划分与界面原型、db.sql建库脚本及论文.doc——后者系统阐述需求分析、功能实现细节与测试过程是理解企业级Web应用从理论到落地全过程的优质教学案例。1. 为什么还在用 SSM JSP 做企业人事管理系统不是过时而是稳得踏实你点开这个压缩包ssm158企业人事管理系统的设计与实现jsp(文档源码)_kaic.zip第一反应可能是JSP2024 年还写 JSPSSMSpring SpringMVC MyBatis不早被 Spring Boot 吊打了吗——这恰恰是它值得深挖的起点。这不是一个“教学玩具”而是一套在中小型企业真实跑过三年、支撑 300 员工日常考勤、入职、转正、离职、薪资核算全流程的可部署、可维护、可审计系统。它没上微服务没搞前后端分离但数据库事务控制严、权限粒度到按钮级、操作日志全量落库、导出 Excel 兼容 Office 2007–2021、所有 JSP 页面带防 XSS 转义、MyBatis 的 SQL 全部写在 XML 里——不是不会写注解是怕线上 SQL 拼错导致删库。它解决的不是“炫技”而是“不出事”HR 部门凌晨两点改完调薪方案第二天一早全员工资条准时发到邮箱新员工入职填完表系统自动触发 OA 审批流、同步创建 AD 账号、生成门禁卡号、分配邮箱空间——这些动作背后是 SSM 的事务传播控制 JSP 的模板化表单渲染 自研的轻量级工作流引擎。适合谁适合没有专职前端、运维人力紧张、但对数据一致性、流程合规性、审计留痕有硬性要求的制造业、教育机构、事业单位下属公司。它不酷但它能让你睡得着。2. 从零跑通 SSM158环境、依赖、启动三步闭环这套系统不是“开箱即用”但也不需要你重装系统。它的技术栈边界非常清晰JDK 1.8、Tomcat 8.5、MySQL 5.7、Maven 3.6。没有 Docker、没有 Nginx、没有 Redis —— 所有缓存靠 MyBatis 一级缓存 手动Cacheable注解控制所有静态资源走 Tomcat 默认路径。这种“退一步”的选择换来的是部署故障率低于 3%我们实测 127 次部署中仅 4 次失败全是因本地 MySQL 未开启sql_modeSTRICT_TRANS_TABLES。下面带你把压缩包里的ssm158目录真正跑起来。2.1 解压与目录结构认知别急着改代码先看懂骨架解压后你会看到两个核心目录src/Java 源码和WebContent/JSP/JS/CSS/WEB-INF。重点盯住三个位置src/main/java/com/kaic/ssm158/所有 Controller、Service、Mapper 接口和实体类WebContent/WEB-INF/web.xml这是整个系统的“总开关”定义了 SpringMVC 的 DispatcherServlet 和字符编码过滤器WebContent/WEB-INF/spring-mvc.xmlMVC 层配置包含视图解析器InternalResourceViewResolver指向/WEB-INF/jsp/这就是为什么所有 JSP 必须放在这里才能被访问。提示不要试图把 JSP 放到WebContent/根目录下——它会被 Tomcat 直接暴露且 SpringMVC 根本找不到。这是新手最常翻车的第一步。2.2 数据库初始化建库、建表、插初始数据三者缺一不可系统依赖 MySQL但不提供一键建库脚本。你需要手动执行以下三步顺序不能错-- 1. 创建数据库注意字符集必须 utf8mb4 CREATE DATABASE ssm158 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 2. 切换库执行建表语句来自压缩包内 doc/数据库设计.sql USE ssm158; -- 此处粘贴 doc/数据库设计.sql 全部内容含 employee、department、position、salary、log 等 12 张表 -- 3. 插入基础数据关键否则登录页直接 404 INSERT INTO user (id, username, password, realname, role_id, status) VALUES (1, admin, e10adc3949ba59abbe56e057f20f883e, 系统管理员, 1, 1); -- 密码明文是 123456MD5 加密后为 e10adc3949ba59abbe56e057f20f883e参数说明e10adc3949ba59abbe56e057f20f883e是123456的标准 MD532 位小写系统登录校验逻辑写死在此值不走盐值加密——不是安全漏洞是为降低运维复杂度。若需增强修改UserServiceImpl.java中login()方法替换为BCryptPasswordEncoder即可但需同步改数据库密码字段长度原为 32BCrypt 需 60。2.3 Maven 依赖与 Tomcat 启动跳过 Spring Boot回到原始信任链打开pom.xml确认以下核心依赖版本其他如 log4j、junit 等可忽略依赖坐标版本作用说明org.springframework:spring-webmvc4.3.29.RELEASESpringMVC 核心处理请求分发与视图渲染org.mybatis:mybatis-spring1.3.2桥接 MyBatis 与 Spring 容器让 Mapper Bean 可注入mysql:mysql-connector-java5.1.47MySQL 驱动必须用 5.x不能用 8.x否则jdbcUrl中需加serverTimezoneGMT%2B8而本项目未配置javax.servlet:jstl1.2JSP 标签库c:ifc:forEach全靠它启动步骤在 IDEA 中右键项目 →Add Framework Support→ 勾选Web Application指定WebContent为 Web rootFile → Project Structure → Artifacts新建Web Application: Archive输出路径设为out/artifacts/ssm158_war_exploded配置 Tomcat ServerDeployment 中添加Artifact: ssm158_war_explodedApplication context 设为/ssm158启动浏览器访问http://localhost:8080/ssm158/login.jsp—— 若见登录框成功一半。逻辑说明web.xml中welcome-file-list定义首页为login.jsp而spring-mvc.xml中mvc:default-servlet-handler/确保静态资源如/css/login.css能被 Tomcat 原生 Servlet 处理不经过 SpringMVC 拦截器。这是 JSP 项目“动静分离”的底层保障。3. SSM 分层拆解Controller 怎么接参、Service 怎么控事务、Mapper 怎么防 SQL 注入这套系统没用 Lombok没用 MapStruct所有 DTO、VO、Entity 全手写 getter/setter。好处是你能一眼看清数据流向。我们以「新增员工」功能为例从 HTTP 请求一路追到数据库写入看 SSM 如何协作。3.1 Controller 层接收参数、校验、转发不碰业务逻辑打开EmployeeController.java找到addEmployee()方法RequestMapping(value /employee/add, method RequestMethod.POST) public String addEmployee(ModelAttribute Employee employee, RequestParam(deptId) Integer deptId, RequestParam(posId) Integer posId, Model model) { // 1. 参数绑定ModelAttribute 自动将表单 namexxx 字段映射到 Employee 对象 // 2. RequestParam 强制获取下拉框选中的部门/岗位 ID非对象属性故单独传 // 3. 校验空值检查 手机号正则正则写在 Employee.java 的 Pattern 注解里但本项目未启用 Hibernate Validator实际校验在 Controller 内硬编码 if (employee.getName() null || employee.getName().trim().length() 0) { model.addAttribute(msg, 姓名不能为空); return employee/add; // 返回原页面不跳转 } // 4. 调用 Service传入 employee deptId posId因为 Employee 实体里 dept 和 pos 是对象但表单只传 ID boolean result employeeService.addEmployee(employee, deptId, posId); model.addAttribute(msg, result ? 添加成功 : 添加失败); return redirect:/employee/list; // 成功则重定向防止 F5 刷新重复提交 }关键参数说明ModelAttribute是 SSM 绑定表单数据的“玄学开关”——它要求 JSP 表单input的name属性必须与Employee类字段名完全一致如namename→employee.setName()且字段类型要匹配String 接收文本Integer 接收数字。若表单有namehireDate而Employee.hireDate是Date类型则需在spring-mvc.xml中配置InitBinder注册CustomDateEditor本项目已配好在BaseController.java中。3.2 Service 层事务边界、业务规则、跨表操作EmployeeServiceImpl.java中addEmployee()方法Transactional(rollbackFor Exception.class) Override public boolean addEmployee(Employee employee, Integer deptId, Integer posId) { try { // 1. 先插入员工主表employee 表 employeeMapper.insert(employee); // 返回自增主键到 employee.getId() // 2. 再插入关联关系employee_dept 表多对多中间表 EmployeeDept ed new EmployeeDept(); ed.setEmpId(employee.getId()); ed.setDeptId(deptId); employeeDeptMapper.insert(ed); // 3. 插入岗位关系employee_position 表 EmployeePosition ep new EmployeePosition(); ep.setEmpId(employee.getId()); ep.setPosId(posId); employeePositionMapper.insert(ep); // 4. 记录操作日志log 表 Log log new Log(); log.setOperator(admin); // 实际应从 session 获取当前用户 log.setOperation(新增员工 employee.getName()); log.setCreateTime(new Date()); logMapper.insert(log); return true; } catch (Exception e) { // 事务自动回滚无需手动 throw e.printStackTrace(); return false; } }事务原理Transactional注解由 Spring AOP 织入当方法抛出RuntimeException或其子类时事务回滚。这里rollbackFor Exception.class是显式扩大回滚范围包括 checked exception确保SQLException也能触发回滚。血泪经验若你在catch块里return false却没throw事务不会回滚——因为 Spring 认为“你已处理异常无需干预”。3.3 Mapper 层XML 写 SQL比注解更可控、更易审计打开EmployeeMapper.xml看insert语句insert idinsert parameterTypeEmployee useGeneratedKeystrue keyPropertyid INSERT INTO employee ( name, gender, id_card, phone, email, hire_date, entry_time, status, remark ) VALUES ( #{name}, #{gender}, #{idCard}, #{phone}, #{email}, #{hireDate}, #{entryTime}, #{status}, #{remark} ) /insert参数说明useGeneratedKeystruekeyPropertyid是 MyBatis 获取 MySQL 自增主键的核心配置。#{}是预编译占位符绝对防 SQL 注入而${}是字符串拼接本项目 XML 中未出现一次${}—— 这是硬性规范。所有动态条件如查询时按部门筛选都用if testdeptId ! nullAND dept_id #{deptId}/if不用字符串拼接。4. JSP 页面实战从 login.jsp 到 employee/list.jsp 的渲染逻辑与安全加固JSP 不是古董它是“服务端模板”的成熟范式。这套系统所有 JSP 都遵循统一规范继承base.jsp、使用 JSTL 标签、所有输出变量经fn:escapeXml()转义、表单提交走 POST Token 防重放虽未实现但预留了token字段。我们以employee/list.jsp为例看它如何把 Java List 渲染成表格并支持分页。4.1 页面结构base.jsp 继承与标签库声明list.jsp顶部必有% page languagejava contentTypetext/html; charsetUTF-8 pageEncodingUTF-8% % taglib prefixc urihttp://java.sun.com/jsp/jstl/core % % taglib prefixfn urihttp://java.sun.com/jsp/jstl/functions % % include file/WEB-INF/jsp/base.jsp %base.jsp定义了head中的 CSS/JS 引入、导航栏、以及关键的c:set varctx value${pageContext.request.contextPath}/—— 这个ctx变量让所有链接写成${ctx}/employee/add避免硬编码/ssm158上下文路径迁移时只需改 Tomcat 配置。4.2 数据渲染JSTL 循环 EL 表达式 安全转义表格主体代码table classtable table-striped thead tr th姓名/thth性别/thth部门/thth岗位/thth入职日期/thth操作/th /tr /thead tbody c:forEach items${employeeList} varemp varStatusstatus tr td${fn:escapeXml(emp.name)}/td td${emp.gender 1 ? 男 : 女}/td td${fn:escapeXml(emp.department.name)}/td td${fn:escapeXml(emp.position.name)}/td td${emp.hireDate}/td td a href${ctx}/employee/edit?id${emp.id} classbtn btn-sm btn-primary编辑/a a href${ctx}/employee/delete?id${emp.id} classbtn btn-sm btn-danger onclickreturn confirm(确定删除 ${fn:escapeXml(emp.name)})删除/a /td /tr /c:forEach /tbody /table关键细节${fn:escapeXml(emp.name)}是防 XSS 的“后悔药”——即使数据库里存了scriptalert(1)/script页面也只会显示纯文本varStatusstatus提供循环索引status.index、是否首尾status.first/status.last可用于隔行变色删除链接的onclick中confirm()弹窗其内容也经escapeXml防止弹窗被注入 HTML。4.3 分页实现PageBean 封装 JSP 逻辑判断Controller 查询时传入PageBean对象// EmployeeController.java RequestMapping(/employee/list) public String listEmployee(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, Model model) { PageBeanEmployee pageBean employeeService.findEmployeeByPage(pageNum, pageSize); model.addAttribute(pageBean, pageBean); return employee/list; }PageBean.java包含list当前页数据、total总记录数、pageNum、pageSize、totalPage总页数等字段。JSP 中分页栏div classpagination c:if test${pageBean.pageNum 1} a href${ctx}/employee/list?pageNum1pageSize${pageBean.pageSize}laquo; 首页/a a href${ctx}/employee/list?pageNum${pageBean.pageNum-1}pageSize${pageBean.pageSize}lt; 上一页/a /c:if c:forEach begin1 end${pageBean.totalPage} vari c:choose c:when test${i pageBean.pageNum} span classcurrent${i}/span /c:when c:otherwise a href${ctx}/employee/list?pageNum${i}pageSize${pageBean.pageSize}${i}/a /c:otherwise /c:choose /c:forEach c:if test${pageBean.pageNum pageBean.totalPage} a href${ctx}/employee/list?pageNum${pageBean.pageNum1}pageSize${pageBean.pageSize}下一页 gt;/a a href${ctx}/employee/list?pageNum${pageBean.totalPage}pageSize${pageBean.pageSize}末页 raquo;/a /c:if /div注意分页参数pageNum和pageSize必须通过RequestParam显式接收不能靠ModelAttribute绑定——因为它们不在表单里是 URL 查询参数。5. 避坑指南SSM158 开发与部署中 4 个真实踩过的坑这些不是理论问题是我在客户现场重启 Tomcat 17 次后记下的血泪笔记。每一条都对应一个具体现象、根本原因、和一行命令/一个配置就能解决的方案。5.1 现象登录成功后跳转http://localhost:8080/ssm158/WEB-INF/jsp/index.jsp报 404原因web.xml中welcome-file-list设置了index.jsp但 SpringMVC 的InternalResourceViewResolver默认前缀是/WEB-INF/jsp/后缀是.jsp所以return index实际指向/WEB-INF/jsp/index.jsp—— 而 Tomcat禁止直接访问 WEB-INF 下任何资源这是安全机制。解决在LoginController.java的login()方法中不要return index而要return redirect:/main然后新增一个MainController.javaRequestMapping(/main) public String main() { return index; // 此时 SpringMVC 会正确解析为 /WEB-INF/jsp/index.jsp }5.2 现象新增员工时hire_date字段入库为0000-00-00而非表单填写的2024-05-20原因JSP 表单传的是字符串2024-05-20而Employee.hireDate是java.util.Date类型SpringMVC 默认无法自动转换。虽然spring-mvc.xml配了CustomDateEditor但它的日期格式是yyyy-MM-dd HH:mm:ss而表单只有日期无时间。解决修改BaseController.java中的initBinder()方法增加对yyyy-MM-dd格式的支持InitBinder public void initBinder(WebDataBinder binder) { SimpleDateFormat sdf1 new SimpleDateFormat(yyyy-MM-dd HH:mm:ss); SimpleDateFormat sdf2 new SimpleDateFormat(yyyy-MM-dd); binder.registerCustomEditor(Date.class, new CustomDateEditor(sdf1, true)); binder.registerCustomEditor(Date.class, new CustomDateEditor(sdf2, true)); }5.3 现象导出 Excel 功能点击无反应浏览器控制台报ReferenceError: exportExcel is not defined原因exportExcel.js被放在WebContent/js/下但list.jsp中引用路径写成了script srcjs/exportExcel.js/script—— 缺少上下文路径实际请求的是http://localhost:8080/js/exportExcel.js404而非http://localhost:8080/ssm158/js/exportExcel.js。解决所有静态资源引用必须加${ctx}script src${ctx}/js/exportExcel.js/script link relstylesheet href${ctx}/css/bootstrap.min.css5.4 现象MySQL 8.0 启动时报java.sql.SQLException: The server time zone value XXX is unrecognized原因MySQL 8.0 默认要求显式设置时区而本项目jdbc.properties中的jdbc.url是jdbc:mysql://localhost:3306/ssm158?useUnicodetruecharacterEncodingutf8缺少serverTimezoneGMT%2B8。解决修改src/main/resources/jdbc.propertiesjdbc.urljdbc:mysql://localhost:3306/ssm158?useUnicodetruecharacterEncodingutf8serverTimezoneGMT%2B8注意%2B是的 URL 编码不能写成GMT8否则 JDBC 驱动解析失败。6. 进阶技巧给 SSM158 加一层“隐身衣”——用 Filter 实现统一登录校验与操作日志系统自带登录但所有 Controller 方法都手动校验session.getAttribute(user) ! null既重复又易漏。更好的做法是用Filter统一拦截同时把“谁在什么时间访问了什么页面”自动记进数据库。这不是锦上添花而是上线前必须补上的生产级能力。6.1 编写 LoginFilter拦截未登录请求重定向到登录页新建com.kaic.ssm158.filter.LoginFilter.javapublic class LoginFilter implements Filter { private static final String[] EXCLUDE_PATHS {/login.jsp, /login, /css/, /js/, /images/}; Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; String uri req.getRequestURI(); // 放行静态资源和登录相关路径 boolean exclude false; for (String path : EXCLUDE_PATHS) { if (uri.contains(path)) { exclude true; break; } } if (exclude) { chain.doFilter(request, response); return; } // 检查 session 中是否有 user HttpSession session req.getSession(false); if (session null || session.getAttribute(user) null) { resp.sendRedirect(req.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } }配置web.xml在filter标签下添加filter filter-nameLoginFilter/filter-name filter-classcom.kaic.ssm158.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/*/url-pattern /filter-mapping这样所有非白名单路径都会被拦截无需在每个 Controller 里写if (session null) return redirect:/login.jsp。6.2 编写 LogFilter自动记录 URI、IP、耗时、用户不侵入业务代码LogFilter.javapublic class LogFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; long start System.currentTimeMillis(); // 记录前获取用户信息 String username anonymous; HttpSession session req.getSession(false); if (session ! null session.getAttribute(user) ! null) { User user (User) session.getAttribute(user); username user.getUsername(); } // 执行业务逻辑 chain.doFilter(request, response); // 记录后计算耗时写日志 long cost System.currentTimeMillis() - start; String uri req.getRequestURI(); String ip getClientIp(req); // 保存到数据库此处简化实际应调用 LogService Log log new Log(); log.setOperator(username); log.setOperation(访问 uri); log.setIp(ip); log.setCostTime((int) cost); log.setCreateTime(new Date()); // logMapper.insert(log); // 需在 Spring 容器中获取 Mapper Bean此处略 } private String getClientIp(HttpServletRequest req) { String ip req.getHeader(X-Forwarded-For); if (ip null || ip.length() 0 || unknown.equalsIgnoreCase(ip)) { ip req.getHeader(Proxy-Client-IP); } if (ip null || ip.length() 0 || unknown.equalsIgnoreCase(ip)) { ip req.getHeader(WL-Proxy-Client-IP); } if (ip null || ip.length() 0 || unknown.equalsIgnoreCase(ip)) { ip req.getRemoteAddr(); } return ip; } }配置web.xmlfilter filter-nameLogFilter/filter-name filter-classcom.kaic.ssm158.filter.LogFilter/filter-class /filter filter-mapping filter-nameLogFilter/filter-name url-pattern/*/url-pattern /filter-mapping技巧LogFilter必须在LoginFilter之后配置web.xml中顺序决定执行顺序否则未登录用户访问/employee/list时LogFilter会先执行此时session为空记录为anonymous符合预期。6.3 日志表优化为高频写入加索引避免拖慢主业务log表在doc/数据库设计.sql中定义为CREATE TABLE log ( id int(11) NOT NULL AUTO_INCREMENT, operator varchar(50) DEFAULT NULL, operation varchar(200) DEFAULT NULL, ip varchar(50) DEFAULT NULL, cost_time int(11) DEFAULT NULL, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;但线上运行后发现SELECT * FROM log WHERE create_time 2024-01-01极慢。原因是create_time无索引。立即执行ALTER TABLE log ADD INDEX idx_create_time (create_time); ALTER TABLE log ADD INDEX idx_operator_time (operator, create_time);前者加速按时间查询后者加速“查某人最近操作”——这是 HR 审计最常用场景。我上线前必做的三件事加 Filter、加索引、把所有System.out.println()换成log.info()。不是追求完美是让系统在你下班后还能自己扛住流量高峰、留下可追溯线索、出问题时 5 分钟定位到哪行代码。这套 SSM158 系统它不新但它像老式机械表——零件看得见、故障摸得着、修起来不求人。当你面对一个要明天上线、后天就要接受审计的内部系统时稳定比炫技重要一百倍。希望帮到你。本文还有配套的精品资源点击获取
