JSP动作

在本章中，我们将讨论JSP中的动作。这些操作使用XML语法中的结构来控制servlet引擎的行为。我们可以动态插入文件，重新使用JavaBeans组件，将用户转发到另一个页面或为Java插件生成HTML。

为了方便示例中的代码运行的结果，我们使用Eclipse创建一个动态Web项目：JspActions 。这个项目的结构如下所示 -

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

<jsp:action_name attribute = "value" />

动作元素基本上是预定义的功能。下表列出了可用的JSP动作 -

编号	动作	描述
1	`jsp:include`	在请求页面时包含一个文件。
2	`jsp:useBean`	查找或实例化一个JavaBean。
3	`jsp:setProperty`	设置JavaBean的属性。
4	`jsp:getProperty`	将JavaBean的属性插入输出。
5	`jsp:forward`	将请求者转发到新页面。
6	`jsp:plugin`	生成针对Java插件创建`OBJECT`或`EMBED`标记的特定于浏览器的代码。
7	`jsp:element`	动态定义XML元素。
8	`jsp:attribute`	定义动态定义的XML元素属性。
9	`jsp:body`	定义动态定义的XML元素的正文。
10	`jsp:text`	用于在JSP页面和文档中编写模板文本。

共同属性

所有动作元素共有两个属性：id属性和scope属性。

id属性

id属性唯一标识动作元素，并允许在JSP页面内引用该操作。如果动作创建了一个对象的实例，则id值可以用于通过隐式对象PageContext引用它。

scope属性

scope属性标识动作元素的生命周期。id属性和scope属性是直接相关的，因为scope属性决定了与id关联的对象的使用寿命。scope属性有四个可能的值：

page
request
session
application

1. jsp:include动作

此动作允许将文件插入到正在生成的页面中。语法如下所示 -

<jsp:include page = "relative URL" flush = "true" />

与在将JSP页面转换为servlet时将文件插入的include指令不同，此动作在请求页面时插入该文件。

下表列出了与include动作相关联的属性 -

编号	属性	描述
1	`page`	要包括的页面的相对URL。
2	`flush`	布尔属性确定包含的资源是否在包含其缓冲区之前被刷新。

示例

下面定义两个文件date.jsp和index.jsp，以下是date.jsp文件的内容 -

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<p>今天是: <%= (new java.util.Date()).toLocaleString()%></p>

以下是index.jsp文件的内容 -

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>include动作示例</title>
</head>
<body>
    <h2>include动作示例</h2>
    <jsp:include page="date.jsp" flush="true" />
</body>
</html>

现在将这些文件保存在根目录下，并尝试访问index.jsp。将会看到以下输出 -

2. jsp:useBean 动作

useBean动作是非常通用的。它首先使用id和scope变量搜索现有对象。如果未找到对象，则会尝试创建指定的对象。

加载bean的最简单的方法如下 -

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

当加载了一个bean类，可以使用jsp:setProperty和jsp:getProperty操作来修改和检索bean属性。

下表列出了与useBean动作关联的属性 -

编号	属性	描述
1	`class`	指定`bean`的完整包名称。
2	`type`	指定将引用对象的变量的类型。
3	`beanName`	给出由`java.beans.Beans`类`instantiate()`方法指定的`bean`的名称。

现在来看看jsp:setProperty和jsp:getProperty动作，然后再给出与这些操作相关的有效示例。

3. jsp:setProperty 动作

setProperty操作设置Bean的属性。在此操作之前，Bean先前已定义。有两种使用setProperty操作的基本方法 -

可以使用jsp:setProperty在之后，但是在jsp:useBean元素之外，如下所示：

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

在这种情况下，执行jsp:setProperty，无论是实例化新bean还是找到现有的bean。

jsp:setProperty可以在jsp:useBean元素的正文内的上下文内出现，如下所示：

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

这里，只有当一个新对象被实例化时，才执行jsp:setProperty，如果找到了一个现有的对象，则不执行。

下表列出了与setProperty动作相关联的属性 -

编号	属性	描述
1	`name`	指定将设置其属性的`bean`。 `Bean`在先前就已经定义了。
2	`property`	表示要设置的属性。值`“*”`表示名称与`bean`属性名称匹配的所有请求参数将被传递给对应的`setter`方法。
3	`value`	要分配给给定属性的值。参数的值为`null`，或者参数不存在，则`setProperty`操作被忽略。
4	`param`	`param`属性是属性要接收的值的请求参数的名称。不能同时使用值和参数，但是不允许使用。

4. jsp:getProperty动作

getProperty操作用于检索给定属性的值并将其转换为字符串，最后将其插入输出。getProperty动作只有两个属性，这两个属性都是必需的。getProperty操作的语法如下：

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

