JSP 实战学习笔记-10-jsp 动作 actions

野性酷女 2022-12-02 12:20 231阅读 0赞

# JSP 动作元素 #

与JSP指令元素不同的是，JSP动作元素在请求处理阶段起作用。

JSP动作元素是用XML语法写成的。

利用JSP动作可以动态地插入文件、重用JavaBean组件、把用户重定向到另外的页面、为Java插件生成HTML代码。

动作元素只有一种语法，它符合XML标准：

<jsp:action_name attribute="value" />

## 标注动作元素 ##

动作元素基本上都是预定义的函数，JSP规范定义了一系列的标准动作，它用JSP作为前缀，可用的标准动作元素如下：

<table> 
 <thead> 
  <tr> 
   <th align="left">语法</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">jsp:include</td> 
   <td align="left">在页面被请求的时候引入一个文件。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:useBean</td> 
   <td align="left">寻找或者实例化一个JavaBean。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:setProperty</td> 
   <td align="left">设置JavaBean的属性。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:getProperty</td> 
   <td align="left">输出某个JavaBean的属性。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:forward</td> 
   <td align="left">把请求转到一个新的页面。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:plugin</td> 
   <td align="left">根据浏览器类型为Java插件生成OBJECT或EMBED标记。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:element</td> 
   <td align="left">定义动态XML元素</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:attribute</td> 
   <td align="left">设置动态定义的XML元素属性。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:body</td> 
   <td align="left">设置动态定义的XML元素内容。</td> 
  </tr> 
  <tr> 
   <td align="left">jsp:text</td> 
   <td align="left">在JSP页面和文档中使用写入文本的模板</td> 
  </tr> 
 </tbody> 
</table>

## 常见的属性 ##

所有的动作要素都有两个属性：id属性和scope属性。

*  id属性

id属性是动作元素的唯一标识，可以在JSP页面中引用。动作元素创建的id值可以通过PageContext来调用。

*  scope属性

该属性用于识别动作元素的生命周期。

id属性和scope属性有直接关系，scope属性定义了相关联id对象的寿命。

scope属性有四个可能的值： (a) page, (b)request, ©session, 和 (d) application。

# jsp:include 动作元素 #

`<jsp:include>` 动作元素用来包含静态和动态的文件。该动作把指定文件插入正在生成的页面。

语法格式如下：

<jsp:include page="相对 URL 地址" flush="true" />

前面已经介绍过include指令，它是在JSP文件被转换成Servlet的时候引入文件，而这里的 jsp:include 动作不同，插入文件的时间是在页面被请求的时候。

## 属性 ##

以下是include动作相关的属性列表。

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">page</td> 
   <td align="left">包含在页面中的相对URL地址。</td> 
  </tr> 
  <tr> 
   <td align="left">flush</td> 
   <td align="left">布尔属性，定义在包含资源前是否刷新缓存区。</td> 
  </tr> 
 </tbody> 
</table>

## 实例 ##

### 后端 ###

import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    import javax.servlet.http.HttpServletRequest;
    import javax.servlet.http.HttpServletResponse;
    
    @Controller
    @RequestMapping("/actions")
    public class ActionsController { 
    
        @GetMapping("/include")
        public String hello(HttpServletRequest request,
                            HttpServletResponse response) { 
            return "actions/include";
        }
    
    }

### 前端 ###

*  date.jsp

*  include.jsp

<%@page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="utf-8">
        <title>入门案例</title>
    </head>
    <body>
    
    <h2> 动作实例 </h2>
    
    <jsp:include page="date.jsp" flush="true"/>
    
    </body>
    </html>

我们在 include.jsp 中，引入了 date.jsp 页面。

### 页面效果 ###

动作实例
    DATE
    
    当前时间：2020-8-30 12:49:10

# jsp:useBean 动作元素 #

jsp:useBean 动作用来加载一个将在JSP页面中使用的JavaBean。

这个功能非常有用，因为它使得我们可以发挥 Java 组件复用的优势。

## 语法 ##

jsp:useBean动作最简单的语法为：

<jsp:useBean id="name" class="package.class" />

在类载入后，我们既可以通过 jsp:setProperty 和 jsp:getProperty 动作来修改和检索bean的属性。

## 属性 ##

以下是useBean动作相关的属性列表。

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">class</td> 
   <td align="left">指定Bean的完整包名。</td> 
  </tr> 
  <tr> 
   <td align="left">type</td> 
   <td align="left">指定将引用该对象变量的类型。</td> 
  </tr> 
  <tr> 
   <td align="left">beanName</td> 
   <td align="left">通过 java.beans.Beans 的 instantiate() 方法指定Bean的名字。</td> 
  </tr> 
 </tbody> 
