JSP 动作元素

关键点

• 研究表明，JSP 动作元素是在请求处理阶段起作用的 XML 标签，用于动态插入文件、重用 JavaBean 组件等。
• 看起来，标准动作包括 <jsp:include>、<jsp:useBean> 等，而自定义动作则通过标签库定义。
• 证据显示，所有动作元素都有 id 和 scope 属性，定义生命周期和唯一标识。

概述
JSP 动作元素是 JSP 开发中用于控制 JSP 引擎行为的特殊标签。它们允许动态处理请求，比如包含文件或操作 JavaBean。以下是主要类型和用途的简单介绍。

主要类型

• 标准动作：如 <jsp:include> 用于包含文件，<jsp:useBean> 用于操作 JavaBean。
• 自定义动作：通过标签库定义，扩展功能。

通用属性

• id：动作元素的唯一标识符。
• scope：定义生命周期，可选值为 page、request、session 或 application。

示例
一个简单的例子是使用 <jsp:include> 包含文件：
“`jsp

另一个例子是操作 JavaBean：  

jsp

用户名称：

**参考资料**  
- [菜鸟教程 - JSP 动作元素](https://www.runoob.com/jsp/jsp-actions.html)  
- [W3CCOO - JSP 动作元素](https://www.w3ccoo.com/jsp/jsp_actions.asp)

---

### 详细分析

JavaServer Pages（JSP）是一种服务器端技术，用于创建动态网页，通过在 HTML 中嵌入 Java 代码生成动态内容。JSP 动作元素（“JSP 动作元素”）是 JSP 页面中用于控制 JSP 引擎行为的特殊 XML 标签，它们在请求处理阶段起作用。以下是基于 2025 年 7 月 30 日的最新技术文档和可靠来源的详细分析。

#### 背景与定义  
JSP 由 Sun Microsystems 于 1999 年发布，是一种扩展 Java Servlet 的技术，允许开发者在静态 HTML 中插入动态 Java 代码。动作元素与指令元素不同，指令在翻译阶段生效，而动作元素在客户端请求时动态运行。它们遵循 XML 语法，通常以 `<jsp:` 开头，用于动态插入文件、重用 JavaBean 组件、转发请求等。

#### JSP 动作元素的类型  
研究表明，JSP 动作元素分为两种主要类型：标准动作和自定义动作。

1. **标准动作**  
   标准动作是 JSP 规范预定义的标签，以 `jsp:` 为前缀，用于常见任务。主要的标准动作包括：
   - `<jsp:include>`：在页面请求时包含文件。
   - `<jsp:forward>`：将请求转发到另一个资源。
   - `<jsp:useBean>`：查找或实例化 JavaBean。
   - `<jsp:setProperty>`：设置 JavaBean 属性。
   - `<jsp:getProperty>`：获取并输出 JavaBean 属性。
   - `<jsp:plugin>`：为 Java Applet 或 Bean 生成 HTML 代码。
   - JSP 2.0 引入的动态 XML 生成动作，如 `<jsp:element>`、`<jsp:attribute>`、`<jsp:body>` 和 `<jsp:text>`。

   所有标准动作共享两个通用属性：
   - `id`：动作元素的唯一标识符，可通过 `PageContext` 调用。
   - `scope`：定义生命周期，值包括 `page`、`request`、`session` 和 `application`。

2. **自定义动作**  
   自定义动作是通过标签库定义的用户标签，需要使用 `<%@ taglib %>` 指令声明。例如：

jsp
<%@ taglib prefix=”my” uri=”/WEB-INF/mytags.tld” %>

   它们扩展标准动作功能，支持复杂逻辑，减少代码重复。

#### 标准动作的详细说明  
以下是每个标准动作的详细解释，基于多个来源如菜鸟教程、W3School 和 GeeksforGeeks：

- **`<jsp:include>`**  
  - **功能**：在页面请求时动态包含静态或动态文件，与 `<%@ include %>` 指令（翻译时包含）不同。  
  - **语法**：`<jsp:include page="相对URL" flush="true" />`  
  - **属性**：  
    - `page`：指定要包含的资源的相对 URL。  
    - `flush`：布尔值，定义是否刷新缓冲区，默认为 `true`。  
  - **示例**：  
    ```jsp  
    <jsp:include page="header.jsp" flush="true" />  
    ```
  - **注意**：适合动态包含，如请求时变化的内容。

- **`<jsp:forward>`**  
  - **功能**：将请求转发到另一个资源（如 JSP、HTML 或 Servlet），客户端无感知。  
  - **语法**：`<jsp:forward page="相对URL" />`  
  - **属性**：  
    - `page`：指定相对 URL，可动态生成。  
  - **示例**：  
    ```jsp  
    <jsp:forward page="nextPage.jsp" />  
    ```
  - **注意**：类似 `RequestDispatcher.forward()`，用于请求分发。

- **`<jsp:useBean>`**  
  - **功能**：查找或实例化 JavaBean，方便组件重用。  
  - **语法**：`<jsp:useBean id="beanId" class="package.ClassName" scope="scope" />`  
  - **属性**：  
    - `id`：Bean 的唯一标识符。  
    - `class`：Bean 的完整类名。  
    - `scope`：作用域（page, request, session, application）。  
  - **示例**：  
    ```jsp  
    <jsp:useBean id="user" class="com.example.User" scope="session" />  
    ```
  - **注意**：Bean 类需遵循 JavaBean 规范（getter/setter 方法）。

- **`<jsp:setProperty>`**  
  - **功能**：设置 JavaBean 的属性，可在 `<jsp:useBean>` 内或外使用。  
  - **语法**：`<jsp:setProperty name="beanId" property="propertyName" value="value" />`  
  - **属性**：  
    - `name`：指定 Bean 的 id。  
    - `property`：属性名，可为 "*" 表示设置所有匹配请求参数。  
    - `value`：直接设置的值（可选）。  
    - `param`：使用请求参数作为值（可选）。  
  - **示例**：  
    ```jsp  
    <jsp:setProperty name="user" property="name" value="John" />  
    ```
  - **注意**：适合表单处理，将请求参数映射到 Bean 属性。

- **`<jsp:getProperty>`**  
  - **功能**：获取 JavaBean 属性并输出为字符串。  
  - **语法**：`<jsp:getProperty name="beanId" property="propertyName" />`  
  - **属性**：  
    - `name`：Bean 的 id。  
    - `property`：要获取的属性名。  
  - **示例**：  
    ```jsp  
    <p>用户名称：<jsp:getProperty name="user" property="name" /></p>  
    ```
  - **注意**：自动将属性值转换为字符串输出。

- **`<jsp:plugin>`**  
  - **功能**：根据浏览器类型生成 OBJECT 或 EMBED 标签，用于 Java Applet 或 Bean。  
  - **语法**：  
    ```jsp  
    <jsp:plugin type="applet|bean" code="className" codebase="path" width="width" height="height">  
        <jsp:params>  
            <jsp:param name="paramName" value="paramValue" />  
        </jsp:params>  
        <jsp:fallback>  
            浏览器不支持插件时的替代内容  
        </jsp:fallback>  
    </jsp:plugin>  
    ```
  - **属性**：包括 `type`、`codebase`、`code`、`width`、`height` 等，以及 `<jsp:param>` 用于传递参数。  
  - **示例**：  
    ```jsp  
    <jsp:plugin type="applet" code="MyApplet.class" codebase="/applets">  
        <jsp:params>  
            <jsp:param name="fontcolor" value="red" />  
        </jsp:params>  
        <jsp:fallback>  
            <p>您的浏览器不支持 Java 插件。</p>  
        </jsp:fallback>  
    </jsp:plugin>  
    ```
  - **注意**：因 Applet 使用减少，当前较少使用，但适合遗留系统。

- **JSP 2.0 附加动作**  
  JSP 2.0 引入动态 XML 生成动作：
  - `<jsp:element>`：定义动态 XML 元素，属性 `name` 指定元素名。  
  - `<jsp:attribute>`：设置动态元素的属性，属性 `name` 指定属性名。  
  - `<jsp:body>`：设置动态元素的内容。  
  - `<jsp:text>`：写入模板文本，支持 EL 表达式，适合 XML DOCTYPE 声明。

#### 实践与示例  
以下是一个完整示例，使用多个动作元素：

首先，定义一个 JavaBean：

java
public class User {
private String name;
public String getName() { return name; }
public void setName(String name) { this.name = name; }
}

然后，在 JSP 页面中：

jsp
<%@ page language=”java” contentType=”text/html; charset=UTF-8″ pageEncoding=”UTF-8″ %>

欢迎使用 JSP！

用户名称：
“`

