JSP 语法详解.docx
《JSP 语法详解.docx》由会员分享,可在线阅读,更多相关《JSP 语法详解.docx(20页珍藏版)》请在冰豆网上搜索。
JSP语法详解
JSP语法详解
HTML注释
在客户端显示一个注释.
JSP语法
--comment[<%=expression%>]-->
例子1
--Thisfiledisplaystheuserloginscreen-->
在客户端的HTML源代码中产生和上面一样的数据:
--Thisfiledisplaystheuserloginscreen-->
例子2
--Thispagewasloadedon<%=(newjava.util.Date()).toLocaleString()%>-->
在客户端的HTML源代码中显示为:
--ThispagewasloadedonJanuary1,2000-->
描述
这种注释和HTML中很像,也就是它可以在"查看源代码"中看到.
唯一有些不同的就是,你可以在这个注释中用表达式(例子2所示).这个表达示是不定的,由页面不同而不同,你能够使用各种表达式,只要是合法的就行。
更多的请看表达式
隐藏注释
写在JSP程序中,但不是发给客户。
JSP语法
<%--comment--%>
例子:
<%@pagelanguage="java"%>
ACommentTestATestofComments
<%--Thiscommentwillnotbevisibleinthepagesource--%>
描述
用隐藏注释标记的字符会在JSP编译时被忽略掉。
这个注释在你希望隐藏或注释你的JSP程序时是很有用的。
JSP编译器不是会对<%--and--%>之间的语句进行编译的,它不会显示在客户的浏览器中,也不会在源代码中看到
声明
在JSP程序中声明合法的变量和方法
JSP语法
<%!
declaration;[declaration;]+...%>
例子
<%!
inti=0;%>
<%!
inta,b,c;%>
<%!
Circlea=newCircle(2.0);%>
描述
声明你将要在JSP程序中用到的变量和方法。
你也必须这样做,不然会出错.
你可以一次性声明多个变量和方法,只要以";"结尾就行,当然这些声明在Java中要是合法的。
当你声明方法或变量时,请注意以下的一些规则:
声明必须以";"结尾(Scriptlet有同样的规则,但是表达式就不同了).
你可以直接使用在<%@page%>中被包含进来的已经声明的变量和方法,不需要对它们重新进行声明.
一个声明仅在一个页面中有效。
如果你想每个页面都用到一些声明,最好把它们写成一个单独的文件,然后用<%@include%>或include>元素包含进来。
表达式
包含一个符合JSP语法的表达式
JSP语法
<%=expression%>
例子
<%=map.size()%>
<%=numguess.getHint()%>.
描述
表达式元素表示的是一个在脚本语言中被定义的表达式,在运行后被自动转化为字符串,然后插入到这个表达示在JSP文件的位置显示。
因为这个表达式的值已经被转化为字符串,所以你能在一行文本中插入这个表达式(形式和ASP完全一样).
当你在JSP中使用表达式时请记住以下几点:
你不能用一个分号(";")来作为表达式的结束符.但是同样的表达式用在scriptlet中就需要以分号来结尾了!
查看Scriptlet
这个表达式元素能够包括任何在JavaLanguageSpecification中有效的表达式.
有时候表达式也能做为其它JSP元素的属性值.一个表达式能够变得很复杂,它可能由一个或多个表达式组成,这些表达式的顺序是从左到右。
Scriptlet
包含一个有效的程序段.
JSP语法
<%@include%>指令将会在JSP编译时插入一个包含文本或代码的文件,当你使用<%@include%>指命时,这个包含的过程就当是静态的。
静态的包含就是指这个被包含的文件将会被插入到JSP文件中去,这个包含的文件可以是JSP文件,HTML文件,文本文件。
如果包含的是JSP文件,这个包含的JSP的文件中代码将会被执行。
如果你仅仅只是用include来包含一个静态文件。
那么这个包含的文件所执行的结果将会插入到JSP文件中放<%@include%>的地方。
一旦包含文件被执行,那么主JSP文件的过程将会被恢复,继续执行下一行.
这个被包含文件可以是html文件,jsp文件,文本文件,或者只是一段Java代码,但是你得注意在这个包含文件中不能使用,,
,标记,因为这将会影响在原JSP文件中同样的标记,这样做有时会导致错误.
有一些<%@include%>指命的行为是以特殊的JSP编译条件为基础,比如:
这个被包含的文件必须对所有客户都有开放且必须f有效,或者它有安全限制
如果这个包含文件被改变,包含此文件的JSP文件将被重新编译
属性:
file="relativeURL"
这个包含文件的路径名一般来说是指相对路径,不需要什么端口,协议,和域名,如下:
"error.jsp""templates/onlinestore.html""/beans/calendar.jsp"
如果这个路径以"/"开头,那么这个路径主要是参照JSP应用的上下关系路径,如果路径是以文件名或目录名开头,那么这个路径就是正在使用的JSP文件的当前路径.
Page指令
定义JSP文件中的全局属性.
JSP语法
<%@page
[language="java"]
[extends="package.class"]
[import="{package.class|package.*},..."]
[session="true|false"]
[buffer="none|8kb|sizekb"]
[autoFlush="true|false"]
[isThreadSafe="true|false"]
[info="text"]
[errorPage="relativeURL"]
[contentType="mimeType[;charset=characterSet]"|"text/html;charset=ISO-8859-1"]
[isErrorPage="true|false"]
%>
例子
<%@pageimport="java.util.*,java.lang.*"%>
<%@pagebuffer="5kb"autoFlush="false"%>
<%@pageerrorPage="error.jsp"%>
描述
<%@page%>指令作用于整个JSP页面,同样包括静态的包含文件。
但是<%@page%>指令不能作用于动态的包含文件,比如include>
你可以在一个页面中用上多个<%@page%>指令,但是其中的属性只能用一次,不过也有个例外,那就是import属性。
因为import属性和Java中的import语句差不多(参照JavaLanguage),所以你就能多用此属性几次了.
无论你把<%@page%>指令放在JSP的文件的哪个地方,它的作用范围都是整个JSP页面。
不过,为了JSP程序的可读性,以及好的编程习惯,最好还是把它放在JSP文件的顶部.
属性
language="java"
声明脚本语言的种类,暂时只能用"java"
extends="package.class"
标明JSP编译时需要加入的JavaClass的全名,但是得慎重的使用它,它会限制JSP的编译能力.
import="{package.class|package.*},..."
需要导入的Java包的列表,这些包就作用于程序段,表达式,以及声明。
下面的包在JSP编译时已经导入了,所以你就不需要再指明了:
java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*
session="true|false"
设定客户是否需要HTTPSession.(学过ASP的人,应该对它不陌生)如果它为true,那么Session是有用的。
如果它有false,那么你就不能使用session对象,以及定义了scope=session的useBean>元素。
这样的使用会导致错误.
缺省值是true.
buffer="none|8kb|sizekb"
buffer的大小被out对象用于处理执行后的JSP对客户浏览器的输出。
缺省值是8kb
autoFlush="true|false"
设置如果buffer溢出,是否需要强制输出,如果其值被定义为true(缺省值),输出正常,如果它被设置为false,如果这个buffer溢出,就会导致一个意外错误的发生.如果你把buffer设置为none,那么你就不能把autoFlush设置为false.
isThreadSafe="true|false"
设置Jsp文件是否能多线程使用。
缺省值是true,也就是说,JSP能够同时处理多个用户的请求,如果设置为false,一个jsp只能一次处理一个请求
info="text"
一个文本在执行JSP将会被逐字加入JSP中,你能够使用Servlet.getServletInfo方法取回。
errorPage="relativeURL"
设置处理异常事件的JSP文件。
isErrorPage="true|false"
设置此页是否为出错页,如果被设置为true,你就能使用exception对象.
contentType="mimeType[;charset=characterSet]"|"text/html;charset=ISO-8859-1"
设置MIME类型。
缺省MIME类型是:
text/html,缺省字符集为ISO-8859-1.
forward>
重定向一个HTML文件,JSP文件,或者是一个程序段.
JSP语法
forwardpage={"relativeURL"|"<%=expression%>"}/>
or
forwardpage={"relativeURL"|"<%=expression%>"}>
paramname="parameterName"
value="{parameterValue|<%=expression%>}"/>+
forward>
例子
forwardpage="/servlet/login"/>
forwardpage="/servlet/login">
paramname="username"value="jsmith"/>
forward>
描述
forward>标签从一个JSP文件向另一个文件传递一个包含用户请求的request对象.forward>标签以下的代码,将不能执行.
你能够向目标文件传送参数和值,在这个例子中我们传递的参数名为username,值为scott,如果你使用了param>标签的话,目标文件必须是一个动态的文件,能够处理参数.
如果你使用了非缓冲输出的话,那么使用forward>时就要小心。
如果在你使用forward>之前,jsp文件已经有了数据,那么文件执行就会出错.
属性
page="{relativeURL|<%=expression%>}"
这里是一个表达式或是一个字符串用于说明你将要定向的文件或URL.这个文件可以是JSP,程序段,或者其它能够处理request对象的文件(如asp,cgi,php).
paramname="parameterName"value="{parameterValue|<%=expression%>}"/>+
向一个动态文件发送一个或多个参数,这个文件一定是动态文件.
如果你想传递多个参数,你可以在一个JSP文件中使用多个param>。
name指定参数名,value指定参数值.
getProperty>
获取Bean的属性值,用于显示在页面中
JSP语法
getPropertyname="beanInstanceName"property="propertyName"/>
例子
useBeanid="calendar"scope="page"class="employee.Calendar"/>
CalendarofgetPropertyname="calendar"property="username"/>
描述
这个getProperty>元素将获得Bean的属性值,并可以将其使用或显示在JSP页面中.在你使用getProperty>之前,你必须用useBean>创建它.
getProperty>元素有一些限制:
你不能使用getProperty>来检索一个已经被索引了的属性
你能够和JavaBeans组件一起使用getProperty>,但是不能与EnterpriseBean一起使用。
属性
name="beanInstanceName"
bean的名字,由useBean>指定
property="propertyName"
所指定的Bean的属性名。
技巧:
在sun的JSP参考中提到,如果你使用getProperty>来检索的值是空值,那么NullPointerException将会出现,同时如果使用程序段或表达式来检索其值,那么在浏览器上出现的是null(空).
include>
包含一个静态或动态文件.
JSP语法
includepage="{relativeURL|<%=expression%>}"flush="true"/>
or
includepage="{relativeURL|<%=expression%>}"flush="true">
paramname="parameterName"value="{parameterValue|<%=expression%>}"/>+
include>
Examples
includepage="scripts/login.jsp"/>
includepage="copyright.html"/>
includepage="/index.html"/>
includepage="scripts/login.jsp">
paramname="username"value="jsmith"/>
include>
描述
include>元素允许你包含动态文件和静态,这两种包含文件的结果是不同的。
如果文件仅是静态文件,那么这种包含仅仅是把包含文件的内容加到jsp文件中去,而如果这个文件动态的,那么这个被包含文件也会被Jsp编译器执行(这一切与asp相似)
你不能从文件名上判断一个文件是动态的还是静态的,比如aspcn.asp就有可能只是包含一些信息而已,而不需要执行。
include>能够同时处理这两种文件,因此你就不需要包含时还要判断此文件是动态的还是静态的.
如果这个包含文件是动态的,那么你还可以用param>还传递参数名和参数值。
属性
page="{relativeURL|<%=expression%>}"
参数为一相对路径,或者是代表相对路径的表达式.
flush="true"
这里你必须使用flush="true",你不能使用false值.缺省值为false
paramname="parameterName"value="{parameterValue|<%=expression%>}"/>+
param>子句能让你传递一个或多个参数给动态文件
你能在一个页面中使用多个param>来传递多个参数,
plugin>
执行一个applet或Bean,有可能的话还要下载一个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"]>
[params>
[paramname="parameterName"value="{parameterValue|<%=expression%>}"/>]+
params>]
[fallback>textmessageforuser
fallback>]
plugin>
例子
plugintype=appletcode="Molecule.class"codebase="/html">
params>
paramname="molecule"value="molecules/benzene.mol"/>
params>
fallback>
Unabletoloadapplet
fallback>
plugin>
描述
plugin>元素用于在浏览器中播放或显示一个对象(典型的就是applet和Bean),而这种显示需要在浏览器的java插件。
当Jsp文件被编译,送往浏览器时,plugin>元素将会根据浏览器的版本替换成
注意,
一般来说,plugin>元素会指定对象是Applet还是Bean,同样也会指定class的名字,还有位置,另外还会指定将从哪里下载这个Java插件。
具体如下:
属性
type="bean|applet"
.将被执行的插件对象的类型,你必须得指定这个是Bean还是applet,因为这个属性没有缺省值.
code="classFileName"
将会被Java插件执行的JavaClass的名字,必须以.class结尾。
这个文件必须存在于codebase属性指定的目录中.
codebase="classFileDirectoryName"
将会被执行的JavaClass文件的目录(或者是路径),如果你没有提供此属性,那么使用plugin>的jsp文件的目录将会被使用.
name="instanceName"
这个Bean或applet实例的名字,它将会在Jsp其它的地方调用.
archive="URIToArchive,..."
一些由逗号分开的路径名,这些路径名用于预装一些将要使用的class,这会提高applet的性能.
align="bottom|top|middle|left|right"
图形,对象,Applet的位置,有以下值:
bottom
top
middle
left
right
height="displayPixels"width="displayPixels"
Applet或Bean将要显示的长宽的值,此值为数字,单位为象素.
hspace="leftRightPixels"vspace="topBottomPixels"
Applet或Bean显示时在屏幕左右,上下所需留下的空间,单位为象素.
jreversion="JREVersionNumber|1.1"
Applet或Bean运行所需的JavaRuntimeEnvironment(JRE)的版本.缺省值是1.1.
nspluginurl="URLToPlugin"
NetscapeNavigator用户能够使用的JRE的下载地址,此值为一个标准的URL,如
iepluginurl="URLToPlugin"
IE用户能够使用的JRE的下载地址,此值为一个标准的URL,如
params>[paramname="parameterName"value="{parameterValue|<%=expression%>}"/>]+
params>
你需要向applet或Bean传送的参数或参数值。
fallback>textmessageforuser
fallback>
一段文字用于Java插件不能启动时显示给用户的,如果插件能够启动而applet或Bean不能,那么浏览器会有一个出错信息弹出.
setProperty>
设置Bean中的属性值.
JSP语法
setProperty
name="beanInstanceName"
{
property="*"|
property="proper