简介基于Java Web的会议室管理系统源码包面向具备一定Java基础、希望学习传统JSPServlet技术栈的开发者也适合作为课程设计与毕业设计的参考。项目围绕会议室预约场景完整实现了前端交互、后端控制和数据持久化jQuery与Ajax负责页面异步更新JSP、Servlet、Filter、Listener组成服务端处理脉络数据库层使用MySQL并通过JDBC连接各模块边界清晰。压缩包共297个文件大小4.6MB包含42个Java源码、84个class文件、34个JSP页面、36个HTML、20个JS脚本与18个CSS样式另有SQL数据库脚本用于快速初始化表结构jar包提供运行依赖整体结构贴合标准Java Web工程。已有515人学习下载。源码中CoolMeeting项目展示了由表到页面再到控制器的典型开发路径涵盖部门管理、会议组织、会议室预订等常用功能适合对照运行结果梳理请求流转与数据库操作细节是系统掌握Java Web综合开发能力的高性价比材料。1. 会议室管理系统一套能跑通前后端和数据库的 Java Web 完整实例刚有同事来问我要一份能快速看懂的 Java Web 完整源码我翻出了手边这套会议室管理系统。它的技术选型非常典型前端用 jQuery 和 Ajax 做无刷新交互后端用 JSP、Servlet、Filter、Listener 各司其职数据库层是 MySQL 加 JDBC整套下来没有引入难以驾驭的重框架正适合课程设计、入职练手和面试前快速补 Java Web 基础场景。压缩包里除了源码还单独带了数据库脚本导入就能把表结构和初始数据建好对一个想完整看到「系统长什么样」的学习者来说这是节省时间的第一步。这套系统解决的实际问题很具体会议室信息管理、员工预约会议流程、部门与员工的基础数据维护。适合三类人——刚学完 Servlet 和 JSP、想找完整工程看代码组织方式的初学者课程设计或毕业设计需要现成系统的学生要给团队做内部工具、想找一套骨架快速改的开发者。下面按我的复现顺序来先让项目跑起来再顺着请求链路拆代码然后聚焦数据层最后把我在复现中踩过的坑一条条列清楚。2. 冷启动导入工程与执行数据库脚本半小时内让项目跑起来拿到源码的人第一步通常是先把它跑起来但这一步翻车率其实很高。原因多半集中在 JDK 与 Tomcat 版本不匹配、数据库脚本没执行干净、连接配置没改成自己的库密码这三件事上。这一章按操作顺序来先摸清工程结构再处理数据库脚本最后配好 Tomcat 启动三步走完就能进登录页。2.1 先看清工程目录别急着把项目拖进 IDE解压后先别急着双击导入建议在命令行里先扫一眼目录结构心里有底再动手。一个典型的传统 Java Web 工程外包结构是这样的CoolMeeting-master/ ├── src/ │ ├── com/coolmeeting/ │ │ ├── dao/ # DAO 层负责数据库操作 │ │ ├── filter/ # 过滤器做登录拦截和编码处理 │ │ ├── listener/ # 监听器处理应用级事件 │ │ ├── servlet/ # 控制器接收请求并响应 │ │ └── entity/ # 实体类Meeting/Employee/MeetingRoom/Department │ └── util/ # 工具类如 DBUtil ├── WebContent/ # 前端资源与 JSP 页面 │ ├── css/ js/ images/ │ ├── WEB-INF/ │ │ └── web.xml # 部署描述文件 └── sql/ # 数据库脚本 └── coolmeeting.sql # 建表语句和初始数据重点看两个东西一是WEB-INF/web.xml存在说明这是传统 Servlet 工程不是 Maven 结构的 Spring Boot二是sql/目录下有.sql脚本说明表结构不用自己手工建。如果解压后是 Maven 目录带pom.xml在 IDEA 里直接以 Maven 项目导入但像这种传统结构用「New → Project from Existing Sources」导入选 Web 模块即可。导入时我建议直接用 IDEA 而不是 Eclipse它对 Tomcat 的集成省事很多。导入后在 Project Structure 里确认三件事JDK 版本是否匹配、Language Level 是否对应、Web Facet 有没有正确识别到WebContent或web目录。这三项里任何一项不对启动时都会报莫名其妙的错第 5 章会展开讲。2.2 数据库脚本导入字符集和驱动版本两个参数提前控制数据库脚本是整套系统能不能连上数据的关键。用 Navicat 或命令行导入都行我习惯用命令行因为报错信息更直接mysql -u root -p CREATE DATABASE coolmeeting DEFAULT CHARACTER SET utf8mb4; USE coolmeeting; SOURCE /path/to/coolmeeting.sql;导入完成后重点核对两件事。第一库的字符集。这个项目里写死了不少中文内容如果建库时用了默认的 latin1后面页面上所有中文都会变成问号这个坑见第 5.1 节。第二核对表名。脚本里通常会包含employee、department、meetingroom、meeting四张核心表以及外键关联和初始数据。导入完执行show tables;确认都在再跑一条select * from employee;确认初始账号存在这一步才算真正通过。注意如果 SQL 脚本里没有建库语句需要先在 MySQL 里手动创建数据库再用USE指定库名后执行脚本否则表会建到默认的库里连接时同样报找不到表。项目里的数据库连接配置通常在src下的jdbc.properties或DBUtil类的常量里。常见的配置项是这套jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/coolmeeting?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.passwordyourpassword这里characterEncodingutf8必须带否则即使 Servlet 层设置了request.setCharacterEncoding从数据库读出来的中文还是乱码。另外如果你本机是 MySQL 8.x驱动类要改成com.mysql.cj.jdbc.DriverURL 里还要补serverTimezoneAsia/Shanghai否则第一次查询就会报时区错误。2.3 Tomcat 配置与启动端口冲突和部署方式两个容易卡壳的点在 IDEA 里配置 Tomcat 时我一般新建一个 Tomcat Server 实例然后在 Deployment 里把当前项目的 Artifact 加进去。Application context 建议设成/coolmeeting访问路径就是http://localhost:8080/coolmeeting/好记也不容易跟其他项目撞名。如果启动时提示端口被占Windows 下可以这样查# 查看 8080 端口被谁占用 netstat -ano | findstr 8080 # 结束对应进程或直接在 IDEA 里改 HTTP port启动成功的标志是控制台出现Server startup in XXXX ms然后浏览器能打开登录页。如果页面能打开但登录报错问题基本集中在 2.2 节的连接配置如果页面都打不开优先检查 Deployment 里的 Artifact 是否带上了 lib 目录里的 jar 包。这一步是最容易被忽略的Artifact 里没勾上 lib 目录Tomcat 启动时就找不到 JDBC 驱动数据库连接自然失败报错的堆栈还会让人误以为是代码问题。3. 读通请求链路Servlet、Filter、Listener 与 jQuery/Ajax 是怎么协作的这一章不打算泛泛讲概念而是按用户视角走一遍真实链路输入账号密码登录、看到会议室列表、提交一条预约请求。这条路径上前端在做什么、后端谁在干活、数据库怎么响应把这几个点对应到源码里的具体类这套系统的骨架就清楚了。3.1 请求到后端的第一站web.xml 里的映射关系传统 Java Web 项目的入口统一声明在web.xml里。这个项目的 Servlet、Filter、Listener 都必须在这里注册常见的配置结构如下!-- 监听器应用启动时初始化数据源或统计在线人数 -- listener listener-classcom.coolmeeting.listener.AppListener/listener-class /listener !-- 过滤器统一处理字符编码拦截未登录请求 -- filter filter-nameLoginFilter/filter-name filter-classcom.coolmeeting.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/pages/*/url-pattern /filter-mapping !-- Servlet处理登录请求 -- servlet servlet-nameLoginServlet/servlet-name servlet-classcom.coolmeeting.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping重点理解url-pattern的处理顺序请求先进 Filter再进 Servlet。Filter 在这里干两件事一是给所有 JSP 请求设置 UTF-8 编码二是检查 Session 里有没有登录标记没有就重定向到登录页。这两件事如果靠每个 Servlet 自己写代码会膨胀到没法维护所以 Filter 是这套代码里最值得学的部分。踩过的坑是如果 Filter 的url-pattern写成/*会连静态资源一起拦截页面完全没有样式。这套项目原版只拦/pages/*登录页和静态资源天然放行这种设计更合理自己改造时要注意范围。3.2 前端页面怎么与 Servlet 通信jQuery Ajax 的异步请求这个项目的页面是 JSP但交互大量用 jQuery 和 Ajax。最典型的一段是登录表单提交不刷新页面就把账号密码发给后端// login.js 中简化过的 Ajax 提交逻辑 $(#loginBtn).click(function () { var username $(#username).val().trim(); var password $(#password).val().trim(); if (username || password ) { alert(账号和密码不能为空); return; } $.ajax({ url: login, // 对应 web.xml 中的 /login type: POST, data: { username: username, password: password }, dataType: json, success: function (resp) { if (resp.code 0) { window.location.href pages/booking.jsp; // 登录成功跳转 } else { alert(resp.message); } }, error: function () { alert(请求异常请检查网络或服务状态); } }); });几个参数值得展开。dataType: json让 jQuery 自动把后端返回的 JSON 字符串解析成对象如果后端响应格式不对或没设置响应头就会从 success 掉到 error 分支。data里的字段名必须和后端request.getParameter(username)里的 key 完全一致前端多一个空格、后端取不到值这种错误很难一眼看出来。后端对应的处理逻辑在 Servlet 里从 request 中取值、调 DAO 查库、把结果写成 JSON// LoginServlet.java 中的核心片段 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); EmployeeDao dao new EmployeeDao(); Employee emp dao.findByUsernameAndPassword(username, password); response.setContentType(application/json;charsetUTF-8); PrintWriter out response.getWriter(); if (emp ! null) { request.getSession().setAttribute(employee, emp); out.print({\code\: 0, \message\: \登录成功\}); } else { out.print({\code\: 1, \message\: \账号或密码错误\}); } out.flush(); }那句response.setContentType(application/json;charsetUTF-8)是关键。如果不写前端拿到的是 text/html 类型的字符串jQuery 在按 JSON 解析时直接报错响应能看到但进不了 success。这是我印象里这个项目最常见的联调问题也是新手最容易忽略的细节。3.3 核心流程走一遍会议室查询与预约提交登录之后的主路径是进入会议室列表页看到所有可用会议室选择某个会议室填写预约时间提交后写入数据库。会议室列表通常有两种加载方式一种是页面嵌 JSP 标签直接渲染另一种是打开页面后发一次 Ajax 请求// 会议室列表的 Ajax 加载 $.get(meetingroomlist, function (data) { // data 是后端拼好的 HTML 片段或 JSON 数组 $(#roomList).html(data); });如果后端返回 JSON 数组前端渲染更灵活如果返回 HTML 片段则后端 JSP 里会用循环逐行拼tr。这套项目两种写法都可能出现取决于 DAO 层返回的是 List 还是拼接好的字符串。提交预约这一段是标准的「取参数 → 校验 → 写库 → 返回结果」四步。值得关注的是校验环节表单里传来的是字符串形式的日期时间数据库里存的是datetime类型中间通常用SimpleDateFormat或Timestamp.valueOf()做转换。如果前端传的格式与解析格式不匹配就会抛ParseException后端没捕获的话用户看到的就是 500 页面。这也是实际复现中的高频报错之一。到这一步请求链路基本清晰了JSP 页面触发 Ajax →web.xml里的 Filter 和 Servlet 依次处理 → Servlet 调 DAO → DAO 通过 JDBC 操作 MySQL → 结果以 JSON 返回前端。下一章把数据层单独拆开因为这是代码量最大、也是最值得改造的部分。4. 数据层落地MySQL 四张表设计、JDBC 连接与 DAO 层封装请求链路承上启下数据层是系统真正能存能查的基础。这一章从建表 SQL 讲起到 JDBC 连接的演进最后落在 DAO 层的封装模式上。看完你不仅能看懂MeetingDao、EmployeeDao这些类在做什么还能把同一套写法直接搬到自己的项目里。4.1 四张核心表从实体类反推表结构设计源码的entity包里暴露了Meeting、Employee、MeetingRoom、Department四个实体类对应数据库里的四张表。实体类是理解表关系最快的入口一般的字段设计大致如下表名关键字段说明departmentid、departmentname部门表员工表的外键来源employeeid、departmentid、username、password、name员工表含登录账号和密码meetingroomid、roomname、capacity、status会议室表status 表示是否可用meetingid、meetingname、roomid、reservationistid、starttime、endtime预约会议表绑定会议室与发起人这四张表的关系很直观employee.departmentid对应department.idmeeting.roomid对应meetingroom.idmeeting.reservationistid对应employee.id。外键约束保证了预约会议不可能指向不存在的会议室或员工。很多初学项目为了省事不建外键这套项目保留了约束这也是它能当教学源码的原因之一。建表 SQL 里建议留意datetime类型的默认值。MySQL 5.7 之后支持DEFAULT CURRENT_TIMESTAMP如果脚本还是旧语法且显式指定了默认值某些版本下插入数据会报错。另外初始数据一般包含一个管理员账号和一个普通员工账号登录后能看出不同角色的页面差异。4.2 JDBC 连接从 DriverManager 到连接池看 DBUtil 的设计思路源码里数据库连接的入口通常集中在DBUtil类。不同版本的实现有差异常见两种一种是DriverManager每次都新建连接、用完关闭另一种引入 C3P0 或 DBCP 连接池初始化一批连接反复使用。后者代码大概长这样public class DBUtil { private static ComboPooledDataSource dataSource; static { // 初始化 C3P0 连接池配置文件在 c3p0-config.xml 里 dataSource new ComboPooledDataSource(); } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } public static void close(AutoCloseable... resources) { for (AutoCloseable res : resources) { if (res ! null) { try { res.close(); } catch (Exception e) { e.printStackTrace(); } } } } }连接池的意义在于复用。每次请求都新建物理连接高并发下会频繁握手认证拖垮数据库连接池维护一批连接反复使用申请和归还都在内存里完成效率高一个量级。拿到源码后可以全局搜一下DriverManager.getConnection如果被多处调用说明这套代码用的是最原始的方式正好可以作为第 6 章改造的第一步。另外注意close(AutoCloseable... resources)这个封装它接受可变参数调用时把Connection、PreparedStatement、ResultSet一次传入不用在每个方法里写三层 try-finally。这种封装在真实项目里很常见属于成本低收益高的代码习惯。4.3 DAO 层写法PreparedStatement 带来的安全与性能收益DAO 层是这套项目里最实用的部分。以EmployeeDao为例查询用户的标准写法是public Employee findByUsernameAndPassword(String username, String password) { String sql SELECT * FROM employee WHERE username? AND password?; Connection conn null; PreparedStatement ps null; ResultSet rs null; try { conn DBUtil.getConnection(); ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); rs ps.executeQuery(); if (rs.next()) { Employee emp new Employee(); emp.setId(rs.getInt(id)); emp.setName(rs.getString(name)); // 其他字段赋值省略 return emp; } return null; } catch (SQLException e) { e.printStackTrace(); return null; } finally { DBUtil.close(rs, ps, conn); } }最值得模仿的是?占位符配合PreparedStatement的写法。如果看到代码里有SELECT * FROM employee WHERE username username 这种字符串拼接一定要改掉原因有两层。第一层是安全问题用户输入 or 11就能绕过登录校验这是面试时必提的 SQL 注入点第二层是性能PreparedStatement预编译后同一条 SQL 多次执行会走缓存比每次重新解析字符串快。另一个细节是结果集映射。rs.getInt、rs.getString与实体类字段的对应关系如果表字段用下划线命名、实体类用驼峰赋值的地方就要手工转换。这也是后面迁移到 MyBatis 或 JPA 时改动最大的地方DAO 层写得好不好直接影响你后续要不要换 ORM 框架。5. 避坑清单六个我复现时踩过的坑与对应解法这一章是血泪经验。同一套源码在不同环境下跑表现差异极大。我在自己机器上复现、帮朋友排障时反复看到下面几类问题全部整理成「现象 → 原因 → 解决」三段方便你对号入座。5.1 页面中文全部变成问号现象启动后登录页的下拉框、按钮文字全是问号数据库里写入中文也变成???。原因建库时没指定字符集MySQL 默认用了 latin1JSP 页面按 UTF-8 提交后无法正确存储另外jdbc.url里没带characterEncodingutf8连接层的编码也错了。解决先确认库的字符集执行ALTER DATABASE coolmeeting DEFAULT CHARACTER SET utf8mb4;再检查连接 URL。改完重启 Tomcat。如果表里已经混入乱码数据得删掉重建或用CONVERT函数处理不建议手工逐行修正。5.2 控制台报 Access denied for user rootlocalhost现象Tomcat 启动正常但一登录就报 SQLException堆栈里出现Access denied for user rootlocalhost (using password: YES)。原因jdbc.properties里的密码不对或者密码中带了、这类特殊字符在 URL 里被解析成了分隔符。解决先用 Navicat 用相同密码测一次能否登录。密码含特殊字符的要么改密码要么在 properties 里做转义。确认无误后改jdbc.password重启生效。5.3 页面有 HTML 但没有样式现象登录页能打开但纯文本排布css、js全部失效浏览器控制台报 404。原因Filter 的url-pattern配置成了/*把静态资源请求也拦截了或者 Filter 内做了登录判断静态资源没有 Session 就被重定向跳走。解决把 Filter 的拦截范围改成只保护需要登录的路径比如/pages/*让/css/*、/js/*天然放行。也可以直接在 Filter 里判断请求路径是否以.css、.js、.jpg结尾是就直接放行。5.4 Ajax 请求一直进 error 分支现象页面无跳转控制台报SyntaxError: Unexpected token或 Network 里能看到响应但 success 不执行。原因后端返回的 JSON 格式不合法。常见两类一是response.setContentType设成了text/html二是 Java 层直接out.print(emp.toString())输出的不是 JSON 格式。解决先把 Network 面板里的响应原文复制出来贴到在线 JSON 校验工具里看哪里不合法。后端统一返回{code: 0, message: ...}这种结构前端只解析这一种结构逻辑会顺很多。5.5 启动时报 ClassNotFoundException: com.mysql.jdbc.Driver现象Tomcat 一启动就报找不到数据库驱动类但lib目录里明明放着mysql-connector-java.jar。原因IDEA 的 Artifact 在部署时没把 jar 打包进WEB-INF/lib。常见于导入工程时 IDE 没自动识别 Web 依赖只确认了源码路径。解决进入Project Structure → Artifacts选中项目在 Output Layout 里把 lib 目录或需要的 jar 添加到WEB-INF/lib下重新 Build。再启动前看一眼生成的 Artifact 目录里是否真的有 jar。5.6 两个人同时预约同一个会议室后提交的也成功了现象会议室 10:00-12:00 已被 A 预约B 又提交同一时段的预约系统没提示冲突。原因meeting表没做唯一约束业务代码里没做时间重叠校验只简单地执行 insert。解决先查有没有重叠时间段再决定是否插入。判断重叠的 SQL 是两条条件的组合新预约的开始时间在已有时间段内或新预约的结束时间在已有时间段内。写成 SQL 就是WHERE roomid? AND starttime ? AND endtime ?参数分别传新预约的结束时间和开始时间。这个逻辑第 6 章再展开。6. 进阶改造加测试、日志和预约冲突校验让项目变成你的简历作品项目能跑通、源码也读透了这套系统还有不少进阶空间。我建议按顺序做三件事给 DAO 层写单元测试用日志替换System.out.println再把预约时间冲突校验补上。做完这三件事这套源码就不再是「跑通就行」的课程作业而是一个能撑住面试追问的完整项目。先说单元测试。DAO 层的测试不依赖 Tomcat是最小的验证方式只需要数据库连接可用public class EmployeeDaoTest { Test public void testFindByUsernameAndPassword() { EmployeeDao dao new EmployeeDao(); Employee emp dao.findByUsernameAndPassword(admin, 123456); assertNotNull(emp, admin 账号应能查到员工信息); assertEquals(系统管理员, emp.getName()); } }这里用 JUnit 4一个注解加两个断言就够了不需要引入 Spring 那套测试框架。跑测试前要确认数据库状态建议单独配一个test.properties与开发环境隔离。自从把 DAO 测试补上以后每次改 SQL 都先跑一遍再启动 Tomcat省掉了大把无谓的浏览器刷新时间。再说日志。源码里到处是e.printStackTrace()和System.out.println排障时看不出上下文。换成 Log4j 只需两步在src下放一份log4j.properties再把 catch 块改成private static final Logger LOGGER Logger.getLogger(EmployeeDao.class.getName()); catch (SQLException e) { LOGGER.error(查询员工失败, username{}, username, e); }{}是占位符日志框架会自动把参数拼进去避免手动拼接字符串。调试时把级别调到 DEBUG发布时调到 INFO比打印到控制台灵活太多。最后是预约冲突校验把它加到提交预约的 Service 层判断里用一条查询检查重叠区间SELECT COUNT(*) FROM meeting WHERE roomid ? -- 要预约的会议室 AND starttime ? -- 新预约的结束时间 AND endtime ? -- 新预约的开始时间这个查询的含义是已存在记录中有任一条的开始时间早于新预约的结束时间且结束时间晚于新预约的开始时间说明两个时间段有了交集。查询结果大于 0 就直接拒绝本次预约。这段逻辑虽然只有一条 SQL但在面试里能很自然地讲清楚「时间区间重叠」的判断思路是实打实的加分项。从那以后我每次拿到别人的 Web 项目都会强制自己走一遍这套流程先把它跑起来再理清请求链路然后审数据层最后补测试和日志。这套流程走完代码里哪些是能学的、哪些是必须改的一眼就能分清楚。希望帮到你。本文还有配套的精品资源点击获取
Java Web实战：会议室管理系统源码解析与避坑指南
简介基于Java Web的会议室管理系统源码包面向具备一定Java基础、希望学习传统JSPServlet技术栈的开发者也适合作为课程设计与毕业设计的参考。项目围绕会议室预约场景完整实现了前端交互、后端控制和数据持久化jQuery与Ajax负责页面异步更新JSP、Servlet、Filter、Listener组成服务端处理脉络数据库层使用MySQL并通过JDBC连接各模块边界清晰。压缩包共297个文件大小4.6MB包含42个Java源码、84个class文件、34个JSP页面、36个HTML、20个JS脚本与18个CSS样式另有SQL数据库脚本用于快速初始化表结构jar包提供运行依赖整体结构贴合标准Java Web工程。已有515人学习下载。源码中CoolMeeting项目展示了由表到页面再到控制器的典型开发路径涵盖部门管理、会议组织、会议室预订等常用功能适合对照运行结果梳理请求流转与数据库操作细节是系统掌握Java Web综合开发能力的高性价比材料。1. 会议室管理系统一套能跑通前后端和数据库的 Java Web 完整实例刚有同事来问我要一份能快速看懂的 Java Web 完整源码我翻出了手边这套会议室管理系统。它的技术选型非常典型前端用 jQuery 和 Ajax 做无刷新交互后端用 JSP、Servlet、Filter、Listener 各司其职数据库层是 MySQL 加 JDBC整套下来没有引入难以驾驭的重框架正适合课程设计、入职练手和面试前快速补 Java Web 基础场景。压缩包里除了源码还单独带了数据库脚本导入就能把表结构和初始数据建好对一个想完整看到「系统长什么样」的学习者来说这是节省时间的第一步。这套系统解决的实际问题很具体会议室信息管理、员工预约会议流程、部门与员工的基础数据维护。适合三类人——刚学完 Servlet 和 JSP、想找完整工程看代码组织方式的初学者课程设计或毕业设计需要现成系统的学生要给团队做内部工具、想找一套骨架快速改的开发者。下面按我的复现顺序来先让项目跑起来再顺着请求链路拆代码然后聚焦数据层最后把我在复现中踩过的坑一条条列清楚。2. 冷启动导入工程与执行数据库脚本半小时内让项目跑起来拿到源码的人第一步通常是先把它跑起来但这一步翻车率其实很高。原因多半集中在 JDK 与 Tomcat 版本不匹配、数据库脚本没执行干净、连接配置没改成自己的库密码这三件事上。这一章按操作顺序来先摸清工程结构再处理数据库脚本最后配好 Tomcat 启动三步走完就能进登录页。2.1 先看清工程目录别急着把项目拖进 IDE解压后先别急着双击导入建议在命令行里先扫一眼目录结构心里有底再动手。一个典型的传统 Java Web 工程外包结构是这样的CoolMeeting-master/ ├── src/ │ ├── com/coolmeeting/ │ │ ├── dao/ # DAO 层负责数据库操作 │ │ ├── filter/ # 过滤器做登录拦截和编码处理 │ │ ├── listener/ # 监听器处理应用级事件 │ │ ├── servlet/ # 控制器接收请求并响应 │ │ └── entity/ # 实体类Meeting/Employee/MeetingRoom/Department │ └── util/ # 工具类如 DBUtil ├── WebContent/ # 前端资源与 JSP 页面 │ ├── css/ js/ images/ │ ├── WEB-INF/ │ │ └── web.xml # 部署描述文件 └── sql/ # 数据库脚本 └── coolmeeting.sql # 建表语句和初始数据重点看两个东西一是WEB-INF/web.xml存在说明这是传统 Servlet 工程不是 Maven 结构的 Spring Boot二是sql/目录下有.sql脚本说明表结构不用自己手工建。如果解压后是 Maven 目录带pom.xml在 IDEA 里直接以 Maven 项目导入但像这种传统结构用「New → Project from Existing Sources」导入选 Web 模块即可。导入时我建议直接用 IDEA 而不是 Eclipse它对 Tomcat 的集成省事很多。导入后在 Project Structure 里确认三件事JDK 版本是否匹配、Language Level 是否对应、Web Facet 有没有正确识别到WebContent或web目录。这三项里任何一项不对启动时都会报莫名其妙的错第 5 章会展开讲。2.2 数据库脚本导入字符集和驱动版本两个参数提前控制数据库脚本是整套系统能不能连上数据的关键。用 Navicat 或命令行导入都行我习惯用命令行因为报错信息更直接mysql -u root -p CREATE DATABASE coolmeeting DEFAULT CHARACTER SET utf8mb4; USE coolmeeting; SOURCE /path/to/coolmeeting.sql;导入完成后重点核对两件事。第一库的字符集。这个项目里写死了不少中文内容如果建库时用了默认的 latin1后面页面上所有中文都会变成问号这个坑见第 5.1 节。第二核对表名。脚本里通常会包含employee、department、meetingroom、meeting四张核心表以及外键关联和初始数据。导入完执行show tables;确认都在再跑一条select * from employee;确认初始账号存在这一步才算真正通过。注意如果 SQL 脚本里没有建库语句需要先在 MySQL 里手动创建数据库再用USE指定库名后执行脚本否则表会建到默认的库里连接时同样报找不到表。项目里的数据库连接配置通常在src下的jdbc.properties或DBUtil类的常量里。常见的配置项是这套jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/coolmeeting?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.passwordyourpassword这里characterEncodingutf8必须带否则即使 Servlet 层设置了request.setCharacterEncoding从数据库读出来的中文还是乱码。另外如果你本机是 MySQL 8.x驱动类要改成com.mysql.cj.jdbc.DriverURL 里还要补serverTimezoneAsia/Shanghai否则第一次查询就会报时区错误。2.3 Tomcat 配置与启动端口冲突和部署方式两个容易卡壳的点在 IDEA 里配置 Tomcat 时我一般新建一个 Tomcat Server 实例然后在 Deployment 里把当前项目的 Artifact 加进去。Application context 建议设成/coolmeeting访问路径就是http://localhost:8080/coolmeeting/好记也不容易跟其他项目撞名。如果启动时提示端口被占Windows 下可以这样查# 查看 8080 端口被谁占用 netstat -ano | findstr 8080 # 结束对应进程或直接在 IDEA 里改 HTTP port启动成功的标志是控制台出现Server startup in XXXX ms然后浏览器能打开登录页。如果页面能打开但登录报错问题基本集中在 2.2 节的连接配置如果页面都打不开优先检查 Deployment 里的 Artifact 是否带上了 lib 目录里的 jar 包。这一步是最容易被忽略的Artifact 里没勾上 lib 目录Tomcat 启动时就找不到 JDBC 驱动数据库连接自然失败报错的堆栈还会让人误以为是代码问题。3. 读通请求链路Servlet、Filter、Listener 与 jQuery/Ajax 是怎么协作的这一章不打算泛泛讲概念而是按用户视角走一遍真实链路输入账号密码登录、看到会议室列表、提交一条预约请求。这条路径上前端在做什么、后端谁在干活、数据库怎么响应把这几个点对应到源码里的具体类这套系统的骨架就清楚了。3.1 请求到后端的第一站web.xml 里的映射关系传统 Java Web 项目的入口统一声明在web.xml里。这个项目的 Servlet、Filter、Listener 都必须在这里注册常见的配置结构如下!-- 监听器应用启动时初始化数据源或统计在线人数 -- listener listener-classcom.coolmeeting.listener.AppListener/listener-class /listener !-- 过滤器统一处理字符编码拦截未登录请求 -- filter filter-nameLoginFilter/filter-name filter-classcom.coolmeeting.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/pages/*/url-pattern /filter-mapping !-- Servlet处理登录请求 -- servlet servlet-nameLoginServlet/servlet-name servlet-classcom.coolmeeting.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping重点理解url-pattern的处理顺序请求先进 Filter再进 Servlet。Filter 在这里干两件事一是给所有 JSP 请求设置 UTF-8 编码二是检查 Session 里有没有登录标记没有就重定向到登录页。这两件事如果靠每个 Servlet 自己写代码会膨胀到没法维护所以 Filter 是这套代码里最值得学的部分。踩过的坑是如果 Filter 的url-pattern写成/*会连静态资源一起拦截页面完全没有样式。这套项目原版只拦/pages/*登录页和静态资源天然放行这种设计更合理自己改造时要注意范围。3.2 前端页面怎么与 Servlet 通信jQuery Ajax 的异步请求这个项目的页面是 JSP但交互大量用 jQuery 和 Ajax。最典型的一段是登录表单提交不刷新页面就把账号密码发给后端// login.js 中简化过的 Ajax 提交逻辑 $(#loginBtn).click(function () { var username $(#username).val().trim(); var password $(#password).val().trim(); if (username || password ) { alert(账号和密码不能为空); return; } $.ajax({ url: login, // 对应 web.xml 中的 /login type: POST, data: { username: username, password: password }, dataType: json, success: function (resp) { if (resp.code 0) { window.location.href pages/booking.jsp; // 登录成功跳转 } else { alert(resp.message); } }, error: function () { alert(请求异常请检查网络或服务状态); } }); });几个参数值得展开。dataType: json让 jQuery 自动把后端返回的 JSON 字符串解析成对象如果后端响应格式不对或没设置响应头就会从 success 掉到 error 分支。data里的字段名必须和后端request.getParameter(username)里的 key 完全一致前端多一个空格、后端取不到值这种错误很难一眼看出来。后端对应的处理逻辑在 Servlet 里从 request 中取值、调 DAO 查库、把结果写成 JSON// LoginServlet.java 中的核心片段 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); EmployeeDao dao new EmployeeDao(); Employee emp dao.findByUsernameAndPassword(username, password); response.setContentType(application/json;charsetUTF-8); PrintWriter out response.getWriter(); if (emp ! null) { request.getSession().setAttribute(employee, emp); out.print({\code\: 0, \message\: \登录成功\}); } else { out.print({\code\: 1, \message\: \账号或密码错误\}); } out.flush(); }那句response.setContentType(application/json;charsetUTF-8)是关键。如果不写前端拿到的是 text/html 类型的字符串jQuery 在按 JSON 解析时直接报错响应能看到但进不了 success。这是我印象里这个项目最常见的联调问题也是新手最容易忽略的细节。3.3 核心流程走一遍会议室查询与预约提交登录之后的主路径是进入会议室列表页看到所有可用会议室选择某个会议室填写预约时间提交后写入数据库。会议室列表通常有两种加载方式一种是页面嵌 JSP 标签直接渲染另一种是打开页面后发一次 Ajax 请求// 会议室列表的 Ajax 加载 $.get(meetingroomlist, function (data) { // data 是后端拼好的 HTML 片段或 JSON 数组 $(#roomList).html(data); });如果后端返回 JSON 数组前端渲染更灵活如果返回 HTML 片段则后端 JSP 里会用循环逐行拼tr。这套项目两种写法都可能出现取决于 DAO 层返回的是 List 还是拼接好的字符串。提交预约这一段是标准的「取参数 → 校验 → 写库 → 返回结果」四步。值得关注的是校验环节表单里传来的是字符串形式的日期时间数据库里存的是datetime类型中间通常用SimpleDateFormat或Timestamp.valueOf()做转换。如果前端传的格式与解析格式不匹配就会抛ParseException后端没捕获的话用户看到的就是 500 页面。这也是实际复现中的高频报错之一。到这一步请求链路基本清晰了JSP 页面触发 Ajax →web.xml里的 Filter 和 Servlet 依次处理 → Servlet 调 DAO → DAO 通过 JDBC 操作 MySQL → 结果以 JSON 返回前端。下一章把数据层单独拆开因为这是代码量最大、也是最值得改造的部分。4. 数据层落地MySQL 四张表设计、JDBC 连接与 DAO 层封装请求链路承上启下数据层是系统真正能存能查的基础。这一章从建表 SQL 讲起到 JDBC 连接的演进最后落在 DAO 层的封装模式上。看完你不仅能看懂MeetingDao、EmployeeDao这些类在做什么还能把同一套写法直接搬到自己的项目里。4.1 四张核心表从实体类反推表结构设计源码的entity包里暴露了Meeting、Employee、MeetingRoom、Department四个实体类对应数据库里的四张表。实体类是理解表关系最快的入口一般的字段设计大致如下表名关键字段说明departmentid、departmentname部门表员工表的外键来源employeeid、departmentid、username、password、name员工表含登录账号和密码meetingroomid、roomname、capacity、status会议室表status 表示是否可用meetingid、meetingname、roomid、reservationistid、starttime、endtime预约会议表绑定会议室与发起人这四张表的关系很直观employee.departmentid对应department.idmeeting.roomid对应meetingroom.idmeeting.reservationistid对应employee.id。外键约束保证了预约会议不可能指向不存在的会议室或员工。很多初学项目为了省事不建外键这套项目保留了约束这也是它能当教学源码的原因之一。建表 SQL 里建议留意datetime类型的默认值。MySQL 5.7 之后支持DEFAULT CURRENT_TIMESTAMP如果脚本还是旧语法且显式指定了默认值某些版本下插入数据会报错。另外初始数据一般包含一个管理员账号和一个普通员工账号登录后能看出不同角色的页面差异。4.2 JDBC 连接从 DriverManager 到连接池看 DBUtil 的设计思路源码里数据库连接的入口通常集中在DBUtil类。不同版本的实现有差异常见两种一种是DriverManager每次都新建连接、用完关闭另一种引入 C3P0 或 DBCP 连接池初始化一批连接反复使用。后者代码大概长这样public class DBUtil { private static ComboPooledDataSource dataSource; static { // 初始化 C3P0 连接池配置文件在 c3p0-config.xml 里 dataSource new ComboPooledDataSource(); } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } public static void close(AutoCloseable... resources) { for (AutoCloseable res : resources) { if (res ! null) { try { res.close(); } catch (Exception e) { e.printStackTrace(); } } } } }连接池的意义在于复用。每次请求都新建物理连接高并发下会频繁握手认证拖垮数据库连接池维护一批连接反复使用申请和归还都在内存里完成效率高一个量级。拿到源码后可以全局搜一下DriverManager.getConnection如果被多处调用说明这套代码用的是最原始的方式正好可以作为第 6 章改造的第一步。另外注意close(AutoCloseable... resources)这个封装它接受可变参数调用时把Connection、PreparedStatement、ResultSet一次传入不用在每个方法里写三层 try-finally。这种封装在真实项目里很常见属于成本低收益高的代码习惯。4.3 DAO 层写法PreparedStatement 带来的安全与性能收益DAO 层是这套项目里最实用的部分。以EmployeeDao为例查询用户的标准写法是public Employee findByUsernameAndPassword(String username, String password) { String sql SELECT * FROM employee WHERE username? AND password?; Connection conn null; PreparedStatement ps null; ResultSet rs null; try { conn DBUtil.getConnection(); ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); rs ps.executeQuery(); if (rs.next()) { Employee emp new Employee(); emp.setId(rs.getInt(id)); emp.setName(rs.getString(name)); // 其他字段赋值省略 return emp; } return null; } catch (SQLException e) { e.printStackTrace(); return null; } finally { DBUtil.close(rs, ps, conn); } }最值得模仿的是?占位符配合PreparedStatement的写法。如果看到代码里有SELECT * FROM employee WHERE username username 这种字符串拼接一定要改掉原因有两层。第一层是安全问题用户输入 or 11就能绕过登录校验这是面试时必提的 SQL 注入点第二层是性能PreparedStatement预编译后同一条 SQL 多次执行会走缓存比每次重新解析字符串快。另一个细节是结果集映射。rs.getInt、rs.getString与实体类字段的对应关系如果表字段用下划线命名、实体类用驼峰赋值的地方就要手工转换。这也是后面迁移到 MyBatis 或 JPA 时改动最大的地方DAO 层写得好不好直接影响你后续要不要换 ORM 框架。5. 避坑清单六个我复现时踩过的坑与对应解法这一章是血泪经验。同一套源码在不同环境下跑表现差异极大。我在自己机器上复现、帮朋友排障时反复看到下面几类问题全部整理成「现象 → 原因 → 解决」三段方便你对号入座。5.1 页面中文全部变成问号现象启动后登录页的下拉框、按钮文字全是问号数据库里写入中文也变成???。原因建库时没指定字符集MySQL 默认用了 latin1JSP 页面按 UTF-8 提交后无法正确存储另外jdbc.url里没带characterEncodingutf8连接层的编码也错了。解决先确认库的字符集执行ALTER DATABASE coolmeeting DEFAULT CHARACTER SET utf8mb4;再检查连接 URL。改完重启 Tomcat。如果表里已经混入乱码数据得删掉重建或用CONVERT函数处理不建议手工逐行修正。5.2 控制台报 Access denied for user rootlocalhost现象Tomcat 启动正常但一登录就报 SQLException堆栈里出现Access denied for user rootlocalhost (using password: YES)。原因jdbc.properties里的密码不对或者密码中带了、这类特殊字符在 URL 里被解析成了分隔符。解决先用 Navicat 用相同密码测一次能否登录。密码含特殊字符的要么改密码要么在 properties 里做转义。确认无误后改jdbc.password重启生效。5.3 页面有 HTML 但没有样式现象登录页能打开但纯文本排布css、js全部失效浏览器控制台报 404。原因Filter 的url-pattern配置成了/*把静态资源请求也拦截了或者 Filter 内做了登录判断静态资源没有 Session 就被重定向跳走。解决把 Filter 的拦截范围改成只保护需要登录的路径比如/pages/*让/css/*、/js/*天然放行。也可以直接在 Filter 里判断请求路径是否以.css、.js、.jpg结尾是就直接放行。5.4 Ajax 请求一直进 error 分支现象页面无跳转控制台报SyntaxError: Unexpected token或 Network 里能看到响应但 success 不执行。原因后端返回的 JSON 格式不合法。常见两类一是response.setContentType设成了text/html二是 Java 层直接out.print(emp.toString())输出的不是 JSON 格式。解决先把 Network 面板里的响应原文复制出来贴到在线 JSON 校验工具里看哪里不合法。后端统一返回{code: 0, message: ...}这种结构前端只解析这一种结构逻辑会顺很多。5.5 启动时报 ClassNotFoundException: com.mysql.jdbc.Driver现象Tomcat 一启动就报找不到数据库驱动类但lib目录里明明放着mysql-connector-java.jar。原因IDEA 的 Artifact 在部署时没把 jar 打包进WEB-INF/lib。常见于导入工程时 IDE 没自动识别 Web 依赖只确认了源码路径。解决进入Project Structure → Artifacts选中项目在 Output Layout 里把 lib 目录或需要的 jar 添加到WEB-INF/lib下重新 Build。再启动前看一眼生成的 Artifact 目录里是否真的有 jar。5.6 两个人同时预约同一个会议室后提交的也成功了现象会议室 10:00-12:00 已被 A 预约B 又提交同一时段的预约系统没提示冲突。原因meeting表没做唯一约束业务代码里没做时间重叠校验只简单地执行 insert。解决先查有没有重叠时间段再决定是否插入。判断重叠的 SQL 是两条条件的组合新预约的开始时间在已有时间段内或新预约的结束时间在已有时间段内。写成 SQL 就是WHERE roomid? AND starttime ? AND endtime ?参数分别传新预约的结束时间和开始时间。这个逻辑第 6 章再展开。6. 进阶改造加测试、日志和预约冲突校验让项目变成你的简历作品项目能跑通、源码也读透了这套系统还有不少进阶空间。我建议按顺序做三件事给 DAO 层写单元测试用日志替换System.out.println再把预约时间冲突校验补上。做完这三件事这套源码就不再是「跑通就行」的课程作业而是一个能撑住面试追问的完整项目。先说单元测试。DAO 层的测试不依赖 Tomcat是最小的验证方式只需要数据库连接可用public class EmployeeDaoTest { Test public void testFindByUsernameAndPassword() { EmployeeDao dao new EmployeeDao(); Employee emp dao.findByUsernameAndPassword(admin, 123456); assertNotNull(emp, admin 账号应能查到员工信息); assertEquals(系统管理员, emp.getName()); } }这里用 JUnit 4一个注解加两个断言就够了不需要引入 Spring 那套测试框架。跑测试前要确认数据库状态建议单独配一个test.properties与开发环境隔离。自从把 DAO 测试补上以后每次改 SQL 都先跑一遍再启动 Tomcat省掉了大把无谓的浏览器刷新时间。再说日志。源码里到处是e.printStackTrace()和System.out.println排障时看不出上下文。换成 Log4j 只需两步在src下放一份log4j.properties再把 catch 块改成private static final Logger LOGGER Logger.getLogger(EmployeeDao.class.getName()); catch (SQLException e) { LOGGER.error(查询员工失败, username{}, username, e); }{}是占位符日志框架会自动把参数拼进去避免手动拼接字符串。调试时把级别调到 DEBUG发布时调到 INFO比打印到控制台灵活太多。最后是预约冲突校验把它加到提交预约的 Service 层判断里用一条查询检查重叠区间SELECT COUNT(*) FROM meeting WHERE roomid ? -- 要预约的会议室 AND starttime ? -- 新预约的结束时间 AND endtime ? -- 新预约的开始时间这个查询的含义是已存在记录中有任一条的开始时间早于新预约的结束时间且结束时间晚于新预约的开始时间说明两个时间段有了交集。查询结果大于 0 就直接拒绝本次预约。这段逻辑虽然只有一条 SQL但在面试里能很自然地讲清楚「时间区间重叠」的判断思路是实打实的加分项。从那以后我每次拿到别人的 Web 项目都会强制自己走一遍这套流程先把它跑起来再理清请求链路然后审数据层最后补测试和日志。这套流程走完代码里哪些是能学的、哪些是必须改的一眼就能分清楚。希望帮到你。本文还有配套的精品资源点击获取
