Jsp语法

 

1. 1. 隐藏注释 <%-- comment --%> 
2. 2. 显示注释 <!-- comment [ <%= expression %> ] --> 
3. 3. 在JSP程序中声明合法的变量和方法        <%! declaration; [ declaration; ]+ ... %>
4. 4. 包含一个符合JSP语法的表达式      <%= expression %> 
5. 5. Page 指令 定义JSP文件中的全局属性.
6.     JSP 语法
7.         <%@ page 
8.         [ language="java" ] 
9.         [ extends="package.class" ] 
10.         [ import="{package.class | package.*}, ..." ] 
11.         [ session="true | false" ] 
12.         [ buffer="none | 8kb | sizekb" ] 
13.         [ autoFlush="true | false" ] 
14.         [ isThreadSafe="true | false" ] 
15.         [ info="text" ] 
16.         [ errorPage="relativeURL" ] 
17.         [ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ] 
18.         [ isErrorPage="true | false" ] 
19.         %> 
20.     例子
21.         <%@ page import="java.util.*, java.lang.*" %> 
22.         <%@ page buffer="5kb" autoFlush="false" %> 
23.         <%@ page errorPage="error.jsp" %> 
24.     描述
25.         <%@ page %>指令作用于整个JSP页面，同样包括静态的包含文件。
26.         但是<% @ page %>指令不能作用于动态的包含文件，比如 <jsp:include> 
28.         你可以在一个页面中用上多个<% @ page %>指令，但是其中的属性只能用一次，不过也有个例外，
29.         那就是import属性。因为import属性和Java中的import语句差不多(参照Java Language)，所以你就能多用此属性几次了. 
31.         无论你把<% @ page %>指令放在JSP的文件的哪个地方，它的作用范围都是整个JSP页面。
32.         不过，为了JSP程序的可读性，以及好的编程习惯，最好还是把它放在JSP文件的顶部. 
33. 6. Taglib 指令        <%@ taglib uri="URIToTagLibrary" prefix="tagPrefix" %> 
35.         定义一个标签库以及其自定义标签的前缀. 
36.     例子
38.         <%@ taglib uri="http://www.jspcentral.com/tags" prefix="public" %> 
39.         <public:loop> 
40.         . 
41.         . 
42.         </public:loop> 
44.     描述
46.         <% @ taglib %>指令声明此JSP文件使用了自定义的标签，同时引用标签库，也指定了他们的标签的前缀。 
48.         这里自定义的标签含有标签和元素之分。因为JSP文件能够转化为XML,所以了解标签和元素之间的联系很重要。标签只不过是一个在意义上被抬高了点的标记，是JSP元素的一部分。
49.         JSP元素是JSP语法的一部分，和XML一样有开始标记和结束标记。元素也可以包含其它的文本，标记，元素。比如，
50.         一个jsp:plugin元素有<jsp:plugin>开始标记和</jsp:plugin>结束标记，同样也可以有<jsp:params>和<jsp:fallback>元素. 
52.         你必须在使用自定义标签之前使用<% @ taglib %>指令，而且你可以在一个页面中多次使用，但是前缀只能使用一次 
54.     属性
56.         uri="URIToTagLibrary" 
57.         Uniform Resource Identifier (URI)根据标签的前缀对自定义的标签进行唯一的命名，URI可以是以下的内容: 
59.         Uniform Resource Locator (URL), 由 RFC 2396 定义, 查看 http://www.hut.fi/u/jkorpela/rfc/2396/full.html 
60.         　 
61.         Uniform Resource Name (URN), 由 RFC 2396定义
62.         　 
63.         一个相对或绝对的路径 
64.         prefix="tagPrefix"
65.         在自定义标签之前的前缀，比如，在<public:loop>中的public，如果这里不写public，那么这就是不合法的。
66.         请不要用jsp, jspx, java, javax, servlet, sun, 和sunw做为你的前缀
67. 7. <jsp:forward> 重定向一个HTML文件，JSP文件，或者是一个程序段.
68.     JSP 语法
70.             <jsp:forward page={"relativeURL" | "<%= expression %>"} /> 
72.             or 
74.             <jsp:forward page={"relativeURL" | "<%= expression %>"} > 
76.             <jsp:param name="parameterName" 
78.             value="{parameterValue | <%= expression %>}" />+ 
80.             </jsp:forward> 
82.     例子
84.             <jsp:forward page="/servlet/login" /> 
86.             <jsp:forward page="/servlet/login"> 
88.             <jsp:param name="username" value="jsmith" /> 
90.             </jsp:forward> 
92.     描述
94.             <jsp:forward>标签从一个JSP文件向另一个文件传递一个包含用户请求的request对象.<jsp:forward>标签以下的代码，将不能执行. 
96.             你能够向目标文件传送参数和值，在这个例子中我们传递的参数名为username,值为scott,如果你使用了<jsp:param>标签的话，目标文件必须是一个动态的文件，能够处理参数. 
98.             如果你使用了非缓冲输出的话，那么使用<jsp:forward>时就要小心。如果在你使用<jsp:forward>之前，jsp文件已经有了数据，那么文件执行就会出错. 
100.     属性
102.             page="{relativeURL | <%= expression %>}" 
103.             这里是一个表达式或是一个字符串用于说明你将要定向的文件或URL.这个文件可以是JSP,程序段，或者其它能够处理request对象的文件(如asp,cgi,php). 
105.             <jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+ 
106.             向一个动态文件发送一个或多个参数，这个文件一定是动态文件. 
108.             如果你想传递多个参数，你可以在一个JSP文件中使用多个<jsp:param>。name指定参数名，value指定参数值.
109. 8. <jsp:getProperty> 获取Bean的属性值，用于显示在页面中 
110.     JSP 语法
112.             <jsp:getProperty name="beanInstanceName" property="propertyName" /> 
114.     例子
116.             <jsp:useBean id="calendar" scope="page" class="employee.Calendar" /> 
118.             <h2> 
120.             Calendar of <jsp:getProperty name="calendar" property="username" /> 
122.             </h2> 
124.     描述
126.             这个<jsp:getProperty>元素将获得Bean的属性值，并可以将其使用或显示在JSP页面中.在你使用<jsp:getProperty>之前，你必须用<jsp:useBean>创建它. 
128.             <jsp:getProperty>元素有一些限制: 
130.             你不能使用<jsp:getProperty>来检索一个已经被索引了的属性 
132.             你能够和JavaBeans组件一起使用<jsp:getProperty>,但是不能与Enterprise 
134.             Bean一起使用。 
136.     属性
138.             name="beanInstanceName" 
139.             bean的名字,由<jsp:useBean>指定 
141.             property="propertyName" 
142.             所指定的Bean的属性名。 
144.     技巧:
146.             在sun的JSP参考中提到，如果你使用<jsp:getProperty>来检索的值是空值，那么NullPointerException将会出现，同时如果使用程序段或表达式来检索其值，那么在浏览器上出现的是null（空). 
147. 9. <jsp:include> 包含一个静态或动态文件.
148.     JSP 语法
150.             <jsp:include page="{relativeURL | <%= expression%>}" flush="true" /> 
152.             or 
154.             <jsp:include page="{relativeURL | <%= expression %>}" flush="true" > 
156.             <jsp:param name="parameterName" 
158.             value="{parameterValue | <%= expression %>}" />+ 
160.             </jsp:include> 
162.     Examples
164.             <jsp:include page="scripts/login.jsp" /> 
166.             <jsp:include page="copyright.html" /> 
168.             <jsp:include page="/index.html" /> 
170.             <jsp:include page="scripts/login.jsp"> 
172.             <jsp:param name="username" value="jsmith" /> 
174.             </jsp:include> 
176.     描述
178.             <jsp:include>元素允许你包含动态文件和静态，这两种包含文件的结果是不同的。如果文件仅是静态文件，那么这种包含仅仅是把包含文件的内容加到jsp文件中去，而如果这个文件动态的，那么这个被包含文件也会被Jsp编译器执行(这一切与asp相似) 
180.             你不能从文件名上判断一个文件是动态的还是静态的，比如aspcn.asp 
182.             就有可能只是包含一些信息而已，而不需要执行。<jsp:include>能够同时处理这两种文件，因此你就不需要包含时还要判断此文件是动态的还是静态的. 
184.             如果这个包含文件是动态的，那么你还可以用<jsp:param>还传递参数名和参数值。 
186.     属性
188.             page="{relativeURL | <%= expression %>}" 
189.             参数为一相对路径，或者是代表相对路径的表达式. 
191.             flush="true" 
192.             这里你必须使用flush="true",你不能使用false值.缺省值为false 
194.             <jsp:param name="parameterName" value="{parameterValue | <%= expression %> }" />+ 
195.             <jsp:param>子句能让你传递一个或多个参数给动态文件 
197.             你能在一个页面中使用多个<jsp:param>来传递多个参数。
198. 10. <jsp:plugin> 执行一个applet或Bean,有可能的话还要下载一个Java插件用于执行它. 
199.     JSP 语法
200.             <jsp:plugin 
202.             type="bean | applet" 
204.             code="classFileName" 
206.             codebase="classFileDirectoryName" 
208.             [ name="instanceName" ] 
210.             [ archive="URIToArchive, ..." ] 
212.             [ align="bottom | top | middle | left | right" ] 
214.             [ height="displayPixels" ] 
216.             [ width="displayPixels" ] 
218.             [ hspace="leftRightPixels" ] 
220.             [ vspace="topBottomPixels" ] 
222.             [ jreversion="JREVersionNumber | 1.1" ] 
224.             [ nspluginurl="URLToPlugin" ] 
226.             [ iepluginurl="URLToPlugin" ] > 
228.             [ <jsp:params> 
230.             [ <jsp:param name="parameterName" 
232.             value="{parameterValue | <%= expression %>}" /> ]+ 
234.             </jsp:params> ] 
236.             [ <jsp:fallback> text message for user </jsp:fallback> ] 
238.             </jsp:plugin> 
240.     例子
242.             <jsp:plugin type=applet code="Molecule.class" codebase="/html"> 
244.             <jsp:params> 
246.             <jsp:param name="molecule" value="molecules/benzene.mol" /> 
248.             </jsp:params> 
250.             <jsp:fallback> 
252.             <p>Unable to load applet</p> 
254.             </jsp:fallback> 
256.             </jsp:plugin> 
258.     描述
260.             <jsp:plugin>元素用于在浏览器中播放或显示一个对象（典型的就是applet和Bean),而这种显示需要在浏览器的java插件。 
262.             当Jsp文件被编译，送往浏览器时，<jsp:plugin>元素将会根据浏览器的版本替换成<object>或者<embed>元素。注意，<object>用于HTML 4.0 ，<embed>用于HTML 3.2. 
264.             一般来说，<jsp:plugin>元素会指定对象是Applet还是Bean,同样也会指定class的名字，还有位置，另外还会指定将从哪里下载这个Java插件。具体如下: 
266.     属性
268.             type="bean | applet" 
269.             .将被执行的插件对象的类型，你必须得指定这个是Bean还是applet,因为这个属性没有缺省值. 
271.             code="classFileName" 
272.             将会被Java插件执行的Java Class的名字，必须以.class结尾。这个文件必须存在于codebase属性指定的目录中. 
274.             codebase="classFileDirectoryName" 
275.             将会被执行的Java Class文件的目录（或者是路径)，如果你没有提供此属性，那么使用<jsp:plugin>的jsp文件的目录将会被使用. 
277.             name="instanceName" 
278.             这个Bean或applet实例的名字，它将会在Jsp其它的地方调用. 
280.             archive="URIToArchive, ..." 
281.             一些由逗号分开的路径名，这些路径名用于预装一些将要使用的class,这会提高applet的性能. 
283.             align="bottom | top | middle | left | right" 
284.             图形，对象，Applet的位置,有以下值: 
286.             bottom 
287.             top 
288.             middle 
289.             left 
290.             right 
291.             height="displayPixels" width="displayPixels" 
292.             Applet或Bean将要显示的长宽的值，此值为数字，单位为象素. 
294.             hspace="leftRightPixels" vspace="topBottomPixels" 
295.             Applet或Bean显示时在屏幕左右，上下所需留下的空间，单位为象素. 
297.             jreversion="JREVersionNumber | 1.1" 
299.             Applet或Bean运行所需的Java Runtime Environment (JRE) 的版本. 
301.             缺省值是 1.1. 
303.             nspluginurl="URLToPlugin" 
305.             Netscape Navigator用户能够使用的JRE的下载地址，此值为一个标准的URL，如http://www.aspcn.com/jsp 
307.             iepluginurl="URLToPlugin" 
308.             IE用户能够使用的JRE的下载地址，此值为一个标准的URL，如http://www.aspcn.com/jsp 
310.             <jsp:params> [ <jsp:param name="parameterName" 
311.             value="{parameterValue | <%= expression %>}" /> ]+ </jsp:params> 
313.             你需要向applet或Bean传送的参数或参数值。 
315.             <jsp:fallback> text message for user </jsp:fallback> 
316.             一段文字用于Java 
318.             插件不能启动时显示给用户的，如果插件能够启动而applet或Bean不能，那么浏览器会有一个出错信息弹出.
320. 11.<jsp:useBean> 创建一个Bean实例并指定它的名字和作用范围. 
322.     JSP 语法
324.             <jsp:useBean 
326.             id="beanInstanceName" 
328.             scope="page | request | session | application" 
330.             { 
332.             class="package.class" | 
334.             type="package.class" | 
336.             class="package.class" type="package.class" | 
338.             beanName="{package.class | <%= expression %>}" type="package.class" 
340.             } 
342.             { 
344.             /> | 
346.             > other elements </jsp:useBean> 
348.             } 
352.     例子
354.             <jsp:useBean id="cart" scope="session" class="session.Carts" /> 
356.             <jsp:setProperty name="cart" property="*" /> 
359.             <jsp:useBean id="checking" scope="session" class="bank.Checking" > 
361.             <jsp:setProperty name="checking" property="balance" value="0.0" /> 
363.             </jsp:useBean> 
366.     描述
368.             <jsp:useBean>用于定位或示例一个JavaBeans组件。<jsp:useBean>首先会试图定位一个Bean实例，如果这个Bean不存在，那么<jsp:useBean>就会从一个class或模版中进行示例。 
370.             为了定位或示例一个Bean，<jsp:useBean>会进行以下步聚，顺序如下: 
374.             通过给定名字和范围试图定位一个Bean. 
375.             对这个Bean对象引用变量以你指定的名字命名. 
376.             如果发现了这个Bean,将会在这个变量中储存这个引用。如果你也指定了类型，那么这个Bean也设置为相应的类型. 
377.             如果没有发现这个Bean,将会从你指定的class中示例，并将此引用储存到一个新的变量中去。如果这个class的名字代表的是一个模版，那么这个Bean被java.beans.Beans.instantiate示例. 
378.             如果<jsp:useBean>已经示例（不是定位）了Bean,同时<jsp:useBean>和</jsp:useBean>中有元素，那么将会执行其中的代码. 
380.             <jsp:useBean>元素的主体通常包含有<jsp:setProperty>元素，用于设置Bean的属性值。正如上面第五步所说的?lt;jsp:useBean>的主体仅仅只有在<jsp:useBean>示例Bean时才会被执行，如果这个Bean已经存在，<jsp:useBean>能够定位它，那么主体中的内容将不会起作用 
383.     属性以及用法
386.             id="beanInstanceName" 
387.             在你所定义的范围中确认Bean的变量，你能在后面的程序中使用此变量名来分辨不同的Bean 
389.             这个变量名对大小写敏感，必须符合你所使用的脚本语言的规定，在Java 
391.             Programming Language中，这个规定在Java Language 
393.             规范已经写明。如果这个Bean已经在别的<jsp:useBean>中创建，那么这个id的值必须与原来的那个id值一致. 
395.             scope="page | request | session | application" 
396.             Bean存在的范围以及id变量名的有效范围。缺省值是page,以下是详细说明： 
400.             page - 你能在包含<jsp:useBean>元素的JSP文件以及此文件中的所有静态包含文件中使用Bean,直到页面执行完毕向客户端发回响应或转到另一个文件为止。 
401.             request - 你在任何执行相同请求的Jsp文件中使用Bean,直到页面执行完毕向客户端发回响应或转到另一个文件为止。你能够使用Request对象访问Bean,比如request.getAttribute(beanInstanceName) 
402.             session - 从创建Bean开始，你就能在任何使用相同session的Jsp文件中使用Bean.这个Bean存在于整个Session生存周期内，任何在分享此Session的Jsp文件都能使用同一Bean.注意在你创建Bean的Jsp文件中<% 
403.             @ page %>指令中必须指定session=true 
407.             application - 从创建Bean开始，你就能在任何使用相同application的Jsp文件中使用Bean.这个Bean存在于整个application生存周期内，任何在分享此application的Jsp文件都能使用同一Bean. 
408.             class="package.class" 
409.             使用new关键字以及class构造器从一个class中示例一个bean.这个class不能是抽象的，必须有一个公用的，没有参数的构造器.这个package的名字区别大小写。 
411.             type="package.class" 
412.             如果这个Bean已经在指定的范围中存在，那么写这个Bean一个新的数据库类型 
414.             。如果你没有使用class或beanName指定type，Bean将不会被示例.package和class的名字，区分大小写. 
416.             beanName="{package.class | <%= expression %>}" type="package.class" 
417.             使用java.beans.Beans.instantiate方法来从一个class或连续模版中示例一个Bean,同时指定Bean的类型。 
419.             beanName可以是package和class也可以是表达式,它的值会传给Beans.instantiate.tupe的值可以和Bean相同。 
421.             package 和 class 名字区分大小写.