与JSP指令元素不同的是,JSP动作元素在请求处理阶段起作用。JSP动作元素是用XML语法写成的。
利用JSP动作可以动态地插入文件、重用JavaBean组件、把用户重定向到另外的页面、为Java插件生成HTML代码。
动作元素只有一种语法,它符合XML标准:
<jsp:action_name attribute="value" />
AI 代码解读
动作元素基本上都是预定义的函数,JSP规范定义了一系列的标准动作,它用JSP作为前缀,可用的标准动作元素如下:
语法 | 描述 |
---|---|
jsp:include | 在页面被请求的时候引入一个文件 |
jsp:useBean | 寻找或者实例化一个JavaBean |
jsp:setProperty | 设置JavaBean的属性 |
jsp:getProperty | 输出某个JavaBean的属性 |
jsp:forward | 把请求转到一个新的页面 |
jsp:plugin | 根据浏览器类型为Java插件生成OBJECT或EMBED标记 |
jsp:element | 定义动态XML元素 |
jsp:attribute | 设置动态定义的XML元素属性 |
jsp:body | 设置动态定义的XML元素内容 |
jsp:text | 在JSP页面和文档中使用写入文本的模板 |
所有的动作要素都有两个属性:id属性和scope属性。
-
id属性:
id属性是动作元素的唯一标识,可以在JSP页面中引用。动作元素创建的id值可以通过PageContext来调用。
-
scope属性:
该属性用于识别动作元素的生命周期。 id属性和scope属性有直接关系,scope属性定义了相关联id对象的寿命。 scope属性有四个可能的值: page、request、session、application。
<jsp:include>
<jsp:include>动作元素用来包含静态和动态的文件。该动作把指定文件插入正在生成的页面。语法格式如下:
<jsp:include page="relative URL" flush="true" />
AI 代码解读
前面已经介绍过include指令,它是在JSP文件被转换成Servlet的时候引入文件,而这里的jsp:include动作不同,插入文件的时间是在页面被请求的时候。
以下是include动作相关的属性列表。
属性 | 描述 |
---|---|
page | 包含在页面中的相对URL地址 |
flush | 布尔属性,定义在包含资源前是否刷新缓存区 |
使用示例
首先我们编写一个用于包含的页面:datetime.jsp
<%= new java.text.SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new java.util.Date()) %>
AI 代码解读
然后再编写引用datetime.jsp的页面:index.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>index</title>
</head>
<body>
<p>
当前时间为:<jsp:include page="datetime.jsp"/>
</p>
</body>
</html>
AI 代码解读
访问index.jsp,页面会显示类似如下信息:
当前时间为:2016-02-03 13:54:51
<jsp:useBean>
jsp:useBean动作用来装载一个将在JSP页面中使用的JavaBean。
这个功能非常有用,因为它使得我们既可以发挥Java组件重用的优势,同时也避免了损失JSP区别于Servlet的方便性。
jsp:useBean动作最简单的语法为:
<jsp:useBean id="name" class="package.class" />
AI 代码解读
在类载入后,我们可以通过 jsp:setProperty 和 jsp:getProperty 动作来修改和检索bean的属性。
以下是useBean动作相关的属性列表。
属性 | 描述 |
---|---|
class | 指定Bean的完整包名。 |
type | 指定将引用该对象变量的类型。 |
beanName | 通过java.beans.Beans的instantiate()方法指定Bean的名字。 |
<jsp:setProperty>
jsp:setProperty用来设置已经实例化的Bean对象的属性,有两种用法。首先,可以在jsp:useBean元素的后面使用jsp:setProperty,如下所示:
<jsp:useBean id="myName" ... />
...
<jsp:setProperty name="myName" property="someProperty" .../>
AI 代码解读
此时,不管jsp:useBean是找到了一个现有的Bean,还是新创建了一个Bean实例,jsp:setProperty都会执行。第二种用法是把jsp:setProperty放入jsp:useBean元素的内部,如下所示:
<jsp:useBean id="myName" ... >
...
<jsp:setProperty name="myName" property="someProperty" .../>
</jsp:useBean>
AI 代码解读
此时,jsp:setProperty只有在新建Bean实例时才会执行,如果是使用现有实例则不执行jsp:setProperty。
属性 | 描述 |
---|---|
name | name属性是必需的。它表示要设置属性的是哪个Bean。 |
property | property属性是必需的。它表示要设置哪个属性。有一个特殊用法:如果property的值是”*”,表示所有名字和Bean属性名字匹配的请求参数都将被传递给相应的属性set方法。 |
value | value属性是可选的。该属性用来指定Bean属性的值。字符串数据会在目标类中通过标准的valueOf方法自动转换成数字、boolean、Boolean、 byte、Byte、char、Character。例如,boolean和Boolean类型的属性值(比如”true”)通过 Boolean.valueOf转换,int和Integer类型的属性值(比如”42”)通过Integer.valueOf转换。value和param不能同时使用,但可以使用其中任意一个。 |
param | param 是可选的。它指定用哪个请求参数作为Bean属性的值。如果当前请求没有参数,则什么事情也不做,系统不会把null传递给Bean属性的set方法。因此,你可以让Bean自己提供默认属性值,只有当请求参数明确指定了新值时才修改默认属性值。 |
<jsp:getProperty>
jsp:getProperty动作提取指定Bean属性的值,转换成字符串,然后输出。语法格式如下:
<jsp:useBean id="myName" ... />
...
<jsp:getProperty name="myName" property="someProperty" .../>
AI 代码解读
下表是与getProperty相关联的属性:
属性 | 描述 |
---|---|
name | 要检索的Bean属性名称。Bean必须已定义。 |
property | 表示要提取Bean属性的值 |
使用示例
首先我们先来编写一个Bean类
package com.gujin.model;
public class UserInfo
{
private String userId;
private String userName;
public String getUserId()
{
return userId;
}
public void setUserId(String userId)
{
this.userId = userId;
}
public String getUserName()
{
return userName;
}
public void setUserName(String userName)
{
this.userName = userName;
}
}
AI 代码解读
然后再编写jsp页面
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<jsp:useBean id="userInfo" class="com.gujin.model.UserInfo"/>
<jsp:setProperty name="userInfo" property="userId" value="gjjiang"/>
<jsp:setProperty name="userInfo" property="userName" param="userName"/>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>index</title>
</head>
<body>
<p>
编号:<jsp:getProperty property="userId" name="userInfo"/>
<br/>
姓名:<jsp:getProperty property="userName" name="userInfo"/>
</p>
</body>
</html>
AI 代码解读
<jsp:forward>
jsp:forward动作把请求转到另外的页面。jsp:forward标记只有一个属性page。语法格式如下所示:
<jsp:forward page="Relative URL" />
AI 代码解读
以下是forward相关联的属性:
属性 | 描述 |
---|---|
page | page属性包含的是一个相对URL。page的值既可以直接给出,也可以在请求的时候动态计算,可以是一个JSP页面或者一个Servlet |
<jsp:plugin>
jsp:plugin动作用来根据浏览器的类型,插入通过Java插件运行Applet所必需的OBJECT或EMBED元素。
如果需要的插件不存在,它会下载插件,然后执行Java组件。 Java组件可以是一个applet或一个JavaBean。
plugin动作有多个对应HTML元素的属性用于格式化Java 组件。param元素可用于向Applet 或 Bean 传递参数。
<jsp:element> 、<jsp:attribute>、<jsp:body>
<jsp:element>、<jsp:attribute>、<jsp:body>动作元素动态定义XML元素。动态是非常重要的,这就意味着XML元素在编译时是动态生成的而非静态。
<jsp:text>
<jsp:text>动作元素允许在JSP页面和文档中使用写入文本的模板,语法格式如下:
<jsp:text>Template data</jsp:text>
AI 代码解读
以上文本模板不能包含其他元素,只能只能包含文本和EL表达式。