简介基于JSPServlet的宿舍管理系统是一套完整的JavaWeb课程设计项目主要面向计算机、电子信息等专业学生以及需要完成课程设计、期末作业或毕业设计的开发者。包内提供项目全部源码、数据库SQL文件和doc格式设计说明书可导入开发工具直接运行适合对照源码学习经典Servlet/JSP三层架构、DAO与Service层职责划分、前端与后端数据交互等知识点。压缩包共281个文件整体大小约4.66MB文件以Java类、JSP页面、HTML/CSS/JS前端资源为主同时包含SQL数据库脚本、项目配置文件和设计文档目录结构清晰便于分模块查阅。系统覆盖学生信息增删改查、宿舍分配选择、数据列表展示等典型功能源码命名规范、类与方法职责明确附带的doc设计说明书涵盖需求分析、数据库设计等章节可直接借鉴为课设报告素材。该资源已有165位用户学习对正在搭建JavaWeb项目、急需参考完整可用代码和文档的学生具有较高参考价值。1. jspservlet 宿舍管理系统为什么它至今还是 JavaWeb 课设的经典范本期末周最怕的不是写代码而是找到一个能跑得起来、讲得清楚的 JavaWeb 课设项目。这套基于 jspservlet 的宿舍管理系统就是那种一眼能看到完整链路的老牌范本源码、数据库脚本、设计说明书三件套齐全学生管理、宿舍查询、批量删除这类功能足够应付课程设计答辩又不至于像 Spring Boot 全家桶那样让人在讲台上无话可说。它适合两类人一是准备交 JavaWeb 大作业的在校生需要一份能复现、能讲原理的参考二是想快速扫一遍 Servlet 时代请求处理流程的初学者。压缩包解压后能直接导入 IDEA 跑起来不用改框架、不用配 Maven 依赖这对课设场景来说是最实在的。2. 先看骨架再动手Bean-Dao-Service-Servlet 四层结构与三张核心表2.1 从类名反推设计这份源码的分层比注释更诚实拿到压缩包先别急着导入 IDEA把里面的 class 文件列表过一遍整个项目的骨架就清楚了。StudentBean、DormDAoImpl、StudentDaoImpl、StudentServiceImpl、StudentAddServlet、StudentSelectServlet、DormSelectServlet、EmailUtil 这些名字不是随便起的它们恰好对应了 JSPServlet 时代最标准的分层实体、数据访问、业务逻辑、请求控制四处各司其职。这种命名习惯在课设项目里非常讨巧——老师扫一眼类名就知道你有没有分层意识。很多同学的课设是把 JDBC 代码直接写进 JSP 页面页面里塞满%脚本片段能跑但讲不出层次。这套项目的写法是把数据访问收敛到 DaoImpl业务判断收敛到 ServiceImplServlet 只做参数接收和页面跳转属于能在答辩时站得住脚的那种结构。分层对应类职责边界实体层StudentBean学生字段的封装与 student 表字段一一对应DAO 层StudentDaoImpl、DormDAoImplJDBC 连接、SQL 执行、结果集转对象业务层StudentServiceImpl参数校验、业务规则、调用 DAO 完成组合操作控制层StudentAddServlet、StudentSelectServlet、StudentSelectDelListServlet、StudentDelListServlet、DormSelectServlet接收请求参数、调用 Service、控制跳转工具类EmailUtil邮件发送等跨模块通用能力从这个表能看出一个规律一个实体配一个 DaoImpl一个业务域配一个 ServiceImpl一个操作配一个 Servlet。这种「一操作一 Servlet」的写法在课设里很常见虽然类数量看着多但每个类都短排查问题时顺着类名就能定位。比起把所有功能堆在一个doPost里这种拆法对新手友好得多。2.2 两条业务线学生管理和宿舍管理的数据流这个系统的业务可以拆成两条线。学生线是主干列表查询、添加学生、按条件筛选、删除学生宿舍线相对简单核心是 DormSelectServlet 做的宿舍查询与展示。两条线共用同一套数据库连接和页面跳转机制搞清楚任一条线的数据流另一条线自然就通了。学生线的完整请求路径是这样的浏览器访问学生列表 JSP → 页面发起查询请求 → StudentSelectServlet 接收参数 → 调 StudentServiceImpl → 调 StudentDaoImpl 执行 SQL → 返回 ListStudentBean → Servlet 把 List 放进 request 域 → forward 到列表页面 → JSP 用 JSTL 或脚本遍历渲染表格。这里值得留意的是跳转方式。查询和添加走的是forward转发URL 地址栏不变request 域里的数据能直接带到页面而删除操作走的是sendRedirect重定向地址栏变化request 域清空。很多课设翻车就翻在没分清这两者我后面第 5 章会专门讲。宿舍线相对简单DormSelectServlet 查出所有宿舍信息后转发到宿舍列表页。但它是宿舍管理系统的门面功能答辩演示时多半会先点开宿舍查询所以它的 SQL 写得好不好直接影响第一印象。2.3 数据库设计三张核心表与一对多关系压缩包里的 SQL 脚本是这个项目的另一份说明书。解压后打开数据库脚本核心表一般就三张学生表、宿舍表、管理员表。宿舍表与学生表是一对多关系一个宿舍住多个学生学生表里用宿舍编号字段做逻辑外键。学生表的设计决定了增删改查的实现难度。典型的课设学生表会包含学号、姓名、性别、专业、班级、宿舍编号这些字段。学号设为主键因为它在校园场景里天然唯一宿舍编号不建物理外键而是只存值这样删除宿舍时不会被外键约束卡住——这个取舍在课设答辩时可以说成「为了提高删除灵活性」。CREATE TABLE student ( id VARCHAR(20) PRIMARY KEY COMMENT 学号, name VARCHAR(50) NOT NULL COMMENT 姓名, gender VARCHAR(10) COMMENT 性别, major VARCHAR(50) COMMENT 专业, dorm_id VARCHAR(20) COMMENT 宿舍编号 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段建表语句里有两个关键点。第一是不用自增 id 而用学号做主键真实场景下学号是业务主键自增 id 反而多余。第二是CHARSETutf8mb4如果脚本里写的是utf8插入表情符号或者部分生僻字时会报Incorrect string value错误。用utf8mb4是现在的主流选择MySQL 5.5.3 以上都支持。宿舍表的结构更简单通常包含宿舍编号、楼栋、房间号、可住人数、已住人数。已住人数这个字段很有意思它要么由程序维护要么由COUNT(*)实时统计课设里一般选择前者来展示「你会写 UPDATE 关联更新」这个加分点。2.4 为什么不用 Spring Boot课设选型的现实逻辑你现在去 GitHub 搜宿舍管理系统十有八九是 Spring Boot Vue 的前后端分离项目那为什么还要选 jspservlet 这套因为课设的评分标准和真实项目不一样。大部分学校的 JavaWeb 课程教的就是 JSP、Servlet、JDBC 这三件套期末验收时老师会按教学大纲问问题Servlet 生命周期是什么request 和 session 的区别JDBC 的四个步骤如果你拿一个 Spring Boot 项目去答辩这些基础问题反而答不上来因为框架把细节都封装掉了。另外还有一层现实考虑Spring Boot 项目要配 Maven 仓库、配 Node 前端、配跨域光环境就把课设时间耗掉一半。而 jspservlet 项目只要一个 Tomcat 就能跑数据库用 MySQL 5.7 或 8.0 都行IDEA 里配置一次以后都是这个套路。选型不是越新越好而是越贴合评分标准越好。这份资源选择 JSPServlet 而不是 Spring Boot本身就是一种「过科导向」的合理选择。3. 从零部署到浏览器出页面环境配置、数据库导入与 Tomcat 启动3.1 版本搭配JDK 8、Tomcat 8.5 与 MySQL 的参数对照跑这个项目之前先把环境版本定死。JSPServlet 项目对版本敏感JDK 版本、Tomcat 版本、MySQL 驱动版本三者只要有一个错位启动时就会报莫名其妙的错。我建议按下面的组合来配组件推荐版本注意点JDK1.8Tomcat 8.5 对 JDK 8 支持最稳JDK 11 也能跑但没必要Tomcat8.5.x兼容 javax.servlet 包名不要用 Tomcat 10MySQL5.7 或 8.08.0 需要驱动版本和 URL 参数配合mysql-connector-java5.1.49 或 8.0.x5.7 配 5.x 驱动8.0 配 8.x 驱动IDEA2020 以后任意版本社区版就行不需要旗舰版Tomcat 10 之后的版本把javax.servlet迁移成了jakarta.servlet老项目的 import 语句会直接编译失败。这是今年很多同学翻车的重灾区——新下载的 Tomcat 10 配老课设项目一启动就报「程序包 javax.servlet 不存在」。MySQL 驱动也要分版本看。MySQL 5.7 用com.mysql.jdbc.DriverMySQL 8.0 要用com.mysql.cj.jdbc.Driver。如果项目里写死了旧的驱动类名连 8.0 数据库时启动会直接报驱动加载失败。3.2 导入数据库source 命令与连接配置修改数据库脚本是部署的第一关。解压后找到 .sql 文件打开看一眼确认是不是包含CREATE DATABASE语句。如果脚本里没有建库语句就需要手动建库再导入。mysql -u root -p Enter password: ******** mysql CREATE DATABASE dormitory DEFAULT CHARSET utf8mb4; mysql USE dormitory; mysql SOURCE D:/dormitory.sql;SOURCE后面跟的是 SQL 脚本的绝对路径Windows 下注意路径分隔符。导入完成后用SHOW TABLES;验证能看到 student、dormitory 这几张表就说明导入成功。这里有个细节如果你的 SQL 脚本里已经有CREATE DATABASE和USE语句就不要手动建库直接SOURCE整个文件即可否则会报数据库已存在。数据库连不上是部署阶段最常见的问题根源基本都在连接配置。老课设项目一般把连接参数写在db.properties或DBUtil.java里。找到配置文件改成你自己的数据库账号密码同时把 URL 里的参数补全。jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/dormitory?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8mb4 jdbc.usernameroot jdbc.password123456serverTimezoneAsia/Shanghai这个参数只对 MySQL 8.0 是必需的5.7 不加也能跑但建议统一加上省得换环境又踩时区坑。characterEncodingutf8mb4是中文不乱码的第一道保险这个参数决定了 Java 程序往数据库写中文时的编码方式如果漏掉即使页面显示正常数据库里存的也可能是乱码。3.3 IDEA 里跑起 JavaWeb 项目的配置要点环境配好、数据库导入之后最关键的步骤是把项目在 IDEA 里跑起来。很多同学在这里卡住不是因为代码有问题而是 IDEA 的部署配置不熟。先别急着点运行按钮按这个顺序来。第一步导入项目后检查 Project Structure快捷键CtrlAltShiftS里的 Artifacts确认有没有生成 Web Application: exploded 的部署包。没有的话手动添加把项目的 web 目录指定为 Web Resource DirectoryIDEA 会自动生成 lib 文件夹用于存放依赖 jar。第二步给项目添加 Tomcat 服务器。在 Run Configuration 里新建 Tomcat Server - LocalApplication Server 选择你本地的 Tomcat 8.5 路径。Deployment 标签页里把刚才的 exploded Artifact 加进去Application context 填/dorm或任意你喜欢的路径这个就是访问时的前缀。第三步启动前检查 Tomcat 的端口。默认 8080 如果被占用在 HTTP port 处改成 8081 或其他空闲端口同时把浏览器的访问地址同步改掉。启动后看到Connected to server日志再去浏览器访问http://localhost:8080/dorm/。如果能跳到登录页或首页部署就算通了如果白屏或 404多半是 Artifact 没配好而不是代码的锅。这里有个我自己的习惯每次启动前先确认左下角的 Artifacts 处于 exploded 状态而不是 war 包状态。war 模式每次改代码都要重新打包调试效率极低exploded 模式改完 JSP 刷新页面就生效这才是课设开发的正确姿势。4. 核心代码逐行拆学生增删改查的请求链路与参数配置4.1 添加学生从 JSP 表单到 StudentAddServlet 的完整链路添加学生是理解这个项目最好的入口因为它完整走过「JSP 表单 → Servlet 接收 → Service 处理 → Dao 插入 → 数据库」这条链路的每一环。先看控制层 StudentAddServlet 的doPost方法。protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String id request.getParameter(id); String name request.getParameter(name); String gender request.getParameter(gender); String major request.getParameter(major); String dormId request.getParameter(dormId); StudentBean student new StudentBean(); student.setId(id); student.setName(name); student.setGender(gender); student.setMajor(major); student.setDormId(dormId); StudentServiceImpl service new StudentServiceImpl(); boolean result service.addStudent(student); if (result) { response.sendRedirect(request.getContextPath() /StudentSelectServlet); } else { request.setAttribute(errorMsg, 添加失败); request.getRequestDispatcher(/studentAdd.jsp).forward(request, response); } }这段代码的逻辑非常直白接收五个参数、封装成 StudentBean、调 Service 层、根据结果决定是重定向到列表页还是转发回添加页。第一个注意点是request.setCharacterEncoding(UTF-8)必须在读取参数之前调用放错位置中文就乱码了。第二个注意点是添加成功后用的是sendRedirect而不是转发这样浏览器会重新发起一次请求列表页能拿到最新的数据同时地址栏会变成 list 页面的 URL刷新时不会重复提交表单——这个细节在答辩被问到「怎么防止表单重复提交」时可以直接用。Service 层的 addStudent 方法通常还会做一层参数校验比如判断学号是否为空、宿舍号是否存在。如果项目里没有这段逻辑你可以自己补上它是很好的答辩加分点。4.2 模糊查询StudentSelectServlet 里的 SQL 拼接与 request 域传值查询是课设项目里最能体现 JDBC 基本功的部分。StudentSelectServlet 的查询逻辑一般支持按学号、姓名做模糊匹配核心在于 SQL 的动态拼接。很多同学的查询是写死一条 SQL不支持带条件过滤改造一下就能多一个讲点。String keyword request.getParameter(keyword); String sql SELECT * FROM student WHERE 11; ListObject params new ArrayList(); if (keyword ! null !keyword.trim().isEmpty()) { sql AND (name LIKE ? OR id LIKE ?); String likePattern % keyword.trim() %; params.add(likePattern); params.add(likePattern); } PreparedStatement ps conn.prepareStatement(sql); for (int i 0; i params.size(); i) { ps.setObject(i 1, params.get(i)); } ResultSet rs ps.executeQuery();WHERE 11这种写法在动态 SQL 拼接里是常见技巧它让后面的每个AND子句都不需要判断是不是第一个条件。虽然性能上多了一个恒真条件但对这种小数据量的课设系统完全没有影响换来的是代码可读性的提升。另一处关键是用PreparedStatement加占位符?而不是字符串拼接这样既能防 SQL 注入又能在答辩时展示你有安全意识——这几乎是必考题。查询结果拿到后Servlet 把ListStudentBean放进 request 域转发给列表 JSP 页面遍历渲染。数据放进 request 域意味着这次请求结束数据就销毁刷新页面会重新查库这种设计对数据实时性要求不高的场景完全够用。如果你想做得更精细一点可以把ListStudentBean写进 session 域避免每次刷新都查库但那样会引入数据一致性问题课设阶段不建议这么做。4.3 批量删除StudentSelectDelListServlet 与重定向刷新批量删除是这套源码里比较有辨识度的一块。StudentSelectDelListServlet 的职责是查出要删除的学生列表给用户确认真正执行删除的是 StudentDelListServlet。这种「先查后删」的流程设计比直接点删除按钮再弹确认框更规范也更适合课设演示。String[] ids request.getParameterValues(ids); if (ids ! null ids.length 0) { StudentServiceImpl service new StudentServiceImpl(); boolean success service.deleteStudents(ids); if (success) { response.sendRedirect(request.getContextPath() /StudentSelectServlet); return; } } response.sendRedirect(request.getContextPath() /StudentSelectDelListServlet);getParameterValues拿到的是一个字符串数组对应页面上勾选的多个复选框的nameids。批量删除在 Service 层实现时一般用循环或IN语句拼接课设数据量小循环调用单条删除也能接受但如果想写得专业一点用DELETE FROM student WHERE id IN (?, ?, ...)一条 SQL 搞定更漂亮。删除成功后跳转到 StudentSelectServlet 的sendRedirect是这一节的核心考点。为什么不能用 forward因为转发是服务器内部跳转浏览器地址栏还是原来的 URL此时刷新页面会再次执行刚才的删除请求可能把刚删掉的数据再删一遍——如果数据库没有数据了就会报错。sendRedirect会让浏览器发一个全新的 GET 请求到列表页地址栏变成列表 URL刷新行为回归正常。这就是「删除后列表不刷新」问题的根源。4.4 EmailUtil工具类的边界与复用EmailUtil 在这个项目里是个容易被人忽略但答辩时很好讲的类。它的存在价值在于宿舍管理系统里经常有「提醒学生缴费」「通知宿舍调整」这类需求写一个邮件工具类做通用发送逻辑比在 Servlet 里直接写一大段邮件代码要干净得多。这个类封装的是 JavaMail 的发送流程。常见做法是提供一个静态方法接收收件人、主题、内容三个参数内部完成Session创建、MimeMessage组装、Transport.send发送三步。调用方只需要关心业务逻辑不用碰Properties配置的细节。要注意的是现在各大邮箱都要求授权码而不是登录密码来开启 SMTP 服务所以如果老师要求演示邮件功能你需要先去邮箱设置里开启 SMTP 并生成授权码把授权码配置到 EmailUtil 的常量里。演示时建议用一个自己可控的邮箱作为发件方收件人填自己的另一个邮箱这样当场就能看到邮件到达不用等。5. 课设高频翻车点排查JDBC、乱码、空指针三大类问题5.1 驱动加载失败ClassNotFoundException 的两种诱发场景现象Tomcat 启动时或点击第一个功能按钮时控制台抛出ClassNotFoundException: com.mysql.jdbc.Driver或java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver页面直接 500。原因这个错有两个常见诱因。第一是mysql-connector-java.jar根本没放进WEB-INF/lib目录只在项目里添加了 library 引用导致运行时 Tomcat 找不到驱动类。第二是 MySQL 是 8.0 版本但代码里Class.forName写的还是 5.x 时代的com.mysql.jdbc.Driver驱动类名不匹配。解决先把 jar 文件复制到项目的web/WEB-INF/lib目录下而不是只依赖 IDEA 的 External Libraries。再检查Class.forName和配置文件的 driver 类名MySQL 5.7 用com.mysql.jdbc.DriverMySQL 8.0 用com.mysql.cj.jdbc.Driver。改完重启 Tomcat如果还有问题在启动日志里搜ClassNotFound看是哪个类缺失。5.2 中文乱码请求、响应、JDBC URL、表字符集四处必须一致现象页面上输入中文姓名保存后数据库里存的是???或乱码或者数据库里中文正常但 JSP 页面显示乱码。原因中文乱码本质上只有一个原因——编码不一致。这个系统里有四处编码必须统一JSP 页面的pageEncoding、Servlet 里的request.setCharacterEncoding、JDBC URL 里的characterEncoding参数、数据库表的字符集。任何一处是 UTF-8 而另一处是 ISO-8859-1 或 GBK都会出现乱码。解决从上到下依次排查。先确认所有 JSP 页面头部统一写pageEncodingUTF-8再在 Servlet 读取参数之前加request.setCharacterEncoding(UTF-8)注意必须放在getParameter前面然后检查 JDBC URL 是否带了characterEncodingutf8mb4最后用 SQL 语句确认表字符集如果表已经建出来了需要执行修改语句。ALTER TABLE student CONVERT TO CHARACTER SET utf8mb4;这是一招「后悔药」如果表已经建好且里面已经有数据不用删表重建执行这一条就能把表和已有数据的字符集全部转成 utf8mb4。强烈建议在导入数据库脚本后立刻执行一次提前消除乱码隐患。5.3 删除后列表不刷新forward 与 sendRedirect 的语义差异现象删除一条学生记录后页面显示的还是旧数据必须手动刷新浏览器才能看到最新列表。原因这几乎是课设项目里最典型的逻辑错误——删除成功后用的是request.getRequestDispatcher(list.jsp).forward()转发而不是sendRedirect。转发是服务器内部行为请求只发了一次浏览器地址栏不变列表页每次显示的都是同一个 request 里的旧数据。解决先定位删除 Servlet 里的跳转代码把forward改成重定向。重点看sendRedirect的目标地址要带request.getContextPath()前缀因为重定向是让浏览器重新发起请求不带上下文路径会 404。这也是我在 4.3 节的代码里强调request.getContextPath() /StudentSelectServlet的原因。5.4 项目部署后 404IDEA 里 web 目录与 artifact 的配置错误现象Tomcat 启动了日志显示Connected to server但浏览器访问http://localhost:8080/项目名/时 404或者访问 JSP 页面能打开但访问 Servlet 地址 404。原因这个 404 和代码无关是部署配置的问题。常见的是 IDEA 里没有把web/WEB-INF目录正确标记为 Web Resource Directory导致编译后的 artifact 里根本没有 JSP 页面和配置文件。另一种情况是 Application context 设置的和实际访问路径不一致。解决打开 Project Structure 的 Artifacts 面板确认 Output Layout 里有\WEB-INF\classes和\WEB-INF\lib没有的话手动加。然后在添加 JSP 页面时留意 Source 目录是否指向了web文件夹。改完以后重新 Build Artifact 再重启 Tomcat。如果你的项目是从别的机器拷贝过来的这一步几乎必做。6. 答辩加分项统一编码、通用分页与演示前的数据验证6.1 用一个 Filter 把编码和日志一起解决既然第 5 章讲了乱码问题的多处排查一个一劳永逸的做法是加一个编码过滤器。所有请求先进 Filter统一设置request和response的编码这样就不用每个 Servlet 里都写request.setCharacterEncoding(UTF-8)了。WebFilter(/*) public class EncodingFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { request.setCharacterEncoding(UTF-8); response.setCharacterEncoding(UTF-8); chain.doFilter(request, response); } }这个过滤器用WebFilter(/*)注解配好就不用去 web.xml 里加映射了。chain.doFilter(request, response)是放行逻辑它后面的代码会在整个请求处理完之后执行如果你想在过滤器里打印每个请求的 URI 日志就写在doFilter之后。6.2 给查询加上分页的思路如果列表页每次查出来几十上百条学生数据整个页面拉得很长演示效果不佳。加分做法是做一个简单的分页。核心思路是先COUNT(*)查总条数再除以每页条数得到总页数最后用LIMIT offset, size查当前页数据。常见做法是用 PageBean 封装页码、每页条数、总条数、当前页数据列表这四样东西。SQL 部分把原来的SELECT * FROM student WHERE 11加上LIMIT ?, ?两个占位符第一页就是LIMIT 0, 10第二页LIMIT 10, 10。页面底部渲染「上一页/下一页」链接时把页码参数拼到 URL 上就行。这个改造点在答辩时非常出彩因为它既展示了 SQL 功底又展示了面向对象封装能力。6.3 演示前 15 分钟必做的数据验证清单答辩翻车往往不是代码坏了而是演示数据不够典型。用默认的几条测试数据演示老师看不出系统能处理什么场景。演示前建议按这个清单过一遍学生表里至少准备三组有区分度的数据一组中文姓名含生僻字、一组学号格式规范、一组没有分配宿舍。这样演示查询时输入不同的关键词都能命中结果演示删除时也不会把全部数据删光。宿舍表里保证至少有一个宿舍的已住人数和可住人数不一致方便讲解「宿舍容量」相关的功能。数据库里最好留一条性别字段有代表性、专业字段完整的记录。现场老师如果随机输入一个关键词搜索页面能有反馈而不是空空如也——这个细节直接影响演示节奏。我从第一次课设答辩因为演示时删光了所有数据、现场一片空白之后就养成了一个习惯每次演示前强制重新导入一遍 SQL 脚本用脚本里的初始数据兜底宁可多花五分钟恢复数据也绝不让现场出现「查无此人」的尴尬。这个习惯后来带到了工作里每次上线前都要跑一遍数据校验脚本才安心。希望这份 jspservlet 宿舍管理系统的拆解笔记能帮你在课设季少走几条弯路把精力留给真正值得钻研的代码细节。本文还有配套的精品资源点击获取