简介基于Java Web的公司访客登记系统是一份完整的课程设计资源包面向正在学习Java Web开发的学生以及需要快速构建访客管理应用的新手开发者。系统覆盖访客信息的添加、修改、删除、检索查询和分类统计五大核心功能通过表单处理、数据库读写和动态页面呈现帮助企业规范来访登记流程也便于理解企业级Web应用的典型业务闭环。压缩包共含64个文件主要包含Java源文件、JSP视图页面、class编译文件、SQL数据库脚本、CSS样式及项目配置文件总大小仅966KB目录结构清晰src与WebRoot分离便于逐模块阅读和复用。目前已有127人学习下载包内除完整源码外还附带companyvisitor.sql数据库脚本、课程设计报告以及README说明既可用于课程设计参考或答辩展示也可直接导入Eclipse等IDE运行调试尤其适合通过实际项目掌握Servlet/JSP/JDBC三层架构和MVC设计模式的具体落地方式。1. 访客登记系统课程设计从需求到能演示的Java Web项目网上搜“Java Web 公司访客登记系统 源码 数据库 报告”能下到不少压缩包但解压后最常见的结局是数据库脚本和源码版本对不上、JSP页面中文乱码、报告里的表结构和实际部署完全两套东西。课程设计不应该是拼凑一个能跑通的Demo而是一套能自圆其说的交付物——可导入的MySQL脚本、能解释关系的表结构以及能把请求到数据库整条链路讲清楚的Java Web代码。这篇文章直接按课程设计交付顺序来先定表结构再搭ServletJSPJDBC骨架然后实现登记、签离、多条件查询和黑名单最后落到部署到本机Tomcat之后的驱动与时区排错。适合正在做数据库课程设计、或第一次独立完成Java Web工程的学生。2. 访客登记系统的数据建模从ER图到建库SQL2.1 访客登记流程与实体关系拆解先把业务闭环画出来访客到前台说找谁前台确认被访员工在岗、登记来访事由和时间访客离开时执行签离管理员能查全部记录、处理黑名单。最小实体集合是四个管理员、访客、被访员工、来访记录。访客和员工之间存在明显的“多次来访”关系但课程设计没必要单独拆关联表用一条来访记录表把两侧的外键挂上即可ER图上一对多关系清晰答辩也好讲。提示报告里的ER图不用画得太散把“员工”“访客”当主实体、“来访记录”当弱实体控制在一张图内配合下面这张属性表数据建模这一章基本就能站稳。实体关键属性在系统里的角色管理员账号、密码、姓名登录与后台管理访客姓名、手机、身份证号被登记对象员工工号、姓名、部门被访目标来访记录到访时间、签离时间、事由、状态核心业务数据2.2 数据库表结构与MySQL建表语句四张表按ER图落地。管理员表存登录身份访客表和员工表独立维护来访记录表保存所有关联。这里特意把状态字段设计成TINYINT0表示未签离、1表示已签离后面统计“当前还有多少访客在楼里”时直接WHERE status0比判断leave_time IS NULL更直白也更容易写索引说明。CREATE DATABASE visitor_system DEFAULT CHARACTER SET utf8mb4; USE visitor_system; CREATE TABLE t_admin ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_visitor ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20) NOT NULL UNIQUE, id_card VARCHAR(18), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_employee ( id INT PRIMARY KEY AUTO_INCREMENT, emp_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, department VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_visit_record ( id INT PRIMARY KEY AUTO_INCREMENT, visitor_id INT NOT NULL, employee_id INT NOT NULL, visit_time DATETIME DEFAULT CURRENT_TIMESTAMP, leave_time DATETIME NULL, reason VARCHAR(255), status TINYINT DEFAULT 0, CONSTRAINT fk_visitor FOREIGN KEY (visitor_id) REFERENCES t_visitor(id), CONSTRAINT fk_employee FOREIGN KEY (employee_id) REFERENCES t_employee(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字符集选 utf8mb4 而不是 utf8原因在于手机号前缀符号、来访事由里偶尔带上 emoji 时 utf8 会直接报错utf8mb4 是 MySQL 5.7 以上的兼容替代。外键在课程设计里建议保留让报告里的ER图和物理表结构能对应指认等工作后做分库分表再谈去掉外键。leave_time允许为空配合status0双重表达“访客尚未离场”这个冗余设计答辩时值得主动讲。2.3 初始化数据与课程设计报告里的E-R图说明建表后必须先准备初始化数据否则系统第一次启动登录不进去。初始化SQL同时也充当演示数据报告截图的内容是否饱满也靠它。常见做法是单独拆一个 init_data.sql登录账号默认 admin密码存放的是“123456”的 SHA-256 散列值8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92数据库里不允许存明文口令。INSERT INTO t_admin (username, password, real_name) VALUES (admin, 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92, 系统管理员); INSERT INTO t_employee (emp_no, name, department) VALUES (E001, 张伟, 研发部), (E002, 李娜, 人事部); INSERT INTO t_visitor (name, phone, id_card) VALUES (王强, 13800138000, 110101199001011234); INSERT INTO t_visit_record (visitor_id, employee_id, reason, status, leave_time) VALUES (1, 1, 项目技术交流, 1, NOW());这段数据里特意造了一条已签离记录让列表页第一屏就有内容。报告中的E-R图用“矩形表示实体、菱形表示联系”画来访记录与访客、员工各连一条1:N线文字描述写“一个访客可产生多条记录每条记录对应一名访客和一名员工”字段级对应关系表里列清楚数据库设计部分就扎实了。3. Java Web项目骨架Servlet JSP JDBC 的选型与搭建3.1 为什么采用Servlet JSP JDBC而不是直接上Spring Boot课程设计的核心目标是可演示、原理讲得清、代码量可控。Spring Boot 开发效率确实高但对访客登记系统这种量级的项目自动配置会把 URL 映射、请求转发、连接获取这些基础过程藏起来老师问到“一个请求从按钮到数据库经历了什么”反而讲不深。Servlet JSP JDBC 是 Java Web 的基础链路也正是 java 面试题里常考的“Servlet生命周期”“JDBC连接步骤”对应的载体。下面这个对比可以直接写进报告选型说明里。对比项ServletJSPJDBCSpring Boot请求处理手动 web.xml 或注解映射注解自动配置原理可见性高适合答辩自动配置有隐藏依赖管理Maven 引入少量依赖starter 全家桶报告可写深度原理点多会更偏接口结果如果学校允许 Spring Boot可以按同一套表结构替换 DAO 层为 MyBatis-Plus但这里按 Servlet JSP JDBC 为主线原因是它对“不使用重量级框架”的课程设计场景兼容性最好也最能体现 java 基础功底。3.2 用Maven搭建工程结构和pom依赖选择 Maven 而非手动导 jar 包是因为依赖传递和打包 war 都由工具完成。项目结构按标准布局src/main/java放包和类src/main/webapp放 JSP、静态资源src/main/resources放配置。IDEA 导入后要确认 packaging 是 war否则最后没法扔进 Tomcat。packagingwar/packaging properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjsp-api/artifactId version2.0/version scopeprovided/scope /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.20/version /dependency dependency groupIdjstl/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependenciesservlet-api 和 jsp-api 的 scope 必须设成 provided因为 Tomcat 的 lib 目录已经带这两个 jarwar 里重复打包会在启动时发生类冲突。mysql-connector-java 选 8.x对应 MySQL 5.7 和 8.0 都能连。连接池用 Druid 而不是手写 DriverManager一是后面可以直接打开监控页看 SQL 执行次数二是报告里关于连接复用的论证有实际数据支撑。3.3 JDBC连接与登录拦截公共类所有 Servlet 共用一个 JdbcUtil从 Druid 连接池取 Connection。这一步不要在课程设计里节省否则每个 Servlet 都写一遍Class.forName和DriverManager.getConnection代码重复不说出问题时排错范围会变大。public class JdbcUtil { private static DataSource dataSource; static { try { Properties p new Properties(); p.load(JdbcUtil.class.getClassLoader().getResourceAsStream(db.properties)); dataSource DruidDataSourceFactory.createDataSource(p); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }db.properties 放在src/main/resources下Druid 的DruidDataSourceFactory会读取其中四个核心参数。initialSize5表示初始化 5 个物理连接maxActive20是最大连接数课程设计阶段不要调太大连接数设高会导致本机 MySQL 的 max_connections 压力变大答辩时容易被追问“你评估过并发吗”。driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/visitor_system?serverTimezoneAsia/ShanghaicharacterEncodingutf8useSSLfalseallowPublicKeyRetrievaltrue usernameroot password123456 initialSize5 maxActive20 maxWait3000url 里serverTimezoneAsia/Shanghai要特别注意MySQL 8.x 驱动默认按 UTC 处理时间缺了这个参数查询出来的时间整体比本地晚 8 小时。allowPublicKeyRetrievaltrue在 MySQL 8 使用 caching_sha2_password 认证时需要否则连接阶段会直接报 Public Key Retrieval is not allowed。db.properties 里的 root 密码是数据库连接密码和 t_admin 表里的管理员登录口令是两个东西报告里要写清楚。4. 访客登记系统核心功能从登记列表到黑名单4.1 管理员登录、Session校验与全局过滤器登录接口接收表单提交的 username 和 password密码先做 SHA-256 散列再与数据库比对。这里不要用 MD5MD5 已经被大量彩虹表覆盖散列碰撞成本低。SHA-256 同样属于哈希摘要算法它的设计目标就是不可逆数据库被拖走后管理员口令不会直接明文暴露。WebServlet(/login) public class LoginServlet extends HttpServlet { Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String username req.getParameter(username); String password sha256(req.getParameter(password)); // 密码先摘要再入库比对 try (Connection conn JdbcUtil.getConnection(); PreparedStatement ps conn.prepareStatement( SELECT * FROM t_admin WHERE username? AND password?)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { req.getSession().setAttribute(admin, username); resp.sendRedirect(record/list); } else { req.setAttribute(error, 账号或密码错误); req.getRequestDispatcher(login.jsp).forward(req, resp); } } } catch (SQLException e) { throw new ServletException(e); } } private String sha256(String raw) throws ServletException { try { MessageDigest md MessageDigest.getInstance(SHA-256); byte[] digest md.digest(raw.getBytes(StandardCharsets.UTF_8)); StringBuilder sb new StringBuilder(); for (byte b : digest) { sb.append(String.format(%02x, b)); } return sb.toString(); } catch (NoSuchAlgorithmException e) { throw new ServletException(e); } } }PreparedStatement 的占位符传参是防 SQL 注入的标准姿势访客姓名和事由属于用户输入只要有一处字符串拼接登录状态就可能被绕过。登录后的每个业务 Servlet 都要校验 Session更省事的方式是用全局过滤器统一拦截白名单放行登录页、登录接口和静态资源。WebFilter(/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); if (uri.endsWith(login.jsp) || uri.endsWith(/login) || uri.contains(static/) || uri.endsWith(.css) || uri.endsWith(.js)) { chain.doFilter(req, resp); return; } if (request.getSession().getAttribute(admin) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }过滤器判断 URI 后缀放行静态资源否则 css 和 js 会被拦在登录页外面。登录成功后的重定向要带request.getContextPath()前缀比如/visitor-system/record/list这样在 IDEA 内嵌容器和外部 Tomcat 部署两种环境下路径才一致否则会出现只在某一边能访问的 404。4.2 访客登记表单与多条件分页查询登记页面的表单收集访客姓名、手机号、被访员工、来访事由。这里有一个值得写进报告的设计决策访客是老访客还是新访客。课程设计项目一般采用“手机号判重”方案查到则复用旧访客 id查不到先插入再取主键。这比每次访问都无脑新增一条访客记录更接近真实前台场景。public void saveVisit(VisitRecord record) throws SQLException { Connection conn JdbcUtil.getConnection(); try { conn.setAutoCommit(false); // 访客和拜访记录两个写操作放同一事务 long visitorId findOrCreateVisitor(conn, record.getVisitor()); try (PreparedStatement ps conn.prepareStatement( INSERT INTO t_visit_record(visitor_id, employee_id, reason) VALUES(?,?,?))) { ps.setLong(1, visitorId); ps.setLong(2, record.getEmployeeId()); ps.setString(3, record.getReason()); ps.executeUpdate(); } conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.close(); } } private long findOrCreateVisitor(Connection conn, Visitor v) throws SQLException { String select SELECT id FROM t_visitor WHERE phone? LIMIT 1; try (PreparedStatement ps conn.prepareStatement(select)) { ps.setString(1, v.getPhone()); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { return rs.getLong(id); } } } String insert INSERT INTO t_visitor(name, phone, id_card) VALUES(?,?,?); try (PreparedStatement ps conn.prepareStatement(insert, Statement.RETURN_GENERATED_KEYS)) { ps.setString(1, v.getName()); ps.setString(2, v.getPhone()); ps.setString(3, v.getIdCard()); ps.executeUpdate(); try (ResultSet keys ps.getGeneratedKeys()) { if (keys.next()) { return keys.getLong(1); } throw new SQLException(访客主键生成失败); } } }事务边界必须覆盖“查访客、插访客、插记录”这三个动作否则可能出现访客表写成功、拜访记录写失败的半截状态。Statement.RETURN_GENERATED_KEYS是拿自增主键的接口课程设计里比先 select max(id) 再插入可靠得多。并发极端情况下两个请求同时手机号判空可能插入重复手机号但 t_visitor.phone 建了唯一索引兜底。列表页多条件查询是另一个核心点按访客姓名模糊查、按被访员工姓名模糊查、按状态查三个条件任意组合。SQL 骨架用动态拼接把条件和参数分别放进两个集合最后统一用 PreparedStatement 绑定。StringBuilder sql new StringBuilder( SELECT r.*, v.name visitor_name, v.phone, e.name emp_name, e.department FROM t_visit_record r JOIN t_visitor v ON r.visitor_idv.id JOIN t_employee e ON r.employee_ide.id WHERE 11); ListObject params new ArrayList(); if (StringUtils.isNotBlank(visitorName)) { sql.append( AND v.name LIKE ?); // 参数值才拼接用户输入骨架拼接安全 params.add(% visitorName %); } if (StringUtils.isNotBlank(empName)) { sql.append( AND e.name LIKE ?); params.add(% empName %); } if (status ! null status 0) { sql.append( AND r.status ?); params.add(status); } sql.append( ORDER BY r.visit_time DESC LIMIT ?,?); int pageNum Integer.parseInt(req.getParameter(pageNum)); int pageSize 10; params.add((pageNum - 1) * pageSize); params.add(pageSize);WHERE 11 在这里只做占位让后续每个 AND 不用判断是否为第一个条件简单但实用。StringUtils 可用 commons-lang3 的或自己写一个反正只是空判断。模糊查询参数拼接了%用户输入里本身带%或_时会被当成通配符课程设计阶段不转义问题不大但在报告“改进方向”里提一句“对通配符做 escape 处理”会显得考虑充分。分页要先用SELECT COUNT(*)算出总记录数再按 total 除以 pageSize 得到总页数。4.3 签离登记与来访记录状态更新签离操作本质是把 status 从 0 改成 1 并写 leave_time。前台签离页展示的是“未签离列表”每条记录旁边放一个签离按钮点击后按主键更新UPDATE t_visit_record SET status1, leave_timeNOW() WHERE id? AND status0WHERE 里带 status0 是防重入的关键避免前端连点两次按钮导致 leave_time 被第二次覆盖。这个小细节答辩时提一句“更新带状态条件防止并发重复提交”比背概念更有说服力。签离成功后回到列表页顶部统计卡片显示“当前在访人数”和“今日来访次数”SELECT COUNT(*) FROM t_visit_record WHERE status0; SELECT COUNT(*) FROM t_visit_record WHERE DATE(visit_time)CURDATE();两个统计都走简单聚合查询页面刷新时执行即可不需要引入额外缓存组件。注意第二句里的DATE()会让 visit_time 上的索引失效数据量到十万级再考虑改范围查询课程设计阶段不必折腾。4.4 黑名单与数据统计的扩展思路黑名单最省事的做法是在 t_visitor 表加 black_reason 和 black_time 两个字段不需要新增实体。登记流程里执行 findOrCreateVisitor 时多查一次 black_reason 是否为空为空继续登记非空则弹提示并拒绝。这样一访客多记录的结构不用改黑名单只是访客属性上落一个标记。数据统计页可以复用 4.3 的聚合 SQL按部门分组看“哪个部门来访最多”前端用一组柱状图展示即可不影响核心表结构却能撑起报告里“系统扩展性”的小节。5. 部署演示与排错Tomcat、MySQL时区与驱动问题5.1 打war包并部署到本机TomcatMaven 执行 package 后 target 目录会生成 war 包。war 包名建议固定为英文否则 Tomcat 自动解压出来的目录带中文浏览器地址栏编码不一致时就容易 404。pom 里加一句 finalName 是最稳妥的build finalNamevisitor-system/finalName plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-war-plugin/artifactId version3.4.0/version /plugin /plugins /build把 visitor-system.war 拷进 Tomcat 的 webapps 目录启动后访问http://localhost:8080/visitor-system/login.jsp。如果页面上按钮和样式全乱先看浏览器开发者工具里 css 路径有没有带上项目名JSP 里的引用地址建议统一写${pageContext.request.contextPath}开头。5.2 三个常见报错对照与修复方法课程设计答辩前夜的高频报错集中在驱动和时区上。第一个是ClassNotFoundException: com.mysql.cj.jdbc.Driver多半是依赖没进最终 war解压 war 检查 WEB-INF/lib 里有没有 mysql-connector-java。第二个是The server time zone value is unrecognized按 3.3 在 url 加 serverTimezone 参数解决。第三个是Access denied for user除了密码错还有可能是 root 只允许 localhost 登录项目里用 127.0.0.1 连接时需要单独授权。报错现象常见原因修复方法ClassNotFoundException驱动 jar 未打入 war检查 pom 依赖和 WEB-INF/libUnknown time zone / 时间差8小时url 缺 serverTimezoneurl 增加 serverTimezoneAsia/ShanghaiPublic Key Retrieval is not allowedMySQL8 caching_sha2_passwordurl 增加 allowPublicKeyRetrievaltrueAccess denied for user密码错或 host 限制核对 db.properties 并单独授权MySQL 8.0 以上不支持GRANT ... IDENTIFIED BY一次性完成建用户和授权需要先CREATE USER root127.0.0.1 IDENTIFIED BY 123456再GRANT ALL PRIVILEGES ON visitor_system.* TO root127.0.0.1。这个变化在老师的教学环境里经常出现先写出来能省不少时间。5.3 给课程设计报告用的验证清单与Druid监控技巧验证清单按功能链路排登录拦截是否生效、登记时老访客是否复用 id、签离后状态是否变 1、模糊查询能否匹配中文姓名、分页跳转后筛选条件是否保留。最后一条是最常翻车的——翻页链接只拼 pageNum 不拼查询条件第二页开始筛选全部丢失。修复方式是在分页 nav 标签里把所有查询参数按隐藏域或 URL 参数形式带过去动手改一次就能记住。答辩环节给一个加分技巧打开 Druid 监控页。在 web.xml 里注册 StatViewServlet把/druid/*映射到com.alibaba.druid.support.http.StatViewServlet配好 loginUsername 和 loginPassword重启后访问http://localhost:8080/visitor-system/druid/index.html就能看到 SQL 执行统计、连接池活跃连接数。现场演示“连续登记三个人监控页里 ExecuteCount 加三”比口头解释“每次访问数据库都通过连接池”直观得多。课程设计做到这一步核心链路完整、每一步都有数据支撑就能交出一份经得住追问的交付物。本文还有配套的精品资源点击获取
简介基于Java Web的公司访客登记系统是一份完整的课程设计资源包面向正在学习Java Web开发的学生以及需要快速构建访客管理应用的新手开发者。系统覆盖访客信息的添加、修改、删除、检索查询和分类统计五大核心功能通过表单处理、数据库读写和动态页面呈现帮助企业规范来访登记流程也便于理解企业级Web应用的典型业务闭环。压缩包共含64个文件主要包含Java源文件、JSP视图页面、class编译文件、SQL数据库脚本、CSS样式及项目配置文件总大小仅966KB目录结构清晰src与WebRoot分离便于逐模块阅读和复用。目前已有127人学习下载包内除完整源码外还附带companyvisitor.sql数据库脚本、课程设计报告以及README说明既可用于课程设计参考或答辩展示也可直接导入Eclipse等IDE运行调试尤其适合通过实际项目掌握Servlet/JSP/JDBC三层架构和MVC设计模式的具体落地方式。1. 访客登记系统课程设计从需求到能演示的Java Web项目网上搜“Java Web 公司访客登记系统 源码 数据库 报告”能下到不少压缩包但解压后最常见的结局是数据库脚本和源码版本对不上、JSP页面中文乱码、报告里的表结构和实际部署完全两套东西。课程设计不应该是拼凑一个能跑通的Demo而是一套能自圆其说的交付物——可导入的MySQL脚本、能解释关系的表结构以及能把请求到数据库整条链路讲清楚的Java Web代码。这篇文章直接按课程设计交付顺序来先定表结构再搭ServletJSPJDBC骨架然后实现登记、签离、多条件查询和黑名单最后落到部署到本机Tomcat之后的驱动与时区排错。适合正在做数据库课程设计、或第一次独立完成Java Web工程的学生。2. 访客登记系统的数据建模从ER图到建库SQL2.1 访客登记流程与实体关系拆解先把业务闭环画出来访客到前台说找谁前台确认被访员工在岗、登记来访事由和时间访客离开时执行签离管理员能查全部记录、处理黑名单。最小实体集合是四个管理员、访客、被访员工、来访记录。访客和员工之间存在明显的“多次来访”关系但课程设计没必要单独拆关联表用一条来访记录表把两侧的外键挂上即可ER图上一对多关系清晰答辩也好讲。提示报告里的ER图不用画得太散把“员工”“访客”当主实体、“来访记录”当弱实体控制在一张图内配合下面这张属性表数据建模这一章基本就能站稳。实体关键属性在系统里的角色管理员账号、密码、姓名登录与后台管理访客姓名、手机、身份证号被登记对象员工工号、姓名、部门被访目标来访记录到访时间、签离时间、事由、状态核心业务数据2.2 数据库表结构与MySQL建表语句四张表按ER图落地。管理员表存登录身份访客表和员工表独立维护来访记录表保存所有关联。这里特意把状态字段设计成TINYINT0表示未签离、1表示已签离后面统计“当前还有多少访客在楼里”时直接WHERE status0比判断leave_time IS NULL更直白也更容易写索引说明。CREATE DATABASE visitor_system DEFAULT CHARACTER SET utf8mb4; USE visitor_system; CREATE TABLE t_admin ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, real_name VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_visitor ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL, phone VARCHAR(20) NOT NULL UNIQUE, id_card VARCHAR(18), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_employee ( id INT PRIMARY KEY AUTO_INCREMENT, emp_no VARCHAR(20) NOT NULL UNIQUE, name VARCHAR(50) NOT NULL, department VARCHAR(50) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE t_visit_record ( id INT PRIMARY KEY AUTO_INCREMENT, visitor_id INT NOT NULL, employee_id INT NOT NULL, visit_time DATETIME DEFAULT CURRENT_TIMESTAMP, leave_time DATETIME NULL, reason VARCHAR(255), status TINYINT DEFAULT 0, CONSTRAINT fk_visitor FOREIGN KEY (visitor_id) REFERENCES t_visitor(id), CONSTRAINT fk_employee FOREIGN KEY (employee_id) REFERENCES t_employee(id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字符集选 utf8mb4 而不是 utf8原因在于手机号前缀符号、来访事由里偶尔带上 emoji 时 utf8 会直接报错utf8mb4 是 MySQL 5.7 以上的兼容替代。外键在课程设计里建议保留让报告里的ER图和物理表结构能对应指认等工作后做分库分表再谈去掉外键。leave_time允许为空配合status0双重表达“访客尚未离场”这个冗余设计答辩时值得主动讲。2.3 初始化数据与课程设计报告里的E-R图说明建表后必须先准备初始化数据否则系统第一次启动登录不进去。初始化SQL同时也充当演示数据报告截图的内容是否饱满也靠它。常见做法是单独拆一个 init_data.sql登录账号默认 admin密码存放的是“123456”的 SHA-256 散列值8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92数据库里不允许存明文口令。INSERT INTO t_admin (username, password, real_name) VALUES (admin, 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92, 系统管理员); INSERT INTO t_employee (emp_no, name, department) VALUES (E001, 张伟, 研发部), (E002, 李娜, 人事部); INSERT INTO t_visitor (name, phone, id_card) VALUES (王强, 13800138000, 110101199001011234); INSERT INTO t_visit_record (visitor_id, employee_id, reason, status, leave_time) VALUES (1, 1, 项目技术交流, 1, NOW());这段数据里特意造了一条已签离记录让列表页第一屏就有内容。报告中的E-R图用“矩形表示实体、菱形表示联系”画来访记录与访客、员工各连一条1:N线文字描述写“一个访客可产生多条记录每条记录对应一名访客和一名员工”字段级对应关系表里列清楚数据库设计部分就扎实了。3. Java Web项目骨架Servlet JSP JDBC 的选型与搭建3.1 为什么采用Servlet JSP JDBC而不是直接上Spring Boot课程设计的核心目标是可演示、原理讲得清、代码量可控。Spring Boot 开发效率确实高但对访客登记系统这种量级的项目自动配置会把 URL 映射、请求转发、连接获取这些基础过程藏起来老师问到“一个请求从按钮到数据库经历了什么”反而讲不深。Servlet JSP JDBC 是 Java Web 的基础链路也正是 java 面试题里常考的“Servlet生命周期”“JDBC连接步骤”对应的载体。下面这个对比可以直接写进报告选型说明里。对比项ServletJSPJDBCSpring Boot请求处理手动 web.xml 或注解映射注解自动配置原理可见性高适合答辩自动配置有隐藏依赖管理Maven 引入少量依赖starter 全家桶报告可写深度原理点多会更偏接口结果如果学校允许 Spring Boot可以按同一套表结构替换 DAO 层为 MyBatis-Plus但这里按 Servlet JSP JDBC 为主线原因是它对“不使用重量级框架”的课程设计场景兼容性最好也最能体现 java 基础功底。3.2 用Maven搭建工程结构和pom依赖选择 Maven 而非手动导 jar 包是因为依赖传递和打包 war 都由工具完成。项目结构按标准布局src/main/java放包和类src/main/webapp放 JSP、静态资源src/main/resources放配置。IDEA 导入后要确认 packaging 是 war否则最后没法扔进 Tomcat。packagingwar/packaging properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId version4.0.1/version scopeprovided/scope /dependency dependency groupIdjavax.servlet/groupId artifactIdjsp-api/artifactId version2.0/version scopeprovided/scope /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.30/version /dependency dependency groupIdcom.alibaba/groupId artifactIddruid/artifactId version1.2.20/version /dependency dependency groupIdjstl/groupId artifactIdjstl/artifactId version1.2/version /dependency /dependenciesservlet-api 和 jsp-api 的 scope 必须设成 provided因为 Tomcat 的 lib 目录已经带这两个 jarwar 里重复打包会在启动时发生类冲突。mysql-connector-java 选 8.x对应 MySQL 5.7 和 8.0 都能连。连接池用 Druid 而不是手写 DriverManager一是后面可以直接打开监控页看 SQL 执行次数二是报告里关于连接复用的论证有实际数据支撑。3.3 JDBC连接与登录拦截公共类所有 Servlet 共用一个 JdbcUtil从 Druid 连接池取 Connection。这一步不要在课程设计里节省否则每个 Servlet 都写一遍Class.forName和DriverManager.getConnection代码重复不说出问题时排错范围会变大。public class JdbcUtil { private static DataSource dataSource; static { try { Properties p new Properties(); p.load(JdbcUtil.class.getClassLoader().getResourceAsStream(db.properties)); dataSource DruidDataSourceFactory.createDataSource(p); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }db.properties 放在src/main/resources下Druid 的DruidDataSourceFactory会读取其中四个核心参数。initialSize5表示初始化 5 个物理连接maxActive20是最大连接数课程设计阶段不要调太大连接数设高会导致本机 MySQL 的 max_connections 压力变大答辩时容易被追问“你评估过并发吗”。driverClassNamecom.mysql.cj.jdbc.Driver urljdbc:mysql://localhost:3306/visitor_system?serverTimezoneAsia/ShanghaicharacterEncodingutf8useSSLfalseallowPublicKeyRetrievaltrue usernameroot password123456 initialSize5 maxActive20 maxWait3000url 里serverTimezoneAsia/Shanghai要特别注意MySQL 8.x 驱动默认按 UTC 处理时间缺了这个参数查询出来的时间整体比本地晚 8 小时。allowPublicKeyRetrievaltrue在 MySQL 8 使用 caching_sha2_password 认证时需要否则连接阶段会直接报 Public Key Retrieval is not allowed。db.properties 里的 root 密码是数据库连接密码和 t_admin 表里的管理员登录口令是两个东西报告里要写清楚。4. 访客登记系统核心功能从登记列表到黑名单4.1 管理员登录、Session校验与全局过滤器登录接口接收表单提交的 username 和 password密码先做 SHA-256 散列再与数据库比对。这里不要用 MD5MD5 已经被大量彩虹表覆盖散列碰撞成本低。SHA-256 同样属于哈希摘要算法它的设计目标就是不可逆数据库被拖走后管理员口令不会直接明文暴露。WebServlet(/login) public class LoginServlet extends HttpServlet { Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String username req.getParameter(username); String password sha256(req.getParameter(password)); // 密码先摘要再入库比对 try (Connection conn JdbcUtil.getConnection(); PreparedStatement ps conn.prepareStatement( SELECT * FROM t_admin WHERE username? AND password?)) { ps.setString(1, username); ps.setString(2, password); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { req.getSession().setAttribute(admin, username); resp.sendRedirect(record/list); } else { req.setAttribute(error, 账号或密码错误); req.getRequestDispatcher(login.jsp).forward(req, resp); } } } catch (SQLException e) { throw new ServletException(e); } } private String sha256(String raw) throws ServletException { try { MessageDigest md MessageDigest.getInstance(SHA-256); byte[] digest md.digest(raw.getBytes(StandardCharsets.UTF_8)); StringBuilder sb new StringBuilder(); for (byte b : digest) { sb.append(String.format(%02x, b)); } return sb.toString(); } catch (NoSuchAlgorithmException e) { throw new ServletException(e); } } }PreparedStatement 的占位符传参是防 SQL 注入的标准姿势访客姓名和事由属于用户输入只要有一处字符串拼接登录状态就可能被绕过。登录后的每个业务 Servlet 都要校验 Session更省事的方式是用全局过滤器统一拦截白名单放行登录页、登录接口和静态资源。WebFilter(/*) public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); if (uri.endsWith(login.jsp) || uri.endsWith(/login) || uri.contains(static/) || uri.endsWith(.css) || uri.endsWith(.js)) { chain.doFilter(req, resp); return; } if (request.getSession().getAttribute(admin) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(req, resp); } }过滤器判断 URI 后缀放行静态资源否则 css 和 js 会被拦在登录页外面。登录成功后的重定向要带request.getContextPath()前缀比如/visitor-system/record/list这样在 IDEA 内嵌容器和外部 Tomcat 部署两种环境下路径才一致否则会出现只在某一边能访问的 404。4.2 访客登记表单与多条件分页查询登记页面的表单收集访客姓名、手机号、被访员工、来访事由。这里有一个值得写进报告的设计决策访客是老访客还是新访客。课程设计项目一般采用“手机号判重”方案查到则复用旧访客 id查不到先插入再取主键。这比每次访问都无脑新增一条访客记录更接近真实前台场景。public void saveVisit(VisitRecord record) throws SQLException { Connection conn JdbcUtil.getConnection(); try { conn.setAutoCommit(false); // 访客和拜访记录两个写操作放同一事务 long visitorId findOrCreateVisitor(conn, record.getVisitor()); try (PreparedStatement ps conn.prepareStatement( INSERT INTO t_visit_record(visitor_id, employee_id, reason) VALUES(?,?,?))) { ps.setLong(1, visitorId); ps.setLong(2, record.getEmployeeId()); ps.setString(3, record.getReason()); ps.executeUpdate(); } conn.commit(); } catch (SQLException e) { conn.rollback(); throw e; } finally { conn.close(); } } private long findOrCreateVisitor(Connection conn, Visitor v) throws SQLException { String select SELECT id FROM t_visitor WHERE phone? LIMIT 1; try (PreparedStatement ps conn.prepareStatement(select)) { ps.setString(1, v.getPhone()); try (ResultSet rs ps.executeQuery()) { if (rs.next()) { return rs.getLong(id); } } } String insert INSERT INTO t_visitor(name, phone, id_card) VALUES(?,?,?); try (PreparedStatement ps conn.prepareStatement(insert, Statement.RETURN_GENERATED_KEYS)) { ps.setString(1, v.getName()); ps.setString(2, v.getPhone()); ps.setString(3, v.getIdCard()); ps.executeUpdate(); try (ResultSet keys ps.getGeneratedKeys()) { if (keys.next()) { return keys.getLong(1); } throw new SQLException(访客主键生成失败); } } }事务边界必须覆盖“查访客、插访客、插记录”这三个动作否则可能出现访客表写成功、拜访记录写失败的半截状态。Statement.RETURN_GENERATED_KEYS是拿自增主键的接口课程设计里比先 select max(id) 再插入可靠得多。并发极端情况下两个请求同时手机号判空可能插入重复手机号但 t_visitor.phone 建了唯一索引兜底。列表页多条件查询是另一个核心点按访客姓名模糊查、按被访员工姓名模糊查、按状态查三个条件任意组合。SQL 骨架用动态拼接把条件和参数分别放进两个集合最后统一用 PreparedStatement 绑定。StringBuilder sql new StringBuilder( SELECT r.*, v.name visitor_name, v.phone, e.name emp_name, e.department FROM t_visit_record r JOIN t_visitor v ON r.visitor_idv.id JOIN t_employee e ON r.employee_ide.id WHERE 11); ListObject params new ArrayList(); if (StringUtils.isNotBlank(visitorName)) { sql.append( AND v.name LIKE ?); // 参数值才拼接用户输入骨架拼接安全 params.add(% visitorName %); } if (StringUtils.isNotBlank(empName)) { sql.append( AND e.name LIKE ?); params.add(% empName %); } if (status ! null status 0) { sql.append( AND r.status ?); params.add(status); } sql.append( ORDER BY r.visit_time DESC LIMIT ?,?); int pageNum Integer.parseInt(req.getParameter(pageNum)); int pageSize 10; params.add((pageNum - 1) * pageSize); params.add(pageSize);WHERE 11 在这里只做占位让后续每个 AND 不用判断是否为第一个条件简单但实用。StringUtils 可用 commons-lang3 的或自己写一个反正只是空判断。模糊查询参数拼接了%用户输入里本身带%或_时会被当成通配符课程设计阶段不转义问题不大但在报告“改进方向”里提一句“对通配符做 escape 处理”会显得考虑充分。分页要先用SELECT COUNT(*)算出总记录数再按 total 除以 pageSize 得到总页数。4.3 签离登记与来访记录状态更新签离操作本质是把 status 从 0 改成 1 并写 leave_time。前台签离页展示的是“未签离列表”每条记录旁边放一个签离按钮点击后按主键更新UPDATE t_visit_record SET status1, leave_timeNOW() WHERE id? AND status0WHERE 里带 status0 是防重入的关键避免前端连点两次按钮导致 leave_time 被第二次覆盖。这个小细节答辩时提一句“更新带状态条件防止并发重复提交”比背概念更有说服力。签离成功后回到列表页顶部统计卡片显示“当前在访人数”和“今日来访次数”SELECT COUNT(*) FROM t_visit_record WHERE status0; SELECT COUNT(*) FROM t_visit_record WHERE DATE(visit_time)CURDATE();两个统计都走简单聚合查询页面刷新时执行即可不需要引入额外缓存组件。注意第二句里的DATE()会让 visit_time 上的索引失效数据量到十万级再考虑改范围查询课程设计阶段不必折腾。4.4 黑名单与数据统计的扩展思路黑名单最省事的做法是在 t_visitor 表加 black_reason 和 black_time 两个字段不需要新增实体。登记流程里执行 findOrCreateVisitor 时多查一次 black_reason 是否为空为空继续登记非空则弹提示并拒绝。这样一访客多记录的结构不用改黑名单只是访客属性上落一个标记。数据统计页可以复用 4.3 的聚合 SQL按部门分组看“哪个部门来访最多”前端用一组柱状图展示即可不影响核心表结构却能撑起报告里“系统扩展性”的小节。5. 部署演示与排错Tomcat、MySQL时区与驱动问题5.1 打war包并部署到本机TomcatMaven 执行 package 后 target 目录会生成 war 包。war 包名建议固定为英文否则 Tomcat 自动解压出来的目录带中文浏览器地址栏编码不一致时就容易 404。pom 里加一句 finalName 是最稳妥的build finalNamevisitor-system/finalName plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-war-plugin/artifactId version3.4.0/version /plugin /plugins /build把 visitor-system.war 拷进 Tomcat 的 webapps 目录启动后访问http://localhost:8080/visitor-system/login.jsp。如果页面上按钮和样式全乱先看浏览器开发者工具里 css 路径有没有带上项目名JSP 里的引用地址建议统一写${pageContext.request.contextPath}开头。5.2 三个常见报错对照与修复方法课程设计答辩前夜的高频报错集中在驱动和时区上。第一个是ClassNotFoundException: com.mysql.cj.jdbc.Driver多半是依赖没进最终 war解压 war 检查 WEB-INF/lib 里有没有 mysql-connector-java。第二个是The server time zone value is unrecognized按 3.3 在 url 加 serverTimezone 参数解决。第三个是Access denied for user除了密码错还有可能是 root 只允许 localhost 登录项目里用 127.0.0.1 连接时需要单独授权。报错现象常见原因修复方法ClassNotFoundException驱动 jar 未打入 war检查 pom 依赖和 WEB-INF/libUnknown time zone / 时间差8小时url 缺 serverTimezoneurl 增加 serverTimezoneAsia/ShanghaiPublic Key Retrieval is not allowedMySQL8 caching_sha2_passwordurl 增加 allowPublicKeyRetrievaltrueAccess denied for user密码错或 host 限制核对 db.properties 并单独授权MySQL 8.0 以上不支持GRANT ... IDENTIFIED BY一次性完成建用户和授权需要先CREATE USER root127.0.0.1 IDENTIFIED BY 123456再GRANT ALL PRIVILEGES ON visitor_system.* TO root127.0.0.1。这个变化在老师的教学环境里经常出现先写出来能省不少时间。5.3 给课程设计报告用的验证清单与Druid监控技巧验证清单按功能链路排登录拦截是否生效、登记时老访客是否复用 id、签离后状态是否变 1、模糊查询能否匹配中文姓名、分页跳转后筛选条件是否保留。最后一条是最常翻车的——翻页链接只拼 pageNum 不拼查询条件第二页开始筛选全部丢失。修复方式是在分页 nav 标签里把所有查询参数按隐藏域或 URL 参数形式带过去动手改一次就能记住。答辩环节给一个加分技巧打开 Druid 监控页。在 web.xml 里注册 StatViewServlet把/druid/*映射到com.alibaba.druid.support.http.StatViewServlet配好 loginUsername 和 loginPassword重启后访问http://localhost:8080/visitor-system/druid/index.html就能看到 SQL 执行统计、连接池活跃连接数。现场演示“连续登记三个人监控页里 ExecuteCount 加三”比口头解释“每次访问数据库都通过连接池”直观得多。课程设计做到这一步核心链路完整、每一步都有数据支撑就能交出一份经得住追问的交付物。本文还有配套的精品资源点击获取
