7
0
0

案例 1:手把手教程-简易登录界面

2026-11-09

做一个能登录的 JSP 页面

目标:浏览器输入账号密码 → 后端校验 → 对了进欢迎页,错了原地提示。
环境:JDK 21+、Maven、Tomcat 10.1.61。下面每一步都有"做完怎么验证",不要跳步。

零、先搞清楚要做几样东西

  一个最小的登录功能,一共只有 4 类文件:

login-demo
├── pom.xml                          ① 告诉 Maven:这是 Web 项目,需要哪些 jar
└── src/main
    ├── java/com/iooi/login
    │   ├── User.java                ② 装用户数据的类(用户名、密码、角色)
    │   └── LoginServlet.java        ③ 后端:收参数、校验、跳转
    └── webapp
        ├── login.jsp                ④ 前端:登录表单
        ├── welcome.jsp              ⑤ 登录成功后的页面
        └── WEB-INF/web.xml          ⑥ 容器配置(声明欢迎页)

  分工一句话记住:JSP 只管显示,Servlet 只管判断,配置只管打包。

一、建目录

  照着上面的树建文件夹,注意路径层级不能错,src/main/webapp 是 Maven 的硬约定,写错容器就找不到页面。

mkdir -p login-demo/src/main/java/com/iooi/login
mkdir -p login-demo/src/main/webapp/WEB-INF

  验证:find login-demo -type d 输出里能看到 src/main/java/com/iooi/login 与 src/main/webapp/WEB-INF。

二、写 pom.xml

  这是整个工程最容易被卡住的一步。三条规则:

  • packaging 必须是 war,否则打包出来没人能部署。
  • jakarta.servlet-api 和 jakarta.servlet.jsp-api 必须 provided——容器自带,打进去会冲突。
  • JSTL 必须引两个依赖:一个是 API,一个是实现(org.glassfish.web)。只引 API,页面会报"找不到标签库"。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.iooi</groupId>
    <artifactId>login</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>
    <name>login-demo</name>

    <properties>
        <maven.compiler.release>21</maven.compiler.release>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>jakarta.servlet</groupId>
            <artifactId>jakarta.servlet-api</artifactId>
            <version>6.0.0</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>jakarta.servlet.jsp</groupId>
            <artifactId>jakarta.servlet.jsp-api</artifactId>
            <version>3.1.1</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>jakarta.servlet.jsp.jstl</groupId>
            <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
            <version>3.0.0</version>
        </dependency>
        <dependency>
            <groupId>org.glassfish.web</groupId>
            <artifactId>jakarta.servlet.jsp.jstl</artifactId>
            <version>3.0.1</version>
        </dependency>
    </dependencies>

    <build>
        <finalName>login-demo</finalName>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <release>21</release>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.4.0</version>
            </plugin>
        </plugins>
    </build>
</project>

  <finalName>login-demo</finalName> 决定 WAR 名字,也决定你访问时的路径前缀 /login-demo。不写就会变成 login-1.0-SNAPSHOT.war,路径跟着变。

  验证:

cd login-demo && mvn -q clean package

  产物应出现 target/login-demo.war。

image-20261109101532916

三、写 web.xml

  只做一件事:把 login.jsp 设为默认欢迎页,这样访问应用根路径就是登录页。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                             https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
         version="6.0"
         metadata-complete="false">

    <display-name>login-demo</display-name>

    <welcome-file-list>
        <welcome-file>login.jsp</welcome-file>
    </welcome-file-list>

</web-app>

  metadata-complete="false" 必须留着,它允许容器扫描 @WebServlet 注解,否则第四步的 Servlet 根本不会生效。

四、先只写一个静态 login.jsp

  先不接后端,只写一个纯 HTML 表单,目的是一次只引入一个变量:先确认"页面能显示"。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>简易登录</title>
</head>
<body>
<h2>用户登录</h2>
<form action="${pageContext.request.contextPath}/login" method="post">
    用户名:<input type="text" name="username"><br>
    密 码:<input type="password" name="password"><br>
    <input type="submit" value="登录">
</form>
</body>
</html>

  这里先认识两个东西:

  • <%@ page contentType="text/html;charset=UTF-8" %> 告诉浏览器用 UTF-8 显示,中文才不会变乱码。
  • method="post" 密码走 post 不上地址栏;action 里暂时写死,等接后端时再改。

  验证:部署这一步(见第九节),浏览器能看到表单。此时点登录会 404,因为 /login 还没有人处理,这是正常的。

