JavaWeb登录注册留言板源码解析：Servlet+JSP+JavaBean实战

简介这是一份面向JavaWeb入门与课程实践学习者的完整项目源码基于JSP、JavaBean与Servlet采用简单MVC模式实现登录注册、留言板与分页功能适合用来理解三层结构如何协作、完成课程设计或作为小型Web应用的起步模板。压缩包共78个文件约1.86MB包含14个java源文件与对应class、14个jsp页面、10个css样式、9个xml配置及properties、jar等依赖文件另附sql建库脚本覆盖模型层读写数据库、视图层展示信息、控制层衔接调度所需的各类素材。资源已有1613人学习下载说明其结构清晰、上手门槛适中。读者可从中获得一套可直接导入运行的工程骨架观察JavaBean如何封装数据、Servlet如何转发请求、JSP如何渲染列表与分页并借助建库脚本快速还原数据库环境为后续扩展功能或排查交互问题提供参照。1. 从一份“老派”JavaWeb源码说起登录注册加留言板到底能跑出什么打开这份源码第一眼看到的是web.xml、*.jsp、*Servlet.java、*Bean.java这几类文件混在同一个工程里没有 Spring没有 MyBatis连 Maven 的pom.xml都不一定齐全。很多刚接触 javaweb 的同学会下意识觉得“这玩意儿太老了学了没用”但我带过的新人里恰恰是先把这套 jspjavabeanservlet 的登录注册留言板完整跑通、再动手改过一遍的人后面接 Spring Boot 时对请求链路、会话状态、表单提交这些概念的理解明显更扎实。这份资源就是一个典型的教学型完整工程用户注册、登录校验、登录后发留言、留言列表展示四件事串起了一次 HTTP 请求从浏览器到数据库再回到页面的完整闭环。它适合两类人——想搞懂 JavaWeb 底层到底怎么运转的新手以及需要一份干净骨架做课程设计或二次开发起点的开发者。下面我按“能干什么、怎么跑、怎么改”的顺序把这份源码拆开讲。2. 工程结构与请求链路一个登录请求到底经过了哪些文件2.1 目录结构与各层职责这份工程是标准的 JavaWeb 分层写法虽然简单但层次是清楚的。常见目录结构大致如下不同 IDE 导出的略有差异以你拿到的为准LoginBoard/ ├── src/ │ └── com/example/ │ ├── bean/ # JavaBeanUser、Message │ ├── dao/ # 数据库访问UserDao、MessageDao │ ├── servlet/ # 控制器LoginServlet、RegisterServlet、MessageServlet │ └── util/ # DBUtil 等工具类 ├── WebContent/ 或 web/ │ ├── WEB-INF/ │ │ ├── web.xml # Servlet 映射、欢迎页配置 │ │ └── lib/ # 数据库驱动 jar │ ├── login.jsp │ ├── register.jsp │ ├── board.jsp # 留言板主页面 │ └── css/ js/ └── ...bean层是纯数据载体User里就是 id、username、password 几个字段加 getter/setterdao层负责拼 SQL、拿连接、关资源servlet层接收请求参数、调 dao、把结果塞进 request 或 session 再转发给 JSP。这种“JSP 管显示、Servlet 管流程、Bean 管数据”的分法就是 MVC 的雏形虽然土但每一层的边界是清晰的改起来不会牵一发动全身。2.2 一次登录请求的完整链路以登录为例用户在login.jsp填完表单点提交浏览器 POST 到/loginweb.xml里配置的LoginServlet接住请求取username、password两个参数调UserDao.findByUsernameAndPassword()查库查到就把User对象放进session重定向到留言板查不到就带错误信息转发回登录页。这条链路里有两个关键点新手容易忽略一是session的作用域登录成功后整个会话都能拿到当前用户二是转发forward和重定向redirect的区别登录失败用转发能保留 request 里的错误提示登录成功用重定向能避免刷新重复提交。// LoginServlet 核心逻辑示意字段名以实际源码为准 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String username request.getParameter(username); String password request.getParameter(password); UserDao dao new UserDao(); User user dao.findByUsernameAndPassword(username, password); // 查库校验 if (user ! null) { request.getSession().setAttribute(currentUser, user); // 登录态存 session response.sendRedirect(board.jsp); // 重定向防重复提交 } else { request.setAttribute(error, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); // 转发保留提示 } }参数说明getParameter拿的是表单字段名必须和 JSP 里input name...完全一致大小写都不能错setAttribute(currentUser, user)这个 key 后面在 JSP 里要用${sessionScope.currentUser.username}取名字对不上页面就是空白。sendRedirect的路径是相对于当前应用的写board.jsp还是/board.jsp取决于部署上下文部署在根路径下两者等价部署在子路径下就要注意。2.3 web.xml 里的映射配置Servlet 3.0 之后可以用WebServlet(/login)注解代替web.xml但这份老工程大概率还是 XML 配置。映射写错是新手第一个翻车点url-pattern和表单action必须对得上servlet-class必须是全限定类名。servlet servlet-nameLoginServlet/servlet-name servlet-classcom.example.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mappingservlet-name在两个标签里必须一致这是 XML 里最容易手滑的地方url-pattern写成/login表示精确匹配写成*.do就是后缀匹配这份工程一般用精确匹配。改完 XML 记得重启容器热部署不一定生效。3. 环境搭建与跑通步骤从零把工程跑起来3.1 环境准备与依赖确认这份工程依赖三样东西JDK建议 8 或 11老工程用高版本 JDK 可能遇到javax包找不到的问题、Tomcat8.5 或 9别上 Tomcat 10它把javax.servlet换成了jakarta.servlet老代码直接编译不过、MySQL5.7 或 8.0 都行。数据库驱动 jar 放在WEB-INF/lib下常见是mysql-connector-java-5.1.x.jar或8.0.x.jar版本要和 MySQL 服务端匹配5.1 的驱动连 8.0 的库有时会报时区或 SSL 错误。导入工程时Eclipse 用 “Import Existing Projects into Workspace”IDEA 用 “Open” 选工程根目录再配好 Facet 里的 Web 模块和 Artifact。这一步的坑在于IDEA 导入老工程后经常不认WebContent目录需要手动在 Project Structure 里把 Web Resource Directory 指过去否则 JSP 访问 404。3.2 建库建表与连接配置跑之前先把数据库准备好。表结构一般两张用户表和留言表。CREATE DATABASE IF NOT EXISTS login_board DEFAULT CHARSET utf8mb4; USE login_board; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(50) NOT NULL ); CREATE TABLE message ( id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, content VARCHAR(500) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );username加 UNIQUE 是为了注册时防重名message.user_id关联用户表展示留言时联查或先查用户再拼。字符集用utf8mb4不然留言里带表情符号会存成问号。连接配置通常在DBUtil里硬编码或者放在db.properties里读。// DBUtil 连接获取示意 public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/login_board?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai; private static final String USER root; private static final String PASS 你的密码; public static Connection getConnection() throws SQLException { try { Class.forName(com.mysql.cj.jdbc.Driver); // 8.0 驱动类名 return DriverManager.getConnection(URL, USER, PASS); } catch (ClassNotFoundException e) { throw new RuntimeException(驱动未找到, e); } } }serverTimezone参数在 MySQL 8.0 驱动下基本必加不加会报时区无法识别characterEncodingutf8保证中文不乱码。驱动类名 5.1 是com.mysql.jdbc.Driver8.0 是com.mysql.cj.jdbc.Driver写错就是ClassNotFoundException。3.3 部署运行与验证清单数据库通了之后把工程部署到 Tomcat 启动。验证顺序建议这样走先访问register.jsp注册一个账号看数据库user表有没有新记录再用这个账号登录看是否跳转到留言板然后发一条留言刷新页面看列表是否出现最后关浏览器重开直接访问board.jsp应该被拦回登录页如果工程做了登录拦截。这四步全过说明注册、登录、会话、留言写入和读取整条链路都是通的。提示如果board.jsp不做拦截也能直接访问说明这份工程可能没写登录过滤器二次开发时这是第一个要补的点。4. 核心模块拆解注册、登录、留言三块代码怎么读4.1 注册模块参数校验与防重名注册 Servlet 的逻辑比登录多一步“查重”。先按用户名查一次存在就返回错误不存在才 insert。这里有个血泪经验查重和插入之间理论上存在并发窗口两个人同时注册同一用户名可能都通过查重最终靠数据库 UNIQUE 约束兜底所以insert一定要捕获SQLIntegrityConstraintViolationException给用户一个友好提示而不是抛 500。// RegisterServlet 核心片段 String username request.getParameter(username); String password request.getParameter(password); if (username null || username.trim().isEmpty() || password null || password.length() 6) { request.setAttribute(error, 用户名不能为空密码至少 6 位); request.getRequestDispatcher(register.jsp).forward(request, response); return; } UserDao dao new UserDao(); if (dao.existsByUsername(username)) { // 先查重 request.setAttribute(error, 用户名已被占用); request.getRequestDispatcher(register.jsp).forward(request, response); return; } dao.insert(new User(username, password)); // 再插入靠 UNIQUE 兜底 response.sendRedirect(login.jsp);参数说明密码长度校验放在服务端前端 JS 校验只是体验优化不能当安全边界trim()处理用户名首尾空格避免“张三”和“张三 ”被当成两个账号。真实项目里密码要加盐哈希这份教学工程多半是明文存二次开发时这是必须改的第一件事。4.2 登录与会话管理登录模块的核心是 session。登录成功后session.setAttribute(currentUser, user)之后所有需要登录态的页面都从 session 取。留言板页面顶部显示“欢迎 xxx”就是靠这个。退出登录就是session.invalidate()或removeAttribute。// 退出登录 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { HttpSession session request.getSession(false); if (session ! null) { session.invalidate(); // 销毁整个会话 } response.sendRedirect(login.jsp); }getSession(false)表示没有会话就返回 null不新建退出场景用这个更合适invalidate()会把会话里所有属性清掉比逐个removeAttribute干净。注意 session 默认 30 分钟超时可以在web.xml里用session-configsession-timeout调调试时调短一点方便验证超时逻辑。4.3 留言板模块写入与列表展示留言写入就是拿 session 里的当前用户 id加上表单内容 insert 一条列表展示是select出来在 JSP 里用 JSTL 的c:forEach循环渲染。这块的关键在于 JSP 里不要写 Java 脚本片段% %用 EL 表达式和 JSTL 标签更干净也更好维护。%-- board.jsp 留言列表渲染片段 --% c:forEach varmsg items${messageList} div classmsg-item span classmsg-user${msg.username}/span span classmsg-time${msg.createTime}/span p classmsg-content${msg.content}/p /div /c:forEachmessageList是 Servlet 里request.setAttribute(messageList, list)放进去的JSP 直接用 EL 取。如果列表是空的c:forEach不渲染任何东西最好加个c:if test${empty messageList}显示“暂无留言”。留言内容输出时要注意 XSS教学工程一般直接${msg.content}输出真实场景要用c:out或后端转义这是二次开发要补的安全点。5. 避坑与常见问题排查跑不起来时先看这几条5.1 中文乱码POST 和 GET 处理方式不同现象注册的中文用户名存进库变成问号或者页面显示乱码。原因请求体编码和响应编码没统一。解决POST 请求在 Servlet 最前面加request.setCharacterEncoding(UTF-8)响应加response.setContentType(text/html;charsetUTF-8)GET 请求的参数编码取决于 Tomcat 的server.xml里 Connector 的URIEncodingTomcat 8 以后默认 UTF-8老版本要手动配。数据库连接串里的characterEncodingutf8和建库时的utf8mb4也要对上三处任一漏了都会乱码。5.2 数据库连接报错驱动版本和时区现象启动后第一次访问就抛No suitable driver或The server time zone value is unrecognized。原因驱动 jar 没放进WEB-INF/lib或者驱动类名写错或者 MySQL 8.0 没配时区。解决确认 jar 在lib下且被部署到 Tomcat 的WEB-INF/libIDEA 里要看 Artifact 输出目录驱动类名按版本改连接串加serverTimezoneAsia/Shanghai。还有一个隐蔽的工程里同时存在两个版本的驱动 jar类加载时冲突清掉旧的即可。5.3 404路径映射对不上现象表单提交后 404或者直接访问 JSP 404。原因web.xml的url-pattern和表单action不一致或者 JSP 文件不在 Web 根目录下或者 IDEA 的 Artifact 没把WebContent打进去。解决先看浏览器地址栏实际请求的路径再对照web.xmlIDEA 用户在 Project Structure 的 Artifacts 里确认 Output Layout 包含所有 JSP 和WEB-INFEclipse 用户检查 Deployment Assembly。5.4 登录后刷新重复提交现象登录成功后按 F5浏览器提示“是否重新提交表单”确认后又登录一次。原因登录成功用了 forward 而不是 redirect。解决所有“写操作成功后”的跳转一律用sendRedirect这是 PRGPost-Redirect-Get模式能彻底避免刷新重复提交。这条经验在后来做任何表单提交时都适用。5.5 session 拿不到当前用户现象留言板页面显示“欢迎 null”或者发留言时user_id为 0。原因登录时setAttribute的 key 和 JSP 里取的 key 不一致或者 session 超时了或者部署了多个应用导致 session 隔离。解决统一用一个常量类管理 session key比如public static final String SESSION_USER currentUser两边都引用常量杜绝手写字符串对不上。6. 二次开发改造思路从教学工程到能用的留言板这份源码跑通之后真正有价值的是在它上面改。我一般按“安全 → 结构 → 功能”的顺序动刀每一步都能独立验证不会改崩。第一步补安全。密码明文是最大的问题改成MessageDigest做 SHA-256 加盐注册时存哈希登录时对哈希比对改动集中在UserDao和两个 Servlet半小时能完成。XSS 用c:out替换所有${}输出SQL 注入检查所有 DAO 里是不是PreparedStatement占位符有字符串拼接的 SQL 全部改掉。登录拦截加一个Filter匹配/*放行login.jsp、register.jsp、/login、/register其余检查 session没有就重定向登录页。第二步调结构。把DBUtil的硬编码连接参数挪到db.properties用Properties加载DAO 里重复的“获取连接、执行、关闭”抽成模板方法或至少用 try-with-resources 保证关闭JSP 里残留的% %脚本片段全部换成 JSTL。这一步不改功能只改可维护性改完跑一遍第 3 章的四步验证清单全过就说明没改坏。第三步加功能。最常见的需求是留言分页和删除。分页在MessageDao里加limit offset参数Servlet 接收page参数算 offsetJSP 加翻页链接删除要校验当前用户是不是留言作者delete from message where id? and user_id?影响行数为 0 就说明越权返回错误。再进一步可以加留言回复message表加parent_id字段自关联展示时按层级拼。改造项改动位置验证方式密码哈希UserDao、Register/LoginServlet注册后查库看是否为哈希值登录能成功登录拦截新增 LoginFilter、web.xml未登录直接访问 board.jsp 被跳回登录页留言分页MessageDao、MessageServlet、board.jsp造 20 条数据每页 10 条翻页正常越权删除MessageServlet 删除分支用 A 账号删 B 账号留言应失败有个习惯我保持了多年每次动老工程之前先把原始版本完整跑通并打一个压缩包备份改完一个模块就跑一次验证清单绝不攒一堆改动一起测。这份登录注册留言板工程不大但它是理解 JavaWeb 请求链路最好的练手材料把它改到“密码哈希 拦截器 分页”这三样齐全你对 Servlet 生命周期、session、过滤器、JDBC 的掌握就到位了。希望帮到你。本文还有配套的精品资源点击获取