简介这份同学录系统Java Web期末项目源码包面向高校计算机相关专业学生与Java Web初学者用于课程设计参考、期末项目实战及技术栈综合练习。项目采用Servlet与JSP构建前后端结合HTML/CSS/JavaScript、jQuery与Bootstrap完成页面交互并配套student.sql、user.sql两个数据库脚本覆盖MySQL建表、Session登录状态管理、权限控制及MVC分层设计等典型知识点适合用来理解从请求处理到数据持久化的完整链路。压缩包共48个文件以java源码与class编译文件为主另含jsp页面、jar依赖、sql脚本、css样式、properties配置及xml描述文件整体约1021KB结构紧凑便于本地导入IDE后对照调试。目前已有4372人学习下载读者可借此梳理Servlet与JSP协同、数据库初始化及Tomcat部署的排错思路是课程设计阶段较为实用的参考案例。1. 同学录系统 JavaWeb 期末项目一份能直接跑通的课程设计参考如果你正在为 JavaWeb 课程设计发愁或者想找一个结构完整、功能闭环、代码量适中的练手项目这份同学录系统值得拆开看看。它本质上是一个基于 JavaWeb 技术栈的信息管理系统核心功能围绕“同学信息录入、班级管理、留言互动、用户登录注册”展开适合刚学完 Servlet、JSP、JDBC 的开发者用来理解一个完整 Web 项目从请求到响应的全链路。项目采用典型的前后端不分离架构前端页面用 JSP 渲染后端用 Servlet 处理业务逻辑数据库用 MySQL 存储数据整体代码量不大但五脏俱全。对于需要交期末作业的同学来说它可以直接作为基础模板对于想巩固 JavaWeb 基础的开发者它也是一份不错的“逆向学习”材料——把每个模块拆开就能看清 MVC 模式在真实项目里到底怎么落地。2. 技术栈与目录结构先看清项目骨架再动手2.1 技术选型与运行环境这个项目没有用 Spring 全家桶也没有上 Maven 多模块而是最朴素的 JavaWeb 组合Servlet JSP JDBC MySQL Tomcat。这种选型在课程设计里非常常见好处是依赖少、配置简单、调试直观坏处是所有轮子都得自己造。具体版本上常见做法是 JDK 8 或 11、Tomcat 8.5 或 9.0、MySQL 5.7 或 8.0IDE 用 Eclipse 或 IntelliJ IDEA 都行。项目结构是标准的 Eclipse 动态 Web 项目布局没有用 Maven 管理依赖所以WEB-INF/lib下会直接放mysql-connector-java的 jar 包。如果你习惯用 Maven可以自己转成pom.xml但要注意 Servlet 和 JSP 的依赖 scope 要设成provided因为 Tomcat 已经自带了。提示MySQL 8.0 和 5.7 的驱动类名不同8.0 用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver连接 URL 也要加时区参数否则会报时区错误。2.2 目录结构逐层拆解项目根目录下主要分三块src放 Java 源码WebContent或web放前端资源和配置文件WebContent/WEB-INF放受保护的配置和依赖。src下面按包名分层常见的是com.xxx.entity放实体类、com.xxx.dao放数据库操作、com.xxx.servlet放控制器、com.xxx.util放工具类。WebContent下面有css、js、images静态资源以及一堆.jsp页面。WEB-INF下面有web.xml和lib目录。这种分层方式虽然简单但已经体现了 MVC 的雏形JSP 是 ViewServlet 是 ControllerDAO 和 Entity 是 Model。# 典型目录结构示意 src/ com/example/entity/ # 实体类对应数据库表 com/example/dao/ # 数据访问层封装 JDBC 操作 com/example/servlet/ # 控制器处理请求和跳转 com/example/util/ # 工具类如数据库连接、编码过滤 WebContent/ css/ # 样式文件 js/ # 脚本文件 images/ # 图片资源 index.jsp # 首页 login.jsp # 登录页 register.jsp # 注册页 studentList.jsp # 同学录列表页 WEB-INF/ web.xml # 部署描述符 lib/ # 第三方 jar 包2.3 数据库表设计与实体映射同学录系统的数据库一般不会太复杂核心表就三四张用户表、同学信息表、班级表、留言表。用户表存登录账号和密码同学信息表存姓名、电话、地址、生日等字段班级表存班级名称和入学年份留言表存留言内容和时间。实体类就是这些表的 Java 映射字段名和表字段一一对应类型上注意日期用java.util.Date或java.sql.Date数值用Integer或Long。DAO 层里每个实体对应一个 DAO 类里面写增删改查方法用PreparedStatement防止 SQL 注入。-- 同学信息表建表语句示例 CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender VARCHAR(10), phone VARCHAR(20), address VARCHAR(200), birthday DATE, class_id INT, remark VARCHAR(500) );注意建表时字段长度要留够尤其是地址和备注不然后面插入数据会报“Data too long”错误。字符集统一用utf8mb4避免中文乱码。3. 核心模块拆解一个请求从进入到返回的完整链路3.1 登录模块从表单提交到 Session 写入登录是理解整个项目请求链路的入口。用户在login.jsp输入用户名和密码表单以 POST 方式提交到LoginServlet。Servlet 里先设置请求编码为 UTF-8然后取参数、调 DAO 查数据库、比对密码成功就把用户信息写进HttpSession然后重定向到列表页失败就带错误信息转发回登录页。这里的关键是 Session 的使用——后续所有需要登录才能访问的页面都要先检查 Session 里有没有用户信息没有就踢回登录页。// LoginServlet 核心代码 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDao userDao new UserDao(); User user userDao.findByUsername(username); if (user ! null user.getPassword().equals(password)) { HttpSession session request.getSession(); session.setAttribute(currentUser, user); response.sendRedirect(studentList.jsp); } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); } }逻辑说明request.setCharacterEncoding(UTF-8)必须放在取参数之前否则中文用户名会乱码。findByUsername返回 null 表示用户不存在返回对象但密码不匹配表示密码错误这里为了简化没有区分提示。sendRedirect和forward的区别要清楚重定向会改变浏览器地址栏转发不会。参数方面username和password必须和 JSP 表单里的name属性完全一致大小写敏感。3.2 同学信息管理列表查询与分页逻辑同学信息管理是项目里代码量最大的模块包含列表展示、添加、编辑、删除四个操作。列表页studentList.jsp通过 JSTL 的c:forEach遍历 Servlet 传过来的ListStudent每行显示姓名、电话、班级等字段后面跟编辑和删除按钮。分页逻辑是课程设计的加分项常见做法是在 DAO 里写两个方法一个查总记录数一个查当前页数据用LIMIT和OFFSET实现。// StudentDao 分页查询方法 public ListStudent findByPage(int page, int pageSize) { ListStudent list new ArrayList(); String sql SELECT * FROM student LIMIT ? OFFSET ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, pageSize); ps.setInt(2, (page - 1) * pageSize); ResultSet rs ps.executeQuery(); while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setName(rs.getString(name)); s.setPhone(rs.getString(phone)); // 其他字段省略 list.add(s); } } catch (SQLException e) { e.printStackTrace(); } return list; }逻辑说明LIMIT ? OFFSET ?是 MySQL 的分页语法第一个参数是每页条数第二个参数是偏移量计算公式是(当前页 - 1) * 每页条数。try-with-resources写法能自动关闭连接和语句避免资源泄漏。参数方面page从 1 开始pageSize一般设 10 或 15前端传页码时要做边界检查防止页码为 0 或超过总页数。3.3 留言模块一对多关系与时间格式化留言模块体现了表之间的一对多关系一个用户可以发多条留言一条留言只属于一个用户。留言表里有个user_id外键指向用户表。查询留言列表时常见做法是用 JOIN 把用户昵称一起查出来避免在 JSP 里再查一次数据库。时间字段在数据库里是DATETIME取出来是Timestamp在 JSP 里用fmt:formatDate标签格式化显示。// MessageDao 联表查询留言 public ListMessage findAllWithUser() { ListMessage list new ArrayList(); String sql SELECT m.*, u.username FROM message m LEFT JOIN user u ON m.user_id u.id ORDER BY m.create_time DESC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { Message msg new Message(); msg.setId(rs.getInt(id)); msg.setContent(rs.getString(content)); msg.setCreateTime(rs.getTimestamp(create_time)); msg.setUsername(rs.getString(username)); list.add(msg); } } catch (SQLException e) { e.printStackTrace(); } return list; }逻辑说明LEFT JOIN保证即使某个用户被删了留言还能查出来只是username为 null。ORDER BY create_time DESC让最新留言排在最前面。参数方面create_time在插入时用NOW()或 Java 的new Timestamp(System.currentTimeMillis())都行但要注意时区一致。JSP 里用fmt:formatDate value${msg.createTime} patternyyyy-MM-dd HH:mm/就能显示成友好格式。3.4 编码过滤器与数据库工具类编码问题和数据库连接是 JavaWeb 项目里最容易翻车的地方。常见做法是写一个CharacterEncodingFilter实现Filter接口在doFilter里统一设置请求和响应编码然后在web.xml里配置拦截所有请求。数据库工具类DBUtil负责加载驱动、获取连接、关闭资源连接参数写在db.properties里方便修改。// CharacterEncodingFilter 核心代码 public class CharacterEncodingFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { req.setCharacterEncoding(UTF-8); resp.setContentType(text/html;charsetUTF-8); chain.doFilter(req, resp); } }!-- web.xml 中配置过滤器 -- filter filter-nameencodingFilter/filter-name filter-classcom.example.util.CharacterEncodingFilter/filter-class /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping逻辑说明过滤器在 Servlet 之前执行所以能统一处理所有请求的编码。url-pattern设成/*表示拦截所有路径包括静态资源。参数方面resp.setContentType同时设置了 MIME 类型和字符集比单独调setCharacterEncoding更稳妥。数据库工具类里DBUtil.getConnection()每次调用都新建连接课程设计里够用但生产环境要用连接池。4. 避坑与常见问题跑不起来时先查这几处4.1 中文乱码现象、原因与解决现象登录时输入中文用户名后台收到的是乱码或者 JSP 页面显示的中文变成问号。原因Tomcat 默认用 ISO-8859-1 解码 GET 请求参数POST 请求虽然可以设编码但 JSP 页面本身的pageEncoding没设对也会乱码。解决三处都要设——JSP 页面头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %Servlet 里request.setCharacterEncoding(UTF-8)Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。如果是 GET 请求传中文最稳妥的办法是在 Tomcat 配置里改而不是在代码里手动转码。4.2 数据库连接失败驱动、URL 与权限现象启动项目后访问页面报ClassNotFoundException或Access denied for user。原因mysql-connector-java的 jar 包没放到WEB-INF/lib下或者放了但没加到 Build PathURL 里的数据库名、用户名、密码写错MySQL 8.0 没加serverTimezone参数。解决先确认 jar 包在WEB-INF/lib下且 IDE 的部署装配里包含它然后检查db.properties里的 URL 格式8.0 的完整 URL 是jdbc:mysql://localhost:3306/db_name?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8最后用命令行mysql -u root -p确认账号密码能登录。4.3 404 与 500路径错与空指针现象访问某个 Servlet 报 404或者页面报 500 且堆栈里是NullPointerException。原因404 通常是web.xml里url-pattern和表单action不一致或者 Servlet 注解WebServlet(/login)和访问路径不匹配500 空指针常见于 DAO 返回 null 后没判空就直接调方法。解决404 先看浏览器地址栏的路径和web.xml/注解里的路径是否完全一致注意大小写和斜杠500 看堆栈第一行定位到具体行号重点检查request.getParameter返回值、DAO 查询结果、Session 取值这三处。4.4 JSP 页面报错JSTL 标签未识别现象JSP 里写了c:forEach但页面报错说标签未识别。原因缺少 JSTL 的 jar 包或者 taglib 指令的 uri 写错。解决把jstl.jar和standard.jar放到WEB-INF/lib下JSP 头部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。注意 JSTL 1.2 之后standard.jar已经合并了只需要jstl-1.2.jar一个包uri 也建议用http://java.sun.com/jsp/jstl/core这个标准写法。4.5 修改代码后不生效缓存与重新部署现象改了 Servlet 或 JSP 代码重启 Tomcat 后页面还是旧的。原因IDE 没有自动重新编译或者 Tomcat 的 work 目录缓存了旧的 JSP 编译结果。解决在 IDE 里先 Build Project 再重启 Tomcat如果还不行删掉 Tomcat 的work/Catalina目录再启动JSP 改动一般不用重启但 Servlet 改动必须重启。另外注意如果项目部署方式是“打 war 包”那每次改动都要重新打包部署开发阶段建议用“ exploded ”方式直接指向WebContent目录。5. 二次开发与改造从能跑到好用5.1 把 JDBC 换成连接池课程设计里每次请求都新建数据库连接并发一高就崩。改造的第一步是引入连接池常见做法是用 Druid 或 HikariCP。以 Druid 为例把druid-1.2.x.jar放进WEB-INF/lib写一个DruidUtil替代原来的DBUtil在静态代码块里初始化DruidDataSource设置 URL、用户名、密码、初始连接数、最大连接数。getConnection()方法从数据源取连接close()方法改成把连接还回池子而不是真正关闭。这样改完数据库连接复用率大幅提升页面响应也会快很多。// DruidUtil 核心代码 public class DruidUtil { private static DataSource dataSource; static { DruidDataSource ds new DruidDataSource(); ds.setUrl(jdbc:mysql://localhost:3306/classmate?useSSLfalseserverTimezoneAsia/Shanghai); ds.setUsername(root); ds.setPassword(123456); ds.setInitialSize(5); ds.setMaxActive(20); dataSource ds; } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }逻辑说明setInitialSize(5)表示启动时先建 5 个连接setMaxActive(20)表示最多同时 20 个连接。参数要根据实际并发调整课程设计场景 5 到 10 就够。改造时注意把原来DBUtil的调用全部替换成DruidUtil关闭连接的方式不变因为Connection.close()在连接池里就是归还连接。5.2 用 Maven 重构项目结构如果想把项目改造成更规范的结构可以转成 Maven 项目。在项目根目录建pom.xml把src目录改成src/main/javaWebContent改成src/main/webappWEB-INF/lib下的 jar 包全部删掉改成在pom.xml里声明依赖。Servlet API 和 JSP API 的 scope 设成providedMySQL 驱动和 JSTL 设成compile。这样依赖管理清晰换电脑也不用拷 jar 包mvn clean package就能打出 war 包。!-- pom.xml 关键依赖 -- dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.28/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies逻辑说明provided表示编译时需要但打包时不带因为 Tomcat 已经提供了。mysql-connector-java的版本要和本地 MySQL 版本匹配8.0 的驱动连 5.7 的库也能用但反过来不行。改造后目录结构变了web.xml的位置也要跟着移到src/main/webapp/WEB-INF下。5.3 前端页面改造从 JSP 到 AJAX如果想让页面交互更流畅可以把列表页改成 AJAX 异步加载。Servlet 不再转发到 JSP而是直接输出 JSON 字符串前端用fetch或axios请求数据然后用 JavaScript 动态渲染表格。这样前后端职责更清晰也方便后续接入 Vue 或 React。改造时注意在 Servlet 里设置response.setContentType(application/json;charsetUTF-8)然后用PrintWriter输出 JSON 字符串。JSON 库可以用 Gson 或 Jackson也可以手动拼字符串但手动拼容易出格式错误建议用库。// 返回 JSON 的 Servlet 片段 response.setContentType(application/json;charsetUTF-8); PrintWriter out response.getWriter(); ListStudent list studentDao.findByPage(page, pageSize); Gson gson new Gson(); out.print(gson.toJson(list)); out.flush();逻辑说明Gson能把 Java 对象直接转成 JSON 字符串字段名默认和实体类属性名一致。前端拿到 JSON 后遍历数组用模板字符串拼 HTML 插入表格。参数方面分页的page和pageSize可以通过 URL 参数传给 Servlet前端用fetch(studentServlet?page1pageSize10)请求。5.4 验证改造效果的方法改完代码怎么确认没改坏我一般会走一遍“冒烟测试”先启动 Tomcat 看控制台有没有报错然后依次访问登录页、登录、列表页、添加一条数据、编辑、删除、退出登录每个操作都看页面响应和数据库记录是否一致。如果引入了连接池还会用jconsole或 Druid 的监控页面看连接数是否正常。对于 AJAX 改造打开浏览器开发者工具的 Network 面板看请求状态码是不是 200返回的 JSON 格式对不对。这套流程走下来基本能覆盖主要功能点。提示改造过程中建议用 Git 做版本管理每改一个模块就提交一次出问题了能快速回滚。我见过太多人改到一半发现跑不起来又没备份只能从头再来。从那以后我每次拿到一个 JavaWeb 项目都会先跑通原始版本再动第一行代码。先确认环境没问题、数据库能连上、页面能打开然后再按模块逐个改造。这样即使改出问题也能快速定位是环境问题还是代码问题。希望这份拆解能帮你少走点弯路顺利跑起来、改下去。本文还有配套的精品资源点击获取
简介这份同学录系统Java Web期末项目源码包面向高校计算机相关专业学生与Java Web初学者用于课程设计参考、期末项目实战及技术栈综合练习。项目采用Servlet与JSP构建前后端结合HTML/CSS/JavaScript、jQuery与Bootstrap完成页面交互并配套student.sql、user.sql两个数据库脚本覆盖MySQL建表、Session登录状态管理、权限控制及MVC分层设计等典型知识点适合用来理解从请求处理到数据持久化的完整链路。压缩包共48个文件以java源码与class编译文件为主另含jsp页面、jar依赖、sql脚本、css样式、properties配置及xml描述文件整体约1021KB结构紧凑便于本地导入IDE后对照调试。目前已有4372人学习下载读者可借此梳理Servlet与JSP协同、数据库初始化及Tomcat部署的排错思路是课程设计阶段较为实用的参考案例。1. 同学录系统 JavaWeb 期末项目一份能直接跑通的课程设计参考如果你正在为 JavaWeb 课程设计发愁或者想找一个结构完整、功能闭环、代码量适中的练手项目这份同学录系统值得拆开看看。它本质上是一个基于 JavaWeb 技术栈的信息管理系统核心功能围绕“同学信息录入、班级管理、留言互动、用户登录注册”展开适合刚学完 Servlet、JSP、JDBC 的开发者用来理解一个完整 Web 项目从请求到响应的全链路。项目采用典型的前后端不分离架构前端页面用 JSP 渲染后端用 Servlet 处理业务逻辑数据库用 MySQL 存储数据整体代码量不大但五脏俱全。对于需要交期末作业的同学来说它可以直接作为基础模板对于想巩固 JavaWeb 基础的开发者它也是一份不错的“逆向学习”材料——把每个模块拆开就能看清 MVC 模式在真实项目里到底怎么落地。2. 技术栈与目录结构先看清项目骨架再动手2.1 技术选型与运行环境这个项目没有用 Spring 全家桶也没有上 Maven 多模块而是最朴素的 JavaWeb 组合Servlet JSP JDBC MySQL Tomcat。这种选型在课程设计里非常常见好处是依赖少、配置简单、调试直观坏处是所有轮子都得自己造。具体版本上常见做法是 JDK 8 或 11、Tomcat 8.5 或 9.0、MySQL 5.7 或 8.0IDE 用 Eclipse 或 IntelliJ IDEA 都行。项目结构是标准的 Eclipse 动态 Web 项目布局没有用 Maven 管理依赖所以WEB-INF/lib下会直接放mysql-connector-java的 jar 包。如果你习惯用 Maven可以自己转成pom.xml但要注意 Servlet 和 JSP 的依赖 scope 要设成provided因为 Tomcat 已经自带了。提示MySQL 8.0 和 5.7 的驱动类名不同8.0 用com.mysql.cj.jdbc.Driver5.7 用com.mysql.jdbc.Driver连接 URL 也要加时区参数否则会报时区错误。2.2 目录结构逐层拆解项目根目录下主要分三块src放 Java 源码WebContent或web放前端资源和配置文件WebContent/WEB-INF放受保护的配置和依赖。src下面按包名分层常见的是com.xxx.entity放实体类、com.xxx.dao放数据库操作、com.xxx.servlet放控制器、com.xxx.util放工具类。WebContent下面有css、js、images静态资源以及一堆.jsp页面。WEB-INF下面有web.xml和lib目录。这种分层方式虽然简单但已经体现了 MVC 的雏形JSP 是 ViewServlet 是 ControllerDAO 和 Entity 是 Model。# 典型目录结构示意 src/ com/example/entity/ # 实体类对应数据库表 com/example/dao/ # 数据访问层封装 JDBC 操作 com/example/servlet/ # 控制器处理请求和跳转 com/example/util/ # 工具类如数据库连接、编码过滤 WebContent/ css/ # 样式文件 js/ # 脚本文件 images/ # 图片资源 index.jsp # 首页 login.jsp # 登录页 register.jsp # 注册页 studentList.jsp # 同学录列表页 WEB-INF/ web.xml # 部署描述符 lib/ # 第三方 jar 包2.3 数据库表设计与实体映射同学录系统的数据库一般不会太复杂核心表就三四张用户表、同学信息表、班级表、留言表。用户表存登录账号和密码同学信息表存姓名、电话、地址、生日等字段班级表存班级名称和入学年份留言表存留言内容和时间。实体类就是这些表的 Java 映射字段名和表字段一一对应类型上注意日期用java.util.Date或java.sql.Date数值用Integer或Long。DAO 层里每个实体对应一个 DAO 类里面写增删改查方法用PreparedStatement防止 SQL 注入。-- 同学信息表建表语句示例 CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, gender VARCHAR(10), phone VARCHAR(20), address VARCHAR(200), birthday DATE, class_id INT, remark VARCHAR(500) );注意建表时字段长度要留够尤其是地址和备注不然后面插入数据会报“Data too long”错误。字符集统一用utf8mb4避免中文乱码。3. 核心模块拆解一个请求从进入到返回的完整链路3.1 登录模块从表单提交到 Session 写入登录是理解整个项目请求链路的入口。用户在login.jsp输入用户名和密码表单以 POST 方式提交到LoginServlet。Servlet 里先设置请求编码为 UTF-8然后取参数、调 DAO 查数据库、比对密码成功就把用户信息写进HttpSession然后重定向到列表页失败就带错误信息转发回登录页。这里的关键是 Session 的使用——后续所有需要登录才能访问的页面都要先检查 Session 里有没有用户信息没有就踢回登录页。// LoginServlet 核心代码 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDao userDao new UserDao(); User user userDao.findByUsername(username); if (user ! null user.getPassword().equals(password)) { HttpSession session request.getSession(); session.setAttribute(currentUser, user); response.sendRedirect(studentList.jsp); } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); } }逻辑说明request.setCharacterEncoding(UTF-8)必须放在取参数之前否则中文用户名会乱码。findByUsername返回 null 表示用户不存在返回对象但密码不匹配表示密码错误这里为了简化没有区分提示。sendRedirect和forward的区别要清楚重定向会改变浏览器地址栏转发不会。参数方面username和password必须和 JSP 表单里的name属性完全一致大小写敏感。3.2 同学信息管理列表查询与分页逻辑同学信息管理是项目里代码量最大的模块包含列表展示、添加、编辑、删除四个操作。列表页studentList.jsp通过 JSTL 的c:forEach遍历 Servlet 传过来的ListStudent每行显示姓名、电话、班级等字段后面跟编辑和删除按钮。分页逻辑是课程设计的加分项常见做法是在 DAO 里写两个方法一个查总记录数一个查当前页数据用LIMIT和OFFSET实现。// StudentDao 分页查询方法 public ListStudent findByPage(int page, int pageSize) { ListStudent list new ArrayList(); String sql SELECT * FROM student LIMIT ? OFFSET ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, pageSize); ps.setInt(2, (page - 1) * pageSize); ResultSet rs ps.executeQuery(); while (rs.next()) { Student s new Student(); s.setId(rs.getInt(id)); s.setName(rs.getString(name)); s.setPhone(rs.getString(phone)); // 其他字段省略 list.add(s); } } catch (SQLException e) { e.printStackTrace(); } return list; }逻辑说明LIMIT ? OFFSET ?是 MySQL 的分页语法第一个参数是每页条数第二个参数是偏移量计算公式是(当前页 - 1) * 每页条数。try-with-resources写法能自动关闭连接和语句避免资源泄漏。参数方面page从 1 开始pageSize一般设 10 或 15前端传页码时要做边界检查防止页码为 0 或超过总页数。3.3 留言模块一对多关系与时间格式化留言模块体现了表之间的一对多关系一个用户可以发多条留言一条留言只属于一个用户。留言表里有个user_id外键指向用户表。查询留言列表时常见做法是用 JOIN 把用户昵称一起查出来避免在 JSP 里再查一次数据库。时间字段在数据库里是DATETIME取出来是Timestamp在 JSP 里用fmt:formatDate标签格式化显示。// MessageDao 联表查询留言 public ListMessage findAllWithUser() { ListMessage list new ArrayList(); String sql SELECT m.*, u.username FROM message m LEFT JOIN user u ON m.user_id u.id ORDER BY m.create_time DESC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { Message msg new Message(); msg.setId(rs.getInt(id)); msg.setContent(rs.getString(content)); msg.setCreateTime(rs.getTimestamp(create_time)); msg.setUsername(rs.getString(username)); list.add(msg); } } catch (SQLException e) { e.printStackTrace(); } return list; }逻辑说明LEFT JOIN保证即使某个用户被删了留言还能查出来只是username为 null。ORDER BY create_time DESC让最新留言排在最前面。参数方面create_time在插入时用NOW()或 Java 的new Timestamp(System.currentTimeMillis())都行但要注意时区一致。JSP 里用fmt:formatDate value${msg.createTime} patternyyyy-MM-dd HH:mm/就能显示成友好格式。3.4 编码过滤器与数据库工具类编码问题和数据库连接是 JavaWeb 项目里最容易翻车的地方。常见做法是写一个CharacterEncodingFilter实现Filter接口在doFilter里统一设置请求和响应编码然后在web.xml里配置拦截所有请求。数据库工具类DBUtil负责加载驱动、获取连接、关闭资源连接参数写在db.properties里方便修改。// CharacterEncodingFilter 核心代码 public class CharacterEncodingFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { req.setCharacterEncoding(UTF-8); resp.setContentType(text/html;charsetUTF-8); chain.doFilter(req, resp); } }!-- web.xml 中配置过滤器 -- filter filter-nameencodingFilter/filter-name filter-classcom.example.util.CharacterEncodingFilter/filter-class /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping逻辑说明过滤器在 Servlet 之前执行所以能统一处理所有请求的编码。url-pattern设成/*表示拦截所有路径包括静态资源。参数方面resp.setContentType同时设置了 MIME 类型和字符集比单独调setCharacterEncoding更稳妥。数据库工具类里DBUtil.getConnection()每次调用都新建连接课程设计里够用但生产环境要用连接池。4. 避坑与常见问题跑不起来时先查这几处4.1 中文乱码现象、原因与解决现象登录时输入中文用户名后台收到的是乱码或者 JSP 页面显示的中文变成问号。原因Tomcat 默认用 ISO-8859-1 解码 GET 请求参数POST 请求虽然可以设编码但 JSP 页面本身的pageEncoding没设对也会乱码。解决三处都要设——JSP 页面头部加% page contentTypetext/html;charsetUTF-8 pageEncodingUTF-8 %Servlet 里request.setCharacterEncoding(UTF-8)Tomcat 的server.xml里 Connector 加URIEncodingUTF-8。如果是 GET 请求传中文最稳妥的办法是在 Tomcat 配置里改而不是在代码里手动转码。4.2 数据库连接失败驱动、URL 与权限现象启动项目后访问页面报ClassNotFoundException或Access denied for user。原因mysql-connector-java的 jar 包没放到WEB-INF/lib下或者放了但没加到 Build PathURL 里的数据库名、用户名、密码写错MySQL 8.0 没加serverTimezone参数。解决先确认 jar 包在WEB-INF/lib下且 IDE 的部署装配里包含它然后检查db.properties里的 URL 格式8.0 的完整 URL 是jdbc:mysql://localhost:3306/db_name?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8最后用命令行mysql -u root -p确认账号密码能登录。4.3 404 与 500路径错与空指针现象访问某个 Servlet 报 404或者页面报 500 且堆栈里是NullPointerException。原因404 通常是web.xml里url-pattern和表单action不一致或者 Servlet 注解WebServlet(/login)和访问路径不匹配500 空指针常见于 DAO 返回 null 后没判空就直接调方法。解决404 先看浏览器地址栏的路径和web.xml/注解里的路径是否完全一致注意大小写和斜杠500 看堆栈第一行定位到具体行号重点检查request.getParameter返回值、DAO 查询结果、Session 取值这三处。4.4 JSP 页面报错JSTL 标签未识别现象JSP 里写了c:forEach但页面报错说标签未识别。原因缺少 JSTL 的 jar 包或者 taglib 指令的 uri 写错。解决把jstl.jar和standard.jar放到WEB-INF/lib下JSP 头部加% taglib prefixc urihttp://java.sun.com/jsp/jstl/core %。注意 JSTL 1.2 之后standard.jar已经合并了只需要jstl-1.2.jar一个包uri 也建议用http://java.sun.com/jsp/jstl/core这个标准写法。4.5 修改代码后不生效缓存与重新部署现象改了 Servlet 或 JSP 代码重启 Tomcat 后页面还是旧的。原因IDE 没有自动重新编译或者 Tomcat 的 work 目录缓存了旧的 JSP 编译结果。解决在 IDE 里先 Build Project 再重启 Tomcat如果还不行删掉 Tomcat 的work/Catalina目录再启动JSP 改动一般不用重启但 Servlet 改动必须重启。另外注意如果项目部署方式是“打 war 包”那每次改动都要重新打包部署开发阶段建议用“ exploded ”方式直接指向WebContent目录。5. 二次开发与改造从能跑到好用5.1 把 JDBC 换成连接池课程设计里每次请求都新建数据库连接并发一高就崩。改造的第一步是引入连接池常见做法是用 Druid 或 HikariCP。以 Druid 为例把druid-1.2.x.jar放进WEB-INF/lib写一个DruidUtil替代原来的DBUtil在静态代码块里初始化DruidDataSource设置 URL、用户名、密码、初始连接数、最大连接数。getConnection()方法从数据源取连接close()方法改成把连接还回池子而不是真正关闭。这样改完数据库连接复用率大幅提升页面响应也会快很多。// DruidUtil 核心代码 public class DruidUtil { private static DataSource dataSource; static { DruidDataSource ds new DruidDataSource(); ds.setUrl(jdbc:mysql://localhost:3306/classmate?useSSLfalseserverTimezoneAsia/Shanghai); ds.setUsername(root); ds.setPassword(123456); ds.setInitialSize(5); ds.setMaxActive(20); dataSource ds; } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }逻辑说明setInitialSize(5)表示启动时先建 5 个连接setMaxActive(20)表示最多同时 20 个连接。参数要根据实际并发调整课程设计场景 5 到 10 就够。改造时注意把原来DBUtil的调用全部替换成DruidUtil关闭连接的方式不变因为Connection.close()在连接池里就是归还连接。5.2 用 Maven 重构项目结构如果想把项目改造成更规范的结构可以转成 Maven 项目。在项目根目录建pom.xml把src目录改成src/main/javaWebContent改成src/main/webappWEB-INF/lib下的 jar 包全部删掉改成在pom.xml里声明依赖。Servlet API 和 JSP API 的 scope 设成providedMySQL 驱动和 JSTL 设成compile。这样依赖管理清晰换电脑也不用拷 jar 包mvn clean package就能打出 war 包。!-- pom.xml 关键依赖 -- dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.28/version /dependency dependency groupIdjavax.servlet/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependencies逻辑说明provided表示编译时需要但打包时不带因为 Tomcat 已经提供了。mysql-connector-java的版本要和本地 MySQL 版本匹配8.0 的驱动连 5.7 的库也能用但反过来不行。改造后目录结构变了web.xml的位置也要跟着移到src/main/webapp/WEB-INF下。5.3 前端页面改造从 JSP 到 AJAX如果想让页面交互更流畅可以把列表页改成 AJAX 异步加载。Servlet 不再转发到 JSP而是直接输出 JSON 字符串前端用fetch或axios请求数据然后用 JavaScript 动态渲染表格。这样前后端职责更清晰也方便后续接入 Vue 或 React。改造时注意在 Servlet 里设置response.setContentType(application/json;charsetUTF-8)然后用PrintWriter输出 JSON 字符串。JSON 库可以用 Gson 或 Jackson也可以手动拼字符串但手动拼容易出格式错误建议用库。// 返回 JSON 的 Servlet 片段 response.setContentType(application/json;charsetUTF-8); PrintWriter out response.getWriter(); ListStudent list studentDao.findByPage(page, pageSize); Gson gson new Gson(); out.print(gson.toJson(list)); out.flush();逻辑说明Gson能把 Java 对象直接转成 JSON 字符串字段名默认和实体类属性名一致。前端拿到 JSON 后遍历数组用模板字符串拼 HTML 插入表格。参数方面分页的page和pageSize可以通过 URL 参数传给 Servlet前端用fetch(studentServlet?page1pageSize10)请求。5.4 验证改造效果的方法改完代码怎么确认没改坏我一般会走一遍“冒烟测试”先启动 Tomcat 看控制台有没有报错然后依次访问登录页、登录、列表页、添加一条数据、编辑、删除、退出登录每个操作都看页面响应和数据库记录是否一致。如果引入了连接池还会用jconsole或 Druid 的监控页面看连接数是否正常。对于 AJAX 改造打开浏览器开发者工具的 Network 面板看请求状态码是不是 200返回的 JSON 格式对不对。这套流程走下来基本能覆盖主要功能点。提示改造过程中建议用 Git 做版本管理每改一个模块就提交一次出问题了能快速回滚。我见过太多人改到一半发现跑不起来又没备份只能从头再来。从那以后我每次拿到一个 JavaWeb 项目都会先跑通原始版本再动第一行代码。先确认环境没问题、数据库能连上、页面能打开然后再按模块逐个改造。这样即使改出问题也能快速定位是环境问题还是代码问题。希望这份拆解能帮你少走点弯路顺利跑起来、改下去。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
