异常教程

JSP 动作元素（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言：JSP 动作元素的核心价值

在 Java Web 开发中，JSP（JavaServer Pages）作为动态网页技术的核心，提供了丰富的功能来简化开发流程。JSP 动作元素是 JSP 中一组特殊的标签，它们直接参与页面逻辑的构建，例如包含页面、转发请求、操作 JavaBean 等。对于编程初学者和中级开发者而言，掌握这些动作元素不仅能提升代码的可维护性，还能显著减少重复性工作。

本文将通过循序渐进的方式，结合实际案例和代码示例，深入解析 JSP 动作元素的核心知识点，帮助读者快速上手并灵活运用这些工具。

JSP 动作元素概述：什么是动作元素？

JSP 动作元素是 JSP 规范中定义的预定义标签，它们以 <jsp:*> 的形式存在，用于直接控制页面的动态行为。与 JSP 的表达式语言（EL）或脚本元素不同，动作元素更侧重于流程控制和对象操作。

与指令元素的区别

JSP 共有三类元素：指令元素、脚本元素和动作元素。动作元素与指令元素的区别在于：

  • 指令元素（如 <%@ page %>）主要用于定义页面的全局属性，例如设置编码格式或导入包，但不会直接生成 HTML 输出。
  • 动作元素则在页面渲染时动态执行操作，例如包含其他页面或转发请求，直接影响最终的 HTML 结果。

比喻：如果把 JSP 页面比作一个房间，指令元素就像房间的“装修设计”（如墙壁颜色、门窗位置），而动作元素则是“家具摆放”——它们直接参与内容的生成和流程的控制。

核心动作元素详解

1. <jsp:include>：动态包含页面

功能：将另一个 JSP 文件的内容嵌入到当前页面中，并执行其逻辑代码。

语法

<jsp:include page="relative-path.jsp" />

示例：包含公共头部和尾部

假设我们有两个页面：header.jsp 和 footer.jsp，它们包含网站的导航栏和版权信息。在 index.jsp 中使用 <jsp:include>：

<%@ page contentType="text/html;charset=UTF-8" %>  
<html>  
<head><title>主页</title></head>  
<body>  
    <!-- 动态包含头部 -->  
    <jsp:include page="header.jsp" />  

    <!-- 主页内容 -->  
    <h1>欢迎来到我们的网站！</h1>  

    <!-- 动态包含尾部 -->  
    <jsp:include page="footer.jsp" />  
</body>  
</html>

与 <%@ include %> 的区别

  • <jsp:include> 是动态包含，每次请求都会重新执行被包含页面的代码，适合需要动态数据的场景。
  • <%@ include %> 是静态包含，编译时直接合并代码，性能更高但无法传递请求参数。

2. <jsp:forward>：请求转发

功能：将当前请求转发到另一个资源（如 JSP 或 Servlet），并终止当前页面的执行。

语法

<jsp:forward page="target.jsp" />

示例：登录成功后跳转

在登录验证成功后，将用户重定向到主页：

<%-- 假设用户登录成功 --%>  
<jsp:forward page="home.jsp" />

与 response.sendRedirect() 的区别

  • <jsp:forward> 是服务器端跳转，请求参数会自动传递给目标页面，且 URL 不变。
  • response.sendRedirect() 是客户端跳转，URL 会变化，且需要手动传递参数。

3. <jsp:useBean>：操作 JavaBean

功能：声明并操作 JavaBean 对象，用于封装数据和业务逻辑。

语法

<jsp:useBean id="beanName" class="com.example.BeanClass" scope="page|request|session|application" />  
<jsp:setProperty name="beanName" property="*" />  
<jsp:getProperty name="beanName" property="propertyName" />

示例：处理用户注册表单

假设有一个 User 类：

public class User {  
    private String username;  
    private String email;  
    // 省略 getter 和 setter 方法  
}

在 register.jsp 中使用 <jsp:useBean>：

<jsp:useBean id="user" class="com.example.User" scope="request" />  
<jsp:setProperty name="user" property="*" />  

<!-- 显示用户输入的邮箱 -->  
<p>您的邮箱是：  
    <jsp:getProperty name="user" property="email" />  
</p>

关键点解析

  • property="*" 表示自动匹配表单字段与 JavaBean 属性，前提是名称一致。
  • scope 定义对象的生命周期，例如 session 表示对象在用户会话期间有效。

4. <jsp:param>：传递参数

功能：作为嵌套标签，为 <jsp:include> 或 <jsp:forward> 传递参数。

示例：向包含的页面传递数据

在 index.jsp 中向 header.jsp 传递标题：

<jsp:include page="header.jsp">  
    <jsp:param name="title" value="最新资讯" />  
</jsp:include>

在 header.jsp 中使用参数：

<h1><%= request.getParameter("title") %></h1>

实战案例：构建一个简易论坛

需求描述

构建一个简单的论坛页面，包含以下功能：

  1. 包含公共头部和尾部。
  2. 根据用户登录状态显示不同内容。
  3. 展示帖子列表，数据由 JavaBean 提供。

实现步骤

1. 创建 JavaBean PostList

public class PostList {  
    private List<Post> posts = new ArrayList<>();  
    // 添加模拟数据  
    public PostList() {  
        posts.add(new Post("Java Web 入门教程", "JSP 动作元素详解..."));  
        posts.add(new Post("Spring Boot 实战", "快速构建 REST API..."));  
    }  
    // 省略 getter 方法  
}

2. 编写 forum.jsp

<%@ page contentType="text/html;charset=UTF-8" %>  
<jsp:useBean id="postList" class="com.example.PostList" scope="application" />  

<html>  
<head><title>论坛</title></head>  
<body>  
    <!-- 包含头部 -->  
    <jsp:include page="header.jsp">  
        <jsp:param name="title" value="论坛首页" />  
    </jsp:include>  

    <!-- 根据登录状态显示内容 -->  
    <c:if test="${user.loggedIn}">  
        <h2>欢迎您，<jsp:getProperty name="user" property="username" />！</h2>  
    </c:if>  

    <!-- 展示帖子列表 -->  
    <h3>热门帖子</h3>  
    <ul>  
        <c:forEach items="${postList.posts}" var="post">  
            <li>${post.title} —— ${post.content}</li>  
        </c:forEach>  
    </ul>  
</body>  
</html>

3. 运行效果

  • 未登录时仅显示帖子列表。
  • 登录后显示欢迎信息，并动态加载数据。

注意事项与最佳实践

  1. 避免嵌套过多动作元素：过多的 <jsp:include> 可能导致页面加载缓慢，建议通过 MVC 架构分离逻辑与视图。
  2. 参数传递的类型安全：<jsp:setProperty> 的 property="*" 会自动类型转换，但需确保表单字段与 JavaBean 属性类型一致。
  3. 作用域管理：合理使用 scope 属性，避免对象在不必要的上下文中保留，以减少内存占用。

结论：JSP 动作元素的价值与未来

JSP 动作元素是连接静态 HTML 和动态逻辑的关键桥梁。通过 <jsp:include>、<jsp:forward>、<jsp:useBean> 等标签，开发者可以高效地构建模块化、可维护的 Web 应用。尽管随着技术发展（如 Spring MVC、React），JSP 的使用场景有所减少，但在传统 Java EE 项目中，它仍然是不可或缺的工具。

掌握这些动作元素，不仅能帮助开发者快速上手 JSP 开发，还能为理解更复杂的 Web 架构打下基础。建议读者通过实际项目练习，逐步熟悉动作元素的组合与应用场景，最终实现从理论到实践的无缝衔接。

最新发布

查看更多文章