</table>

在给出具体实例前，让我们先来看下 jsp:setProperty 和 jsp:getProperty 动作元素：

## jsp:setProperty 动作元素 ##

jsp:setProperty用来设置已经实例化的Bean对象的属性，有两种用法。

首先，你可以在jsp:useBean元素的外面（后面）使用jsp:setProperty，如下所示：

<jsp:useBean id="myName" ... />
    <jsp:setProperty name="myName" property="someProperty" .../>

此时，不管jsp:useBean是找到了一个现有的Bean，还是新创建了一个Bean实例，jsp:setProperty都会执行。

第二种用法是把jsp:setProperty放入jsp:useBean元素的内部，如下所示：

<jsp:useBean id="myName" ... >
     ...
     <jsp:setProperty name="myName" property="someProperty" .../>
    </jsp:useBean>

此时，jsp:setProperty只有在新建Bean实例时才会执行，如果是使用现有实例则不执行jsp:setProperty。

### 属性 ###

jsp:setProperty动作有下面四个属性,如下表：

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">name</td> 
   <td align="left">name属性是必需的。它表示要设置属性的是哪个Bean。</td> 
  </tr> 
  <tr> 
   <td align="left">property</td> 
   <td align="left">property属性是必需的。它表示要设置哪个属性。有一个特殊用法：如果property的值是"*"，表示所有名字和Bean属性名字匹配的请求参数都将被传递给相应的属性set方法。</td> 
  </tr> 
  <tr> 
   <td align="left">value</td> 
   <td align="left">value 属性是可选的。该属性用来指定Bean属性的值。字符串数据会在目标类中通过标准的valueOf方法自动转换成数字、boolean、Boolean、 byte、Byte、char、Character。例如，boolean和Boolean类型的属性值（比如"true"）通过 Boolean.valueOf转换，int和Integer类型的属性值（比如"42"）通过Integer.valueOf转换。 　　value和param不能同时使用，但可以使用其中任意一个。</td> 
  </tr> 
  <tr> 
   <td align="left">param</td> 
   <td align="left">param 是可选的。它指定用哪个请求参数作为Bean属性的值。如果当前请求没有参数，则什么事情也不做，系统不会把null传递给Bean属性的set方法。因此，你可以让Bean自己提供默认属性值，只有当请求参数明确指定了新值时才修改默认属性值。</td> 
  </tr> 
 </tbody> 
</table>

## jsp:getProperty 动作元素 ##

jsp:getProperty动作提取指定Bean属性的值，转换成字符串，然后输出。

### 语法 ###

语法格式如下：

<jsp:useBean id="myName" ... />
    ...
    <jsp:getProperty name="myName" property="someProperty" .../>

### 属性 ###

下表是与getProperty相关联的属性：

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">name</td> 
   <td align="left">要检索的Bean属性名称。Bean必须已定义。</td> 
  </tr> 
  <tr> 
   <td align="left">property</td> 
   <td align="left">表示要提取Bean属性的值</td> 
  </tr> 
 </tbody> 
</table>

## 实例 ##

### 前端 ###

<%@ page import="java.util.Date" %>
    <%@page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="utf-8">
        <title>入门案例</title>
    </head>
    <body>
    <h2>UseBean</h2>
    <br/>
    
    <jsp:useBean id="user" class="com.github.houbb.jsp.learn.hello.model.User"/>
    
    <%--set--%>
    <jsp:setProperty name="user" property="name" value="JSP 设置"/>
    
    设置后的值：
    
    <jsp:getProperty name="user" property="name"/>
    
    </body>
    </html>

### 后端 ###

*  User.java

package com.github.houbb.jsp.learn.hello.model;
    
    public class User { 
    
        private String name;
    
        private String password;
    
    
        //getter & setter & toString()
    
    }

*  mvc

@GetMapping("/useBean")
    public String useBean(HttpServletRequest request,
                        HttpServletResponse response) { 
        return "actions/useBean";
    }

### 测试效果 ###

页面访问：http://localhost:8080/actions/useBean

结果如下：

UseBean
    
    设置后的值： JSP 设置

# jsp:forward 动作元素 #

jsp:forward动作把请求转到另外的页面。

jsp:forward标记只有一个属性page。

## 语法 ##

语法格式如下所示：

<jsp:forward page="相对 URL 地址" />

## 属性 ##

以下是forward相关联的属性：

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">page</td> 
   <td align="left">page属性包含的是一个相对URL。page的值既可以直接给出，也可以在请求的时候动态计算，可以是一个JSP页面或者一个 Java Servlet.</td> 
  </tr> 
 </tbody> 