下表列出了与getProperty动作相关联的必需属性 -

编号	动作	描述
1	`name`	要检索的属性的`Bean`名称。前提是`Bean`在先前已经定义了。
2	`property`	`property`属性是要检索的`Bean`属性的名称。

示例

下面定义一个Bean类：Message ，其代码如下-

/* File: Message.java */
package com.zyiz;

public class Message {
   private String message = "No message specified";

   public String getMessage() {
      return(message);
   }
   public void setMessage(String message) {
      this.message = message;
   }
}

在main.jsp文件中编写以下代码。这将加载bean并设置/获取一个简单的String参数 -

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

<head>
<title>在JSP使用JavaBeans示例</title>
</head>

<body>
    <div style="margin:auto;text-align:center;">
        <h2>在JSP使用JavaBeans示例</h2>
        <hr/>
        <jsp:useBean id="msg" class="com.zyiz.Message" />
        <p>获取默认设置的信息是：<jsp:getProperty name="msg" property="message" /></p>

        <jsp:setProperty name="msg" property="message" value="Hello JSP..." />
        <p>获取设置的信息是：<jsp:getProperty name="msg" property="message" /></p>

    </div>
</body>
</html>

现在尝试访问main.jsp，它将显示以下结果 -

5. jsp:forward动作

<jsp:forward>动作终止当前页面的操作，并将请求转发到另一个资源，例如静态页面，另一个JSP页面或Java Servlet。

以下是<jsp:forward>动作的语法 -

<jsp:forward page = "Relative URL" />

下表列出了与<jsp:forward>动作相关联的必需属性 -

编号	动作	描述
1	`page`	应该包含另一个资源的相对URL，例如静态页面，另一个JSP页面或Java Servlet。

示例

创建以下两个文件：date.jsp和main.jsp，分别如下 -

以下是date.jsp文件的内容 -

<p>Today's date: <%= (new java.util.Date()).toLocaleString()%></p>

以下是main.jsp文件的内容 -

现在将这些文件保存在根目录下，并尝试访问main.jsp。这将显示如下所示的结果。

在这里，它从main.jsp丢弃了内容，并显示了来自转发目标页面的内容。

6. jsp:plugin 动作

<jsp:plugin>动作用于将Java组件插入到JSP页面中。它确定浏览器的类型，并根据需要插入<object>或<embed>标签。

如果所需的插件不存在，它会下载插件，然后执行Java组件。Java组件可以是Applet或JavaBean。

<jsp:plugin>动作有几个属性对应于用于格式化Java组件的常用HTML标记。 <param>元素也可用于向Applet或Bean发送参数。

以下是使用<jsp: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>

如果您有兴趣，可以使用一些小程序尝试此操作。新元素<fallback>元素可用于指定要发送给用户的错误字符串，以防组件发生故障。

<jsp:element>，<jsp:attribute>和<jsp:body>动作用于动态定义XML元素。这个词动态是重要的，因为这意味着XML元素可以在请求时生成，而不是在编译时静态生成。

以下是动态定义XML元素的简单示例 -

<%@page language = "java" contentType = "text/html"%>
<html xmlns = "http://www.w3c.org/1999/xhtml"
   xmlns:jsp = "http://java.sun.com/JSP/Page">

   <head><title>Generate XML Element</title></head>

   <body>
      <jsp:element name = "xmlElement">
         <jsp:attribute name = "xmlElementAttr">
            Value for the attribute
         </jsp:attribute>

         <jsp:body>
            Body for XML element
         </jsp:body>

      </jsp:element>
   </body>
</html>

这将在运行时生成以下HTML代码 -

<html xmlns = "http://www.w3c.org/1999/xhtml" xmlns:jsp = "http://java.sun.com/JSP/Page">
   <head><title>Generate XML Element</title></head>

   <body>
      <xmlElement xmlElementAttr = "Value for the attribute">
         Body for XML element
      </xmlElement>
   </body>
</html>

7. jsp:text动作

可以使用<jsp:text>操作将模板文本写入JSP页面和文档。以下是此操作的简单语法 -

<jsp:text>Template data</jsp:text>

模板的主体不能包含其他元素; 它只能包含文本和EL表达式(注 - EL表达式将在后续章节中进行说明)。请注意，在XML文件中不能使用诸如${whatever> 0}的表达式，因为大于符号是非法的。它是使用gt形式来代替，例如${whatever gt 0}或替代方法是将值嵌入到CDATA中。如下示例 -

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

如果需要包括DOCTYPE声明，例如XHTML，还必须使用<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>

尝试以上示例，并使用<jsp:text>操作。