JSP 13个内置标签

A、<jsp:param >

操作被用来以“名-值”对的形式为其他标签提供附加信息。它和<jsp:include>、<jsp:forward>、<jsp:plugin>一起使用。向一个动态文件发送一个或多个参数，这个文件一定是动态文件。如果你想传递多个参数，你可以在一个JSP文件中使用多个<jsp:param>。

语法

<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />

属性

name="parameterName"

name指定参数名

value="{parameterValue | <%= expression %>}"

value指定参数值。

范例

<jsp:paramname="abc"value="123"/>

B、<jsp:include>

<jsp:include>元素允许你包含动态文件和静态，这两种包含文件的结果是不同的。如果文件仅是静态文件，那么这种包含仅仅是把包含文件的内容加到jsp文件中去，而如果这个文件动态的，那么这个被包含文件也会先被Jsp编译器执行后再加入到调用的jsp中。

语法

<jsp:include page="{relativeURL | <%= expression%>}" flush="true" />

或

<jsp:include page="{relativeURL | <%= expression %>}" flush="true" >

<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+

</jsp:include>

属性

page="{relativeURL | <%= expression %>}"

参数为一相对路径，或者是代表相对路径的表达式。

flush="true"

这里你必须使用flush="true",你不能使用false值.缺省值为false。

范例

<jsp:includepage="1.jsp"flush="true">

  <jsp:paramname="abc"value="123"/>

</jsp:include>

B.1、include与jsp:include区别

jsp中include有两种形式,分别是

　　<%@ include file=””%>

　　<jsp:include page=”” flush=”true”/>

前者是指令元素、后者是行为元素。通常当应用程序中所有的页面的某些部分（例如标题、页脚和导航栏）都相同的时候，就可以考虑用<%@ include file=%>。jsp的include指令元素读入指定页面的内容。并把这些内容和原来的页面融合到一起。(这个过程是在翻译阶段，也就是jsp被转化成servlet的阶段进行的。)

include与jsp:include主要有两个方面的不同;

　　一:执行时间上:

　　<%@ include file=%> 是在翻译阶段执行

　　<jsp:include page= flush=true />在请求处理阶段执行.

　　二:引入内容的不同:

　　<%@ include file=%>

　　引入静态文本(html,jsp),在JSP页面被转化成servlet之前和它融和到一起.

<jsp:include page= flush= />引入执行页面或servlet所生成的应答文本.

另外在两种用法中file和page属性都被解释为一个相对的URI.如果它以斜杠开头,那么它就是一个环境相关的路径.将根据赋给应用程序的URI的前缀进行解释,如果它不是以斜杠开头,那么就是页面相关的路径,就根据引入这个文件的页面所在的路径进行解释

C、<jsp:forward>

重定向一个HTML文件，JSP文件，或者是一个程序段。

<jsp:forward>标签从一个JSP文件向另一个文件传递一个包含用户请求的request对象。<jsp:forward>标签下面的代码，将不能执行。

　　如果你使用了<jsp:param>标签的话，你能够向目标文件传送参数和值，目标文件必须是一个动态的文件，能够处理参数.

　　如果你使用了非缓冲输出的话，那么使用<jsp:forward>时就要小心。如果在你使用<jsp:forward>之前，jsp文件已经有了数据，那么文件执行就会出错.

语法

<jsp:forward page={"relativeURL" | "<%= expression %>"} />

或

<jsp:forward page={"relativeURL" | "<%= expression %>"} >

<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+

</jsp:forward>

属性

page="{relativeURL | <%= expression %>}"

这里是一个表达式或是一个字符串用于说明你将要定向的文件或URL。这个文件可以是JSP程序段或者其它能够处理request对象的文件(如asp,cgi,php)。

范例

<jsp:forwardpage="">

  <jsp:paramname="abc"value="123"/>

</jsp:forward>

　　

D、<jsp:useBean>

<jsp:useBean> 指的是创建一个Bean实例并指定它的名字和作用范围。