五、写 User 类

  就三个字段,加上 getter。为什么要 getter?因为 JSP 里 ${user.username} 底层就是调 getUsername(),没有 getter 就取不到值。

package com.iooi.login;

public class User {
    private String username;
    private String password;
    private String role;

    public User(String username, String password, String role) {
        this.username = username;
        this.password = password;
        this.role = role;
    }

    public String getUsername() {
        return username;
    }

    public String getPassword() {
        return password;
    }

    public String getRole() {
        return role;
    }
}

  验证:执行 mvn -q compile,target/classes/com/iooi/login/User.class 出现。

六、写 Login:接手表单

package com.iooi.login;

import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import jakarta.servlet.http.HttpSession;

import java.io.IOException;
import java.util.Arrays;
import java.util.List;

@WebServlet("/login")
public class login extends HttpServlet {
    private static final List<User> USERS = Arrays.asList(
            new User("admin", "123456", "admin"),
            new User("bam", "123456", "user")
    );

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        req.setCharacterEncoding("utf-8");
        // 拿前端表单传过来的数据
        String username = req.getParameter("username");
        String password = req.getParameter("password");

        User matched = null;
        for (User user : USERS) {
            if (user.getUsername().equals(username) && user.getPassword().equals(password)) {
                matched = user;
                break;
            }
        }

        if (matched == null) {
            // 把数据存到对象域里面,供 JSP 页面使用
            req.setAttribute("errMsg", "用户名或密码错误,请重新输入");
            req.setAttribute("username", username);
            // 请求转发
            req.getRequestDispatcher("/login.jsp").forward(req, resp);
            return;
        }

        // 获取当前用户的对象
        HttpSession session = req.getSession();
        session.setAttribute("user", matched);
        session.setAttribute("menus", Arrays.asList("首页", "设置"));
        // 重定向
        resp.sendRedirect(req.getContextPath()+"/welcome.jsp");
    }

}

  四个必须理解的细节:

  1. @WebServlet("/login") 就是给这个类分配地址。表单 post 到 /login,于是走到这里的 doPost。
  2. 为什么只写 doPost 不写 doGet?因为表单是 post。若浏览器直接 GET 访问 /login 会报 405,这也说明你写对了。
  3. 失败用 forward,成功用 sendRedirect。这是全篇最关键的一句:forward 在服务器内部转发,setAttribute 存的数据还能被 JSP 读到;sendRedirect 让浏览器重新发一次请求,之前的 request 数据全部丢失。
  4. request.setCharacterEncoding("UTF-8") 必须在 getParameter 之前,顺序反了中文参数就是乱码。

七、让 login.jsp 显示错误提示(EL + JSTL)

  现在把第四步的页面升级成带提示的版本。核心就三行:

<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<%@ taglib prefix="fn" uri="jakarta.tags.functions" %>

<c:if test="${not empty requestScope.errMsg}">
    <p style="color:red">${requestScope.errMsg}</p>
</c:if>

  完整页面:

<%--
  Created by IntelliJ IDEA.
  User: liaoshangshaorouzong
  Date: 2026/11/9
  Time: 10:18
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="c" uri="jakarta.tags.core" %>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<html>
<head>
	<title>简易登录</title>
</head>
<body>
<h2>用户登录</h2>
<%--
	${}:EL 表达式标记,用来在 JSP 里取值
	pageContext:JSP 内置对象,代表当前页面上下文
	request:请求对象
	contextPath:项目上下文路径(也就是你的 web 应用部署根路径)
	/login:你后端登录接口的访问路径
--%>

<form action="${pageContext.request.contextPath}/login" method="post">
	用户名:<input type="text" name="username" value="${fn:escapeXml(requestScope.username)}">
	<br>
	密&nbsp;&nbsp;&nbsp;码:<input type="password" name="password">
	<br>
	<input type="submit" value="登录">
</form>

<c:if test="${not empty requestScope.errMsg}">
	<p style="color: red">${requestScope.errMsg}</p>
</c:if>