</table>

## 实例 ##

### 前端实现 ###

*  date.jsp

*  forward.jsp

<body>
    
    <h2>FORWARD 动作实例</h2>
    
    <jsp:forward page="date.jsp"/>
    
    </body>

### 测试效果 ###

当我们访问 forward.jsp 时，实际会跳转到 date.jsp

DATE
    
    当前时间：2020-8-30 13:11:11

# jsp:plugin 动作元素 #

jsp:plugin动作用来根据浏览器的类型，插入通过Java插件运行Java Applet所必需的OBJECT或EMBED元素。

如果需要的插件不存在，它会下载插件，然后执行Java组件。

Java组件可以是一个applet或一个JavaBean。

plugin动作有多个对应HTML元素的属性用于格式化Java 组件。

param元素可用于向Applet 或 Bean 传递参数。

## 实例 ##

以下是使用 plugin 动作元素的典型实例:

<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class"
                               width="60" height="80">
       <jsp:param name="fontcolor" value="red" />
       <jsp:param name="background" value="black" />
     
       <jsp:fallback>
          Unable to initialize Java Plugin
       </jsp:fallback>
     
    </jsp:plugin>

如果你有兴趣可以尝试使用applet来测试jsp:plugin动作元素，`<fallback>` 元素是一个新元素，在组件出现故障的错误时发送给用户错误信息。

ps: 本地测试没有通过，应该是我没有定义 `MyApplet` 类的原因。

# jsp:element jsp:attribute jsp:body 动作元素 #

`<jsp:element> 、 <jsp:attribute>、 <jsp:body>`动作元素动态定义XML元素。

动态是非常重要的，这就意味着XML元素在编译时是动态生成的而非静态。

## 实例 ##

以下实例动态定义了XML元素：

<%@ page language="java" contentType="text/html; charset=UTF-8"
        pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html>
    <head>
    <meta charset="utf-8">
    <title>菜鸟教程(runoob.com)</title>
    </head>
    <body>
    <jsp:element name="xmlElement">
    <jsp:attribute name="xmlElementAttr">
       属性值
    </jsp:attribute>
    <jsp:body>
       XML 元素的主体
    </jsp:body>
    </jsp:element>
    </body>
    </html>

### 效果 ###

实际上的 html 对应的是下面的页面：

<!DOCTYPE html>
    <html>
    <head>
        <meta charset="utf-8">
        <title>菜鸟教程(runoob.com)</title>
    </head>
    <body>
    <xmlElement xmlElementAttr="属性值">
            XML 元素的主体
        </xmlElement>
    </body>
    </html>

# jsp:text 动作元素 #

`<jsp:text>`动作元素允许在JSP页面和文档中使用写入文本的模板

## 语法 ##

语法格式如下：

<jsp:text>模板数据</jsp:text>

以上文本模板不能包含重复元素，只能包含文本和EL表达式（注：EL表达式将在后续章节中介绍）。

请注意，在XML文件中，您不能使用表达式如 `${whatever > 0}`，因为>符号是非法的。

你可以使用 `${whatever gt 0}` 表达式或者嵌入在一个CDATA部分的值。

<jsp:text><![CDATA[<br>]]></jsp:text>

## 实例 ##

如果你需要在 XHTML 中声明 DOCTYPE,必须使用到 `<jsp:text>` 动作元素，实例如下：

<jsp:text><![CDATA[<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "DTD/xhtml1-strict.dtd">]]>
    </jsp:text>
    <head><title>jsp:text action</title></head>
    <body>
    
    <books><book><jsp:text>  
        Welcome to JSP Programming
    </jsp:text></book></books>
    
    </body>
    </html>

### 测试效果 ###

如果使用 text 标签，效果实际如下：

<!DOCTYPE html>
    <html>
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
    
    <head><title>jsp:text action</title></head>
    <body>
    
    <books><book>
        Welcome to JSP Programming
    </book></books>
    
    </body>
    </html>

如果去掉 text 标签：

<!DOCTYPE html>
    <html>
    <![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">]]>
    <head><title>jsp:text action</title></head>
    <body>
    
    <books><book>
        Welcome to JSP Programming
    </book></books>
    
    </body>
    </html>

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3J5bzEwNjA3MzI0OTY_size_16_color_FFFFFF_t_70_pic_center]

# 参考资料 #

https://www.runoob.com/jsp/jsp-actions.html

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3J5bzEwNjA3MzI0OTY_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/5de148a9b8a6474b96af431a3aa4a969.png