<jsp:useBean>用于定位或示例一个JavaBeans组件。<jsp:useBean>首先会试图定位一个Bean实例，如果这个Bean不存在，那么<jsp:useBean>就会从一个class中进行实例化。

为了定位或示例一个Bean，<jsp:useBean>会进行以下步聚，顺序如下：

　　1、通过给定名字和范围试图定位一个Bean。

2、对这个Bean对象引用变量以你指定的名字命名。

3、如果发现了这个Bean，将会在这个变量中引用这个bean。如果你指定了类型，那么这个Bean也设置为相应的类型。

4、如果没有发现这个Bean，将会从你指定的class中实例化，并将此引用到一个新的变量中去。如果这个class的名字代表的是一个模版，那么这个Bean被java.beans.Beans.instantiate实例化。

5、如果<jsp:useBean>已经实例化（不是定位）Bean，同时<jsp:useBean>和</jsp:useBean>中有元素，那么将会执行其中的代码.

<jsp:useBean>元素的主体通常包含有<jsp:setProperty>元素，用于设置Bean的属性值。正如上面第五步所说的，<jsp:useBean>的主体仅仅只有在<jsp:useBean>实例化Bean时才会被执行，如果这个Bean已经存在，<jsp:useBean>能够定位它，那么主体中的属性将不会起作用。

语法

<jsp:useBean

　　id="beanInstanceName"

　　scope="page | request | session | application"

　　{

　　class="package.class" |

　　type="package.class" |

　　class="package.class" type="package.class" |

　　beanName="{package.class | <%= expression %>}" type="package.class"

　　}

{

/> |

other elements

</jsp:useBean>

}

属性

id="beanInstanceName"

在你所定义的范围中确认Bean的变量，你能在后面的程序中使用此变量名来分辨不同的Bean。这个变量名对大小写敏感，必须符合你所使用的脚本语言的规定，在Java Programming Language中，这个规定在Java Language规范已经写明。如果这个Bean已经在别的<jsp:useBean>中创建，那么这个id的值必须与原来的那个id值一致。

scope="page | request | session | application"

Bean存在的范围以及id变量名的有效范围。缺省值是page，

以下是详细说明：

　　        page

你能在包含<jsp:useBean>元素的JSP文件以及此文件中的所有静态包含文件中使用Bean,直到页面执行完毕向客户端发回响应或转到另一个文件为止。

request

你在任何执行相同请求的jsp文件中使用Bean，直到页面执行完毕向客户端发回响应或转到另一个文件为止。你能够使用Request对象访问Bean，比如request.getAttribute(beanInstanceName)

session

从创建Bean开始，你就能在任何使用相同session的Jsp文件中使用Bean。这个Bean存在于整个Session生存周期内，任何在分享此Session的jsp文件都能使用同一Bean。注意在你创建Bean的jsp文件中<% @ page %>指令中必须指定session=true。

application

从创建Bean开始，你就能在任何使用相同application的jsp文件中使用Bean。这个Bean存在于整个application生存周期内，任何在分享此application的jsp文件都能使用同一Bean。

class="package.class"

使用new关键字以及class构造器从一个class中实例化一个bean。这个class不能是抽象的，必须有一个公用的，没有参数的构造器。这个package的名字区别大小写。

type="package.class"

如果这个Bean已经在指定的范围中存在。如果你没有使用class或beanName指定type，Bean将不会被实例化为package.class的名字，区分大小写。

beanName="{package.class | <%= expression %>}" type="package.class"

使用java.beans.Beans.instantiate方法来从一个class或连续模版中实例化一个Bean，同时指定Bean的类型。beanName可以是package.class也可以是表达式，它的值会传给Beans.instantiate.tupe的值可以和Bean相同。

范例

<jsp:useBeanid="checking"scope="session"class="bank.Checking">

  <jsp:setPropertyname="checking"property="balance"value="0.0"/>

</jsp:useBean>

E、<jsp:setProperty>