</body>
</html>

  三个 EL 常识:

  • ${xxx} 是 EL 表达式,负责"取值"。
  • ${requestScope.xxx} 明确去 request 域取,避免和 session 里同名属性打架。
  • empty 判断"空不空",因为 EL 取不到值时给的是空字符串而不是 null,用 not empty 最稳。

  为什么要 fn:escapeXml?如果用户在用户名框里输入 <script>,不做转义就会被当成代码执行。凡是把用户输入回显到页面的地方,都套一层。

八、写 welcome.jsp:登录之后去哪

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%--
  Created by IntelliJ IDEA.
  User: liaoshangshaorouzong
  Date: 2026/11/9
  Time: 11:01
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
	<title>欢迎页</title>
</head>
<body>
<c:choose>
	<c:when test="${empty sessionScope.user}">
		<p>您尚未登录,即将返回登录页</p>
		<c:redirect url="login.jsp"/>
	</c:when>
	<c:otherwise>
		<h2>欢迎你,${sessionScope.user.username}</h2>
		<p>当前角色:${sessionScope.user.role}</p>
		<c:choose>
			<c:when test="${sessionScope.user.role == 'admin'}">
				<h3>管理员菜单</h3>
				<ul>
					<li>用户管理</li>
					<li>网站配置</li>
					<li>文章审核</li>
				</ul>
			</c:when>
			<c:otherwise>
				<h3>用户菜单</h3>
				<ul>
					<li>我的文章</li>
					<li>我的主页</li>
					<li>我的收藏</li>
				</ul>
			</c:otherwise>
		</c:choose>
	</c:otherwise>
</c:choose>

</body>
</html>

  这一段把 JSTL 三个主力标签都用上了:

  • c:choose / c:when / c:otherwise:就是 if-else if-else,比堆 c:if 干净。
  • c:forEach:遍历集合。varStatus="st" 给出行号工具:st.count 是序号,st.first 判断是不是第一项。
  • c:redirect:服务端转跳,别人直接访问欢迎页且没登录时,把他踢回登录页。

  为什么 sessionScope.user 能取到?因为第六步里 session.setAttribute("user", matched) 把用户放进了 session,session 跨请求存在,换页面也还在。

九、部署运行

mvn -q clean package
cp target/login-demo.war ~/apache-tomcat-10.1.61/webapps/
~/apache-tomcat-10.1.61/bin/startup.sh

  浏览器打开:

http://localhost:8080/login-demo/login.jsp

  停止 Tomcat:

~/apache-tomcat-10.1.61/bin/shutdown.sh

十、三个必测场景

操作 应该看到
直接访问 welcome.jsp 提示未登录,自动跳回登录页
输 admin123 / x 提交 红字"用户名或密码错误",用户名仍留在输入框
输 admin / 123456 提交 跳到欢迎页,显示"管理菜单"和 4 个菜单项
输 iooi / 123456 提交 跳到欢迎页,显示"普通用户菜单"
用户名输 <script>alert(1)</script> 页面上原样显示这串文字,不弹窗

  任何一条不符,先看 ~/apache-tomcat-10.1.61/logs/catalina.out。

十一、报错对照表

现象 原因 修法
打不开页面,404 WAR 没部署上,或路径少了 /login-demo 看 webapps/ 有没有 login-demo.war,重启 Tomcat
点登录 404 Servlet 没生效 检查类在 src/main/java/com/iooi/login 下,且有 @WebServlet("/login")
点登录 405 用浏览器直接访问 /login 了 正常现象,必须走表单 post
报 绝对 uri: jakarta.tags.core 无法找到 JSTL 只引了 API 或没打进 WAR 确认两个 JSTL 依赖都没写 provided,WEB-INF/lib 里有两个 jstl jar
页面显示 ${...} 原文 没加 <%@ taglib %> 或写成了旧 java.sun.com 地址 改成 jakarta.tags.core 等三个新地址
中文乱码 编码设置顺序错,或页面没声明 UTF-8 setCharacterEncoding 放在 getParameter 之前
错误提示永远不显示 失败分支用了 sendRedirect 改回 forward

十二、做完之后可以继续加什么

  • 加"退出登录":新建 LogoutServlet,session.invalidate() 后重定向回登录页。
  • 把 USERS 换成数据库查询,Service + DAO 分层,JSP 一行都不用改。
  • 加验证码、加"记住我"cookie、把密码改成散列存储。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

案例 1:手把手教程-简易登录界面
/archives/post-1794196486199
作者
Bam
发布于
2026-11-09
许可协议
CC BY-NC-SA 4.0

评论