表格：标准动作总结

动作元素	功能	关键属性
<jsp:include>	请求时包含文件	page, flush
<jsp:forward>	将请求转发到另一资源	page
<jsp:useBean>	查找或实例化 JavaBean	id, class, scope
<jsp:setProperty>	设置 Bean 属性	name, property, value/param
<jsp:getProperty>	输出 Bean 属性	name, property
<jsp:plugin>	为 Applet/Bean 生成 HTML	type, codebase, code, width, height

表格：作用域值

作用域值	描述
page	当前页面可见
request	请求生命周期内可见
session	会话范围内可见
application	整个应用程序范围内可见

注意事项

• 与指令的区别：<%@ include %> 在翻译时包含文件，而 <jsp:include> 在请求时动态包含，灵活性更高。
• 性能影响：如 <jsp:include> 每次请求都会执行，可能影响性能，需谨慎使用。
• 现代使用：JSP 动作元素在现代 Web 开发中使用减少，更多转向框架如 Spring MVC，但仍适合遗留系统。

参考资料

• 菜鸟教程 – JSP 动作元素
• W3CCOO – JSP 动作元素
• [GeeksforGeeks – JSP Actions]([invalid url, do not cite])

以上内容基于 2025 年 7 月 30 日的最新技术文档，确保信息的准确性和全面性。