<jsp:setProperty>通过Bean给定的setter方法给bean实例赋值，在Bean中设置一个或多个属性值。你在使用这个元素之前必须得使用<jsp:useBean>声明此Bean。因为<jsp:useBean>和<jsp:setProperty>是联系在一起使用的，同时他们使用的Bean实例的名字也应当相匹配（就是说，在<jsp:setProperty>中的name的值应当和<jsp:useBean>中id的值相同)。

你能使用多种方法利用<jsp:setProperty>来设定属性值：

1、通过用户输入的值(被做为参数储存中request对象中)来匹配Bean中的属性。

2、通过用户输入的值来匹配Bean中指定的属性。

3、在运行时使用一个表达式来匹配Bean的属性。

语法

<jsp:setProperty

　　name="beanInstanceName"

　　{

　　property= "*" |

　　property="propertyName" [ param="parameterName" ] |

　　property="propertyName" value="{string | <%= expression %>}"

　　}

/>

属性

name="beanInstanceName"

表示已经在<jsp:useBean>中创建的Bean实例的名字。

property="*"

储存在用户在jsp输入（request）的所有值，用于匹配Bean中的属性。在Bean中的属性的名字必须和request对象中的参数名一致。从客户端传到服器上的参数值一般都是字符类型，这些字符串为了能够在Bean中匹配就必须转换成其它的类型，下面的表中列出了Bean属性的类型以及他们的转换方法。

boolean or Boolean

java.lang.Boolean.valueOf(String)

byte or Byte

java.lang.Byte.valueOf(String)

char or Character

java.lang.Character.valueOf(String)

double or Double

java.lang.Double.valueOf(String)

integer or Integer

java.lang.Integer.valueOf(String)

float or Float

java.lang.Float.valueOf(String)

long or Long

java.lang.Long.valueOf(String)

如果request对象的参数值中有空值，那么对应的Bean属性将不会设定任何值。同样的，如果Bean中有一个属性没有与之对应的Request参数值，那么这个属性同样也不会设定。

如果你使用了property="*",那么Bean的属性没有必要按Html表单中的顺序排序。

property="propertyName" [ param="parameterName" ]

使用request中的一个参数值来指定Bean中的一个属性值。在这个语法中，property指定Bean的属性名，param指定request中的参数名。如果bean属性和request参数的名字不同，那么你就必须得指定property和param，如果他们同名，那么你就只需要指明property就行了。如查参数值为空（或未初始化)，对应的Bean属性不被设定。

property="propertyName" value="{string | <%= expression %>}"

使用指定的值来设定Bean属性。这个值可以是字符串，也可以是表达式。如果这个字符串，那么它就会被转换成Bean属性的类型（查看上面的表)。如果它是一个表达式，那么它类型就必须和它将要设定的属性值的类型一致。如果参数值为空，那么对应的属性值也不会被设定。另外，你不能在一个<jsp:setProperty>中同时使用param和value。

范例

<jsp:setPropertyname="mybean"property="*"/>

  <jsp:setPropertyname="mybean"property="username"/>

   <jsp:setPropertyname="mybean"property="username"value="Steve"/>　　

　　

F、<jsp:getProperty>

获取Bean的属性值，用于显示在页面中。<jsp:getProperty>将获得Bean的属性值，并可以使用或显示在JSP页面中。在你使用<jsp:getProperty>之前，你必须用<jsp:useBean>创建它。

<jsp:getProperty>元素有一些限制：

　　你不能使用<jsp:getProperty>来检索一个已经被索引了的属性。

你能够和JavaBeans组件一起使用<jsp:getProperty>，但是不能与Enterprise Bean一起使用。

JSP参考中提到，如果你使用<jsp:getProperty>来检索的值是空值，那么NullPointerException将会出现，同时如果使用程序段或表达式来检索其值，那么在浏览器上出现的是null。

语法

<jsp:getProperty name="beanInstanceName" property="propertyName" />

属性

name="beanInstanceName"

