每个学Java Web的人几乎都会在课程设计里遇到“JSP课表查询系统”这个命题。说它难吧无非是查数据库然后展示逻辑上不复杂说它简单吧真正动手写过的人都知道页面一多、条件一组合光是参数传递和乱码问题就能磨掉一下午。这个项目是典型的入门级Web应用但它把小型的请求-响应链路、数据库交互、表单处理、结果渲染全部串在了一起适合作为课程设计题目也适合想快速走通Java Web基础流程的初学者。这篇文章就围绕一个JSP课表查询系统从需求拆解、数据库建模、页面实现到部署调试和常见坑位整理一遍。文中的表结构和代码都来自我做类似项目时沉淀下来的方案你可以直接照着搭也可以在你自己的课设基础上做增删改。1. 项目整体思路为什么用JSP做课表系统1.1 课表查询系统的真实业务场景课表查询系统本质上是对课程数据的检索和呈现。学校里常见的场景是教务处把课表数据录入系统后学生和老师需要按照各种条件快速找到课程。比如学生想知道“周一上午第一讲有哪些课”老师想知道“自己这周在第四教学楼哪里有课”教务员则可能需要按教室查课看看空闲时段。这些需求汇总起来就是按星期、按教师、按教室或者几个条件组合查询。和普通的信息列表不同课表数据有一个特殊性一门课程往往不只一条记录。比如《大学英语》可能分别在周二第1-2节和周四第3-4节上课数据库里就要存两条记录。更麻烦的是单双周和起止周的情况比如某课程只在第3周之后才开或者隔周上课。如果把这些维度全部做进去系统复杂度会明显上升。所以做课表系统时第一步不是写代码而是把业务规则梳理清楚否则后面改表结构会非常痛苦。1.2 技术栈选型JSP、Servlet、JDBC怎么分工JSP课表查询系统最常见的组合是JSP Servlet JDBC MySQL。JSP负责把数据渲染成HTML页面Servlet接收浏览器发来的请求并做逻辑跳转JDBC负责读写MySQL数据库。这套分工很清晰用户在页面上选条件点查询浏览器发请求给ServletServlet调DAO层查询数据库拿到结果塞进request域再转发到JSP页面JSP用EL表达式和JSTL标签把数据循环输出到表格里。为什么选JSP而不是更现代的VueSpringBoot两种考虑一是大部分课程设计的环境就是TomcatMySQLJSP直接扔进webapps目录就能跑部署成本最低二是JSP能直观展示一次HTTP请求从浏览器到服务器再到页面的完整流转对理解后端基础有不可替代的作用。等做完这个项目再切Spring Boot你会发现很多概念是相通的。JSP有两个容易踩的坑。第一JSP本质上是Servlet页面第一次被访问时需要编译重启Tomcat后第一次请求会略慢这很正常第二JSP里如果嵌了大量Java脚本片段就是那种% %的写法后期维护会非常难受所以下面的示例代码中我尽量用EL和JSTL来替代脚本片段。2. 数据库设计与查询条件梳理2.1 课程表结构设计的关键点数据库设计决定了查询系统的上限。一个典型的课表数据表可以设计成下面这样CREATE TABLE course ( id INT PRIMARY KEY AUTO_INCREMENT, course_name VARCHAR(100) NOT NULL COMMENT 课程名称, teacher_name VARCHAR(50) COMMENT 教师姓名, classroom VARCHAR(50) COMMENT 教室名称, week_day INT COMMENT 星期1表示周一7表示周日, class_period INT COMMENT 节次1表示第1节, start_week INT COMMENT 起始周, end_week INT COMMENT 结束周, course_type VARCHAR(20) COMMENT 课程类型 ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有几个字段设计上的细节值得说明。week_day用数字而不是“周一”“周二”这种字符串好处有二一是查询时可以用整数精确匹配避免字符串比较带来的索引失效和大小写问题二是在页面上做下拉选择框时数字和选项值可以直接对应省一层转换。class_period同理用数字表示第几节。start_week和end_week是容易被忽略的字段但它们在真实课表场景里非常关键。一门课可能是第2周到第16周的每周一都有那么这里就存2和16。如果要支持单双周还可以加一个week_type字段0表示全周1表示单周2表示双周。如果课程设计时间有限先做成全周模式也可以但字段还是建议预留不然以后补需求要动表结构。索引方面课表系统的查询条件集中在teacher_name、classroom、week_day这三个字段上。教师和教室一般用等值匹配星期也是等值匹配所以可以考虑加一个组合索引ALTER TABLE course ADD INDEX idx_query (teacher_name, classroom, week_day);实际使用中如果数据量就几百条索引作用不明显但这是一个好的建模习惯。2.2 三种常见查询条件的组合方式课表查询系统最常见的三种查询方式是按教师姓名查、按教室查、按星期查。真实使用中这三个条件经常组合比如“张三老师在周一有哪些课”或者“第三教学楼501在周二有哪些课”。组合查询的核心是动态拼接SQL。所谓动态拼接就是根据用户实际提交的参数决定WHERE子句里加哪些条件。常见做法是使用一个恒真条件垫底SELECT * FROM course WHERE 11然后逐个判断参数有值就追加条件。这样做的好处是代码结构清晰不会出现“第一个条件要不要带AND”的尴尬问题。对应的Java DAO层代码可以这样写public ListCourse queryCourses(String teacherName, String classroom, String weekDay) { StringBuilder sql new StringBuilder(SELECT * FROM course WHERE 11); ListObject params new ArrayList(); if (teacherName ! null !teacherName.trim().isEmpty()) { sql.append( AND teacher_name LIKE ?); params.add(% teacherName.trim() %); } if (classroom ! null !classroom.trim().isEmpty()) { sql.append( AND classroom ?); params.add(classroom.trim()); } if (weekDay ! null !weekDay.trim().isEmpty()) { sql.append( AND week_day ?); params.add(Integer.parseInt(weekDay.trim())); } // 执行PreparedStatement查询并封装结果 }这里有几个细节必须注意。教师姓名使用LIKE模糊查询是因为用户可能只记得姓名的一部分但模糊查询无法有效利用索引所以如果字段要支持模糊检索最好把通配符只加在末尾写成teacher_name LIKE ?参数值为张%这样在InnoDB下还能走索引。不过课表数据量通常不大写%张%问题也不大。参数传递必须要用PreparedStatement的占位符而不是直接拼接字符串。很多人初学的时候喜欢写SELECT * FROM course WHERE teacher_name teacherName 如果用户输入一个包含单引号的内容SQL语句就会被破坏这就是经典的SQL注入漏洞。用?占位符让JDBC驱动替你处理转义是从入门开始就要坚持的习惯。星期参数从页面传来时是字符串但数据库字段是INT所以要做Integer.parseInt()转换。这里有个容易报错的地方如果用户没有选择星期前端可能传空字符串转换前要判空。3. 页面展示与按条件刷新的实现细节3.1 查询表单与结果列表的页面布局页面布局遵循一个朴素原则查询条件放在顶部结果表格放在下方。查询表单有几个控件教师姓名输入框、教室输入框、星期下拉选择框以及一个查询按钮。表单的method属性这里建议用GET而不是POST。原因是查询操作是幂等的URL里带上参数后会生成一个可收藏、可分享的链接别人点开这个链接就能看到同一份查询结果对于课表这种查询类功能非常实用。比如收藏链接course/query?teacherName张三weekDay1下次打开直接看到周一张三的课。页面代码中用EL表达式回显已选条件对用户体验很重要。用户查询了“周三”的课程后页面上“星期”下拉框应该还是选中的“周三”而不是回归到默认的“请选择”。实现方式很简单在option标签里做一下比较select nameweekDay option value请选择星期/option c:forEach begin1 end7 varday option value${day} ${param.weekDay day ? selected : }周${day}/option /c:forEach /select注意这里用${param.weekDay}可以直接取出请求参数不需要在Servlet里再手动塞一份到request域非常省事。3.2 用EL和JSTL替代JSP脚本片段传统的JSP写法喜欢在页面里写% ListCourse list ...; for (...) { %这种写法的问题在于页面逻辑和Java代码强耦合改一个样式都可能要碰Java代码而且嵌套的脚本片段极容易写错分号。更好的做法是用JSTL的c:forEach标签配合EL表达式遍历结果集。Servlet在查询完成后把结果列表放到request域req.setAttribute(courseList, courseList); req.getRequestDispatcher(/course_list.jsp).forward(req, resp);JSP页面中对应的输出逻辑c:if test${empty courseList} tr td colspan6没有查询到符合条件的课程/td /tr /c:if c:forEach items${courseList} varcourse tr td${course.courseName}/td td${course.teacherName}/td td${course.classroom}/td td周${course.weekDay}/td td第${course.classPeriod}节/td td${course.startWeek}-${course.endWeek}周/td /tr /c:forEachEL表达式访问模型对象的属性本质上是调用对象的getter方法所以JavaBean里必须为每个字段写好getter和setter这也顺带养成了封装属性的习惯。使用JSTL前记得在JSP页面顶部引入标签库% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %并把jstl-1.2.jar放进WEB-INF/lib目录。3.3 空数据提示与前端样式处理很多初学阶段的课表查询系统页面就是一个捷蓝底的表格什么样式都没有查询没有结果时表格直接空在那里读者根本不知道是查询失败还是真的没数据。给页面套一点基础CSS外加空数据提示能明显提升完成度和观感。空数据那里可以在c:if判断后用一整行合并单元格来显示提示而不是让表格区域空白。样式上也不需要什么框架几条内嵌CSS或者一个style.css就够了body { font-family: Arial, sans-serif; margin: 40px; } .table { width: 100%; border-collapse: collapse; } .table th, .table td { border: 1px solid #ddd; padding: 8px; text-align: center; } .table th { background-color: #f2f2f2; }实际做项目时我的习惯是先把结果表格做出来让逻辑跑通再回头调样式。避免一开始就纠结像素级对齐把核心查询功能晾在一边。4. 实操过程从建库到跑通全流程4.1 环境准备与项目骨架搭建开发工具上我建议使用Eclipse或者IDEA企业版两者都内置了对Tomcat的支持。版本组合建议是JDK 8 Tomcat 9 MySQL 5.7这是最稳的组合也是很多课程设计机房的通用环境。如果自己电脑装的是MySQL 8注意JDBC驱动要用mysql-connector-java 8.0.x驱动类名是com.mysql.cj.jdbc.Driver和5.x版本的com.mysql.jdbc.Driver不一样。新建一个动态Web项目后目录结构如下src/main/java com.demo.course.entity.Course com.demo.course.dao.CourseDao com.demo.course.servlet.CourseQueryServlet com.demo.course.util.DBUtil src/main/webapp course_list.jsp WEB-INF/lib/mysql-connector-java.jar WEB-INF/web.xml如果你的IDE不区分src/main/java这种Maven结构那就是普通的src文件夹下建包本质上是一样的。WEB-INF/lib目录下不要忘记拷贝JDBC驱动jar包很多人数据库连接报错都和这一项有关。4.2 核心代码实现实体类Course就是一个纯粹的JavaBean。注意JSP里用EL表达式读取属性所以每个属性必须有getter/setterpublic class Course { private int id; private String courseName; private String teacherName; private String classroom; private int weekDay; private int classPeriod; private int startWeek; private int endWeek; private String courseType; // 省略 getter 和 setter }数据库工具类DBUtil负责获取连接。连接参数里的编码和时区设置是很多乱码和连接报错的根源建议初始化就配好public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/course_db?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai; private static final String USER root; private static final String PASSWORD 123456; static { try { Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }注意serverTimezoneAsia/Shanghai这个参数。MySQL 8的JDBC驱动默认要求设置服务器时区如果不加会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized之类的错误。这个报错信息里出现乱码别慌就是时区问题。Dao层CourseDao的主要方法就是queryCourses它接收教师、教室、星期三个参数动态拼SQL用PreparedStatement执行然后通过ResultSet封装成Course对象列表public ListCourse queryCourses(String teacherName, String classroom, String weekDay) { ListCourse list new ArrayList(); StringBuilder sql new StringBuilder(SELECT * FROM course WHERE 11); ListObject params new ArrayList(); // 拼接条件的代码同上面第2.2节 // 这里省略重复部分 try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql.toString())) { for (int i 0; i params.size(); i) { if (params.get(i) instanceof Integer) { ps.setInt(i 1, (Integer) params.get(i)); } else { ps.setString(i 1, (String) params.get(i)); } } try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Course course new Course(); course.setId(rs.getInt(id)); course.setCourseName(rs.getString(course_name)); course.setTeacherName(rs.getString(teacher_name)); course.setClassroom(rs.getString(classroom)); course.setWeekDay(rs.getInt(week_day)); course.setClassPeriod(rs.getInt(class_period)); course.setStartWeek(rs.getInt(start_week)); course.setEndWeek(rs.getInt(end_week)); course.setCourseType(rs.getString(course_type)); list.add(course); } } } catch (SQLException e) { e.printStackTrace(); } return list; }这个类里用到了JDK 7的try-with-resources语法连接、PreparedStatement、ResultSet都自动关闭省去finally里一堆close的样板代码。Servlet层CourseQueryServlet负责接收请求参数并调DAOWebServlet(/course/query) public class CourseQueryServlet extends HttpServlet { private CourseDao courseDao new CourseDao(); Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String teacherName req.getParameter(teacherName); String classroom req.getParameter(classroom); String weekDay req.getParameter(weekDay); ListCourse courseList courseDao.queryCourses(teacherName, classroom, weekDay); req.setAttribute(courseList, courseList); req.setAttribute(queryTeacherName, teacherName); req.setAttribute(queryClassroom, classroom); req.setAttribute(queryWeekDay, weekDay); req.getRequestDispatcher(/course_list.jsp).forward(req, resp); } }这里用WebServlet注解来映射URL省去web.xml里配置Servlet的繁琐流程。使用注解时记得检查项目是不是Servlet 3.0及以上版本Tomcat 7之后都支持。JSP页面就是前面第3节里梳理的那一套用c:forEach遍历courseList需要特别注意的是表单提交路径和Servlet映射保持一致form actioncourse/query methodget表单里三个控件的name属性必须是teacherName、classroom、weekDay和Servlet里getParameter的参数名严格对应。这个地方经常有同学把name写成teacher或者week结果Servlet接到的全是null。4.3 部署与自测把项目打成war包或者直接在IDEA里配置Run on Server启动Tomcat后浏览器访问http://localhost:8080/项目名/course/query。先不做任何条件查询看列表能否显示出全部课程然后分别测试只选星期、只输入教师姓名、教师加教室组合查询再对比数据库里的原始数据确认筛选逻辑正确。自测时最容易忽略的是“空条件查询”这个场景。用户一进来表单是空的点击查询按道理应该显示所有课程。因为queryCourses里三个参数都是空字符串动态SQL就退化为WHERE 11查出来就是全表数据这符合预期。如果不想让空查询展示全表可以在Servlet里判断一下三个参数都为空时直接返回提示这个看具体需求。还有一个常见问题是修改了Java代码后页面不生效。Tomcat默认开启了JSP的热部署但修改Java类后通常需要重启或重新部署。多模块项目里如果改了CourseDao只刷新浏览器是不行的必须重新编译部署。这一点在自测时会浪费不少时间最好养成“改Java就重启改JSP就刷新”的习惯。5. 常见问题与排查技巧实录5.1 数据库连接失败的排查路径数据库连不上是这类项目最常见的报错。首推的排查顺序就是看异常信息的第一行。ClassNotFoundException说明缺失com.mysql.cj.jdbc.Driver这个类大概率是JDBC驱动jar包没有放到WEB-INF/lib目录下或者放了对位置但没刷新项目的Build Path。确认方法是解压war包看不看得到这个jar或者在IDE的项目依赖里找得到。Communications link failure说明网络层面连不上数据库。先确认MySQL服务有没有启动。Windows下在服务列表里看MySQL进程或者用命令行netstat -ano | findstr 3306看端口有没有监听。然后确认连接URL里的端口号和数据库名是否正确。URL里默认3306端口如果你本机的MySQL改过端口必须同步改URL。数据库名course_db也必须提前创建好否则会报Unknown database。Access denied for user说明用户名或密码错误也可能是指定主机不允许该用户连接。本地开发直接把MySQL的root密码填进DBUtil就行。这里有个经验数据库密码建议先用文本文件记一下别随手写的密码下个项目就不记得了回头查起来非常浪费时间。连接失败时还有一个隐藏问题反复开启连接但没有正确关闭导致连接数耗尽。初学阶段代码里容易漏掉close尤其在异常分支里。后面数据量大了一定要引入数据库连接池比如DBCP或HikariCP后面还会提到。5.2 中文乱码的处理思路乱码问题几乎每个中文Web项目都会遇到表现形式也五花八门。对症下药的关键是理清乱码发生在哪一层。页面上的中文乱码大多是JSP文件本身的编码和contentType里的编码不一致。一般在JSP第一行添加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %这样输出响应就是UTF-8。同时JSP文件在IDE里保存时也要选UTF-8编码这两处只要有一处不一致页面就会出问题。查询参数里的中文乱码问题出在请求解码。POST请求可以在Servlet里先调用req.setCharacterEncoding(UTF-8)注意要在读取任何参数之前调用才有效。GET请求的乱码则是Tomcat用默认ISO-8859-1去解码URL参数导致的解决方式是在Tomcat的server.xml里的Connector节点上添加URIEncodingUTF-8或者更推荐在代码里做一次转码new String(teacherName.getBytes(ISO-8859-1), UTF-8)。不过后者属于补丁写法有条件还是改配置更干净。数据库端乱码相对隐蔽。如果插入的数据是UTF-8读取出来却是问号多半是数据库连接URL缺少characterEncodingutf8参数或者表本身的CHARSET不是utf8mb4。把建表语句里的DEFAULT CHARSETutf8mb4加上再把URL参数补全数据库乱码基本能解决。5.3 查询无数据的排查顺序最让人沮丧的是日志不报错页面也正常渲染但表格就是没有数据。我的排查顺序是这样的先直接在数据库客户端工具里执行那条动态拼接出来的SQL看能不能查到记录。如果这条SQL在工具里返回空那就是数据本身满足了不条件页面逻辑没问题如果SQL返回正常数据问题就出在Java封装或JSP展示环节。常见问题之一是ResultSet里的列名和实体类字段对不上。数据库里习惯用course_nameJSP里用${course.courseName}中间的映射靠SQL里rs.getString(course_name)赋值如果数据库列名写错那一行数据要么赋默认值要么抛出异常。经验是用SELECT course_name AS courseName来对齐别名省得在DAO里反复检查下划线转驼峰。另一个问题是JSP页面可能访问了不存在的属性名。比如Servlet里放的是courseListJSP里写${courseList}这两处必须完全一致。拼写不一致时EL表达式会静默输出空字符串不会报错这就导致你看到页面有结构但没数据特别迷惑。排查时在JSP里临时加一句${courseList}输出能直观看到request域里到底有没有这个对象。实用调试技巧在Servlet的doGet方法末尾打印一下courseList.size()确认查到多少条。在JSP页面还可以加个隐藏的% page importjava.util.List %配合脚本片段暂时代替EL输出定位出问题后再删掉。这类“打日志式”的调试方法虽然土但比通篇看代码猜效果快得多。5.4 常用问题速查表现象可能原因解决方向500报错提示找不到类缺JDBC驱动或Servlet类没编译检查WEB-INF/lib下的jar包和项目编译输出连接失败Communications link failureMySQL未启动或URL端口错误确认3306端口监听和URL数据库名Access denied用户名或密码错误核对DBUtil里USER和PASSWORDJSP页面中文乱码文件编码和contentType不一致统一UTF-8编码查询参数中文乱码请求解码不是UTF-8配置URIEncoding或req.setCharacterEncoding查询无数据但SQL正确参数名不一致或属性名拼写错误核对form的name与Servlet参数名页面数据不更新改了Java类但没有重新部署重启Tomcat或重新部署项目第一次访问页面极慢JSP编译开销正常现象预热后就好数据库中文显示为问号表字符集不是utf8mb4修改表或建表时的CHARSET6. 后续扩展把课表系统做得更实用6.1 引入MVC分层思维这个项目的代码已经初步分了实体、DAO、Servlet、JSP基本上就是MVC的雏形。但有几个地方还可以再优化Servlet里还承担了部分参数校验和页面跳转控制未来可以抽一个独立的CourseService层把业务逻辑从Servlet里剥出来。课程表查询中如果有“当前周次自动过滤”这种规则放在Service层就比放在Servlet里清晰得多。MVC分层不是形式主义。当系统后期要加管理员登录、课程增加删除、上传课表Excel等功能时没有Service层的项目会迅速变成一团乱麻。Servlet里塞满各种逻辑DAO里混着业务判断改一个功能要牵扯七八处。趁这个小项目还简单养成“Controller薄、Service纯、DAO专”的编码习惯后面学Spring会非常顺畅。6.2 把查询改成异步刷新目前的交互形式是点击查询后整个页面刷新体验上还可以接受。如果想更现代一点可以用fetch或axios发送异步请求后端改成一个返回JSON的接口前端拿到数据后通过DOM操作更新表格。这种改造需要Servlet端的配合把原来的JSP转发改成resp.setContentType(application/json)手动把List转成JSON字符串输出。查询条件回显在异步模式下要稍做调整但整体改造不算难。做完这个扩展后你相当于同时掌握了前后端分离的基础交互模式这对就业或者后续学习框架都有帮助。6.3 引入连接池和分页当前代码每次查询都通过DriverManager.getConnection创建连接数据库连接是稀缺资源频繁创建销毁对性能没有好处。连接池的原理可以理解成提前准备好一批连接放池子里谁要用就去池子领取用完归还而不是真正关闭。常见的连接池有DBCP、C3P0、Druid、HikariCP配置方式差别不大。以HikariCP为例引入jar包后把DBUtil的getConnection改从HikariDataSource获取几行配置就能把连接管理交给池子。分页则是另一个刚需。当课表数据量变大以后一次性把全部记录查询出来并渲染到页面上既不经济也影响体验。分页的核心是计算出偏移量比如每页10条查询第3页就是LIMIT 20, 10。动态SQL里需要加上这两个参数同时JSP页面上要渲染出上一页、下一页和页码链接。我一直觉得JSP课表查询系统是个被低估的练手项目。它不像商城系统那样庞杂也不像留言板那样简单刚好卡在“能把基础链路走完”和“有业务规则可挖掘”之间。你把它做扎实了数据库设计、动态SQL、Servlet流转、EL表达式这些Java Web的基础技能就算真正立住了。后面再接触框架很多概念只是换了一种写法底层的请求处理模型和数据库交互原理不会变。我在做类似项目时最深的体会是不要急着把代码堆完先把查询条件、字段编码、部署环境这些易错点摸清楚后面调试的时间至少能少一半。