　　bean的名字,由<jsp:useBean>指定。

property="propertyName"

　　所指定的Bean的属性名。

范例

<jsp:getPropertyproperty=""name=""/>

G、<jsp:plugin> <jsp:params> <jsp:fallback>

执行一个applet或Bean,有可能的话还要下载一个Java插件用于执行它。<jsp:plugin>元素用于在浏览器中播放或显示一个对象（典型的就是applet和Bean)，而这种显示需要在浏览器的java插件。当Jsp文件被编译，送往浏览器时，<jsp:plugin>元素将会根据浏览器的版本替换成<object>或者<embed>元素。注意，<object>用于HTML 4.0 ，<embed>用于HTML 3.2。　一般来说，<jsp:plugin>元素会指定对象是Applet还是Bean，同样也会指定class的名字，还有位置，另外还会指定将从哪里下载这个Java插件。

语法

<jsp:plugin

　　type="bean | applet"

　　code="classFileName"

　　codebase="classFileDirectoryName"

　　[ name="instanceName" ]

　　[ archive="URIToArchive, ..." ]

　　[ align="bottom | top | middle | left | right" ]

　　[ height="displayPixels" ]

　　[ width="displayPixels" ]

　　[ hspace="leftRightPixels" ]

　　[ vspace="topBottomPixels" ]

　　[ jreversion="JREVersionNumber | 1.1" ]

　　[ nspluginurl="URLToPlugin" ]

　　[ iepluginurl="URLToPlugin" ] >

　　[ <jsp:params>

[ <jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" /> ]+

　　</jsp:params> ]

　　[ <jsp:fallback> text message for user </jsp:fallback> ]

</jsp:plugin>

属性

type="bean | applet"

将被执行的插件对象的类型，你必须得指定这个是Bean还是applet，因为这个属性没有缺省值。

code="classFileName"

将会被Java插件执行的Java Class的名字，必须以.class结尾。这个文件必须存在于codebase属性指定的目录中。

codebase="classFileDirectoryName"

将会被执行的Java Class文件的目录（或者是路径)，如果你没有提供此属性，那么使用<jsp:plugin>的jsp文件的目录将会被使用。

name="instanceName"

这个Bean或applet实例的名字，它将会在Jsp其它的地方调用.

archive="URIToArchive, ..."

一些由逗号分开的路径名，这些路径名用于预装一些将要使用的class,这会提高applet的性能。

align="bottom | top | middle | left | right"

图形，对象，Applet的位置。

height="displayPixels" width="displayPixels"

Applet或Bean将要显示的长宽的值，此值为数字，单位为象素.

hspace="leftRightPixels" vspace="topBottomPixels"

Applet或Bean显示时在屏幕左右，上下所需留下的空间，单位为象素.

jreversion="JREVersionNumber | 1.1"

Applet或Bean运行所需的Java Runtime Environment (JRE)的版本. 缺省值是 1.1.

nspluginurl="URLToPlugin"

Netscape Navigator用户能够使用的JRE的下载地址，此值为一个标准的URL，如http://www.aspcn.com/jspiepluginurl="URLToPlugin"IE用户能够使用的JRE的下载地址，此值为一个标准的URL，如http://www.aspcn.com/jsp

<jsp:params>

[ <jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" /> ]+ </jsp:params>

你需要向applet或Bean传送的参数或参数值。

<jsp:fallback> unable to start plugin </jsp:fallback>

一段文字用于：当不能启动Applet或Bean 时，那么浏览器会有一段错误信息。

范例

<jsp:plugintype=appletcode="Molecule.class"codebase="/html">

  <jsp:params>

     <jsp:paramname="molecule"value="molecules/benzene.mol"/>

  </jsp:params>

  <jsp:fallback>

　　<p>Unable to load applet</p>

　　</jsp:fallback>

</jsp:plugin>

　　

G、<jsp:body>

H、<jsp:element>

I、<jsp:attribute>

J、<jsp:output>