十二、脚本元素、指令和预定义变量
程序员文章站
2023-12-19 09:22:10
12.1 jsp脚本元素 jsp脚本元素用来插入java代码，这些java代码将出现在由当前jsp页面生成的servlet中。脚本元素有三种格式： 表达式格式＜%=...
12.1 jsp脚本元素
jsp脚本元素用来插入java代码，这些java代码将出现在由当前jsp页面生成的servlet中。脚本元素有三种格式：
表达式格式＜%= expression %＞：计算表达式并输出其结果。
scriptlet格式＜% code %＞：把代码插入到servlet的service方法。
声明格式＜%! code %＞：把声明加入到servlet类（在任何方法之外）。
下面我们详细说明它们的用法。
12.1.1 jsp表达式
jsp表达式用来把java数据直接插入到输出。其语法如下：
＜%= java expression %＞
计算java表达式得到的结果被转换成字符串，然后插入到页面。计算在运行时进行（页面被请求时），因此可以访问和请求有关的全部信息。例如，下面的代码显示页面被请求的日期/时间：
current time: ＜%= new java.util.date() %＞
为简化这些表达式，jsp预定义了一组可以直接使用的对象变量。后面我们将详细介绍这些隐含声明的对象，但对于jsp表达式来说，最重要的几个对象及其类型如下：
request：httpservletrequest;
response：httpservletresponse;
session：和request关联的httpsession
out：printwriter（带缓冲的版本，jspwriter），用来把输出发送到客户端
下面是一个例子：
your hostname: ＜%= request.getremotehost() %＞
最后，如果使用xml的话，jsp表达式也可以写成下面这种形式：
＜jsp:expression＞
java expression
＜/jsp:expression＞
请记住xml元素和html不一样。xml是大小写敏感的，因此务必使用小写。有关xml语法的说明，请参见《xml教程 》
12.1.2 jsp scriptlet
如果你要完成的任务比插入简单的表达式更加复杂，可以使用jsp scriptlet。jsp scriptlet允许你把任意的java代码插入servlet。jsp scriptlet语法如下：
＜% java code %＞
和jsp表达式一样，scriptlet也可以访问所有预定义的变量。例如，如果你要向结果页面输出内容，可以使用out变量：
＜%
string querydata = request.getquerystring();
out.println("attached get data: " + querydata);
%＞
注意scriptlet中的代码将被照搬到servlet内，而scriptlet前面和后面的静态html（模板文本）将被转换成println语句。这就意味着，scriptlet内的java语句并非一定要是完整的，没有关闭的块将影响scriptlet外的静态html。例如，下面的jsp片断混合了模板文本和scriptlet：
＜% if (math.random() ＜ 0.5) { %＞
have a ＜b＞nice＜/b＞ day!
＜% } else { %＞
have a ＜b＞lousy＜/b＞ day!
＜% } %＞
上述jsp代码将被转换成如下servlet代码：
if (math.random() ＜ 0.5) {
out.println("have a ＜b＞nice＜/b＞ day!");
} else {
out.println("have a ＜b＞lousy＜/b＞ day!");
}
如果要在scriptlet内部使用字符“%＞”，必须写成“%＼＞”。另外，请注意＜% code %＞的xml等价表达是：
＜jsp:scriptlet＞
code
＜/jsp:scriptlet＞
12.1.3 jsp声明
jsp声明用来定义插入servlet类的方法和成员变量，其语法如下：
＜%! java code %＞
由于声明不会有任何输出，因此它们往往和jsp表达式或scriptlet结合在一起使用。例如，下面的jsp代码片断输出自从服务器启动（或servlet类被改动并重新装载以来）当前页面被请求的次数：
＜%! private int accesscount = 0; %＞
自从服务器启动以来页面访问次数为：
＜%= ++accesscount %＞
和scriptlet一样，如果要使用字符串“%＞”，必须使用“%＼＞”代替。最后，＜%! code %＞的xml等价表达方式为：
＜jsp:declaration＞
code
＜/jsp:declaration＞
12.2 jsp指令
jsp指令影响servlet类的整体结构，它的语法一般如下：
＜%@ directive attribute="value" %＞
另外，也可以把同一指令的多个属性结合起来，例如：
＜%@ directive attribute1="value1"
attribute2="value2"
...
attributen="valuen" %＞
jsp指令分为两种类型：第一是page指令，用来完成下面这类任务：导入指定的类，自定义servlet的超类，等等；第二是include指令，用来在jsp文件转换成servlet时引入其他文件。jsp规范也提到了taglib指令，其目的是让jsp开发者能够自己定义标记，但jsp 1.0不支持该指令，有希望它将成为jsp 1.1的主要改进之一。
12.2.1 page指令
page指令的作用是定义下面一个或多个属性，这些属性大小写敏感。
import="package.class"，或者import="package.class1,...,package.classn"：
用于指定导入哪些包，例如：＜%@ page import="java.util.*" %＞。import是唯一允许出现一次以上的属性。
contenttype="mime-type" 或contenttype="mime-type; charset=character-set"：
该属性指定输出的mime类型。默认是text/html。例如，下面这个指令：
＜%@ page contenttype="text/plain" %＞。
和下面的scriptlet效果相同：
＜% response.setcontenttype("text/plain"); %＞
isthreadsafe="true|false"
默认值true表明servlet按照标准的方式处理，即假定开发者已经同步对实例变量的访问，由单个servlet实例同时地处理多个请求。如果取值false，表明servlet应该实现singlethreadmodel，请求或者是逐个进入，或者多个并行的请求分别由不同的servlet实例处理。
session="true|false"
默认值true表明预定义变量session（类型为httpsession）应该绑定到已有的会话，如果不存在已有的会话，则新建一个并绑定session变量。如果取值false，表明不会用到会话，试图访问变量session将导致jsp转换成servlet时出错。
buffer="size kb|none"
该属性指定jspwrite out的缓存大小。默认值和服务器有关，但至少应该是8 kb。
autoflush="true|false"
默认值true表明如果缓存已满则刷新它。autoflush很少取false值，false值表示如果缓存已满则抛出异常。如果buffer="none"，autoflush不能取false值。
extends="package.class"
该属性指出将要生成的servlet使用哪个超类。使用该属性应当十分小心，因为服务器可能已经在用自定义的超类。
info="message"
该属性定义一个可以通过getservletinfo方法提取的字符串。
errorpage="url"
该属性指定一个jsp页面，所有未被当前页面捕获的异常均由该页面处理。
iserrorpage="true|false"
该属性指示当前页面是否可以作为另一jsp页面的错误处理页面。默认值false。
language="java"
该属性用来指示所使用的语言。目前没有必要关注这个属性，因为默认的java是当前唯一可用的语言。
定义指令的xml语法为：
＜jsp:directive.directivetype attribute=value /＞
例如，下面这个指令：
＜%@ page import="java.util.*" %＞
它的xml等价表达是：
＜jsp:directive.page import="java.util.*" /＞
12.2.2 include指令
include指令用于jsp页面转换成servlet时引入其他文件。该指令语法如下：
＜%@ include file="relative url" %＞
这里所指定的url是和发出引用指令的jsp页面相对的url，然而，与通常意义上的相对url一样，你可以利用以“/”开始的url告诉系统把url视为从web服务器根目录开始。包含文件的内容也是jsp代码，即包含文件可以包含静态html、脚本元素、jsp指令和动作。
例如，许多网站的每个页面都有一个小小的导航条。由于html框架存在不少问题，导航条往往用页面顶端或左边的一个表格制作，同一份html代码重复出现在整个网站的每个页面上。include指令是实现该功能的非常理想的方法。使用include指令，开发者不必再把导航html代码拷贝到每个文件中，从而可以更轻松地完成维护工作。
由于include指令是在jsp转换成servlet的时候引入文件，因此如果导航条改变了，所有使用该导航条的jsp页面都必须重新转换成servlet。如果导航条改动不频繁，而且你希望包含操作具有尽可能好的效率，使用include指令是最好的选择。然而，如果导航条改动非常频繁，你可以使用jsp:include动作。jsp:include动作在出现对jsp页面请求的时候才会引用指定的文件，请参见本文后面的具体说明。
12.3 实例：脚本元素和指令的应用
下面是一个使用jsp表达式、scriptlet、声明、指令的简单例子。
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞javaserver pages＜/title＞
＜/head＞
＜body bgcolor="#fdf5e6" text="#000000" link="#0000ee"
vlink="#551a8b" alink="#ff0000"＞
＜center＞
＜table border=5 bgcolor="#ef8429"＞
＜tr＞＜th class="title"＞
jsp应用实例＜/table＞
＜/center＞
＜p＞
下面是一些利用各种jsp功能生成的动态内容:
＜ul＞
＜li＞＜b＞表达式.＜/b＞＜br＞
你的主机名: ＜%= request.getremotehost() %＞.
＜li＞＜b＞jsp scriptlet.＜/b＞＜br＞
＜% out.println("查询字符串: " +
request.getquerystring()); %＞
＜li＞＜b＞声明（和表达式）.＜/b＞＜br＞
＜%! private int accesscount = 0; %＞
服务器启动以来访问次数: ＜%= ++accesscount %＞
＜li＞＜b＞指令（和表达式）.＜/b＞＜br＞
＜%@ page import = "java.util.*" %＞
当前日期: ＜%= new date() %＞
＜/ul＞
＜/body＞
＜/html＞
12.4 jsp预定义变量
为了简化jsp表达式和scriptlet的代码，jsp提供了8个预先定义的变量（或称为隐含对象）。这些变量是request、response、out、session、application、config、pagecontext和page。
12.4.1 request
这是和请求关联的httpservletrequest，通过它可以查看请求参数（调用getparameter），请求类型（get，post，head，等），以及请求的http头（cookie，referer，等）。严格说来，如果请求所用的是http之外的其他协议，request可以是servletrequest的子类（而不是httpservletrequest），但在实践中几乎不会用到。
12.4.2 response
这是和应答关联的httpservletresponse。注意，由于输出流（参见下面的out）是带缓冲的，因此，如果已经向客户端发送了输出内容，普通servlet不允许再设置http状态代码，但在jsp中却是合法的。
12.4.3 out
这是用来向客户端发送内容的printwriter。然而，为了让response对象更为实用，out是带缓存功能的printwriter，即jspwriter。jsp允许通过page指令的buffer属性调整缓存的大小，甚至允许关闭缓存。
out一般只在scriptlet内使用，这是因为jsp表达式是自动发送到输出流的，很少需要显式地引用out。
12.4.4 session
这是和请求关联的httpsession对象。前面我们已经介绍过会话的自动创建，我们知道，即使不存在session引用，这个对象也是自动绑定的。但有一个例外，这就是如果你用page指令的session属性关闭了会话，此时对session变量的引用将导致jsp页面转换成servlet时出错。
12.4.5 application
这是一个servletcontext，也可以通过getservletconfig().getcontext()获得。
12.4.6 config
这是当前页面的servletconfig对象。
12.4.7 pagecontext
主要用来管理页面的属性。
12.4.8 page
它是this的同义词，当前用处不大。它是为了java不再是唯一的jsp编程语言而准备的占位符。
jsp脚本元素用来插入java代码，这些java代码将出现在由当前jsp页面生成的servlet中。脚本元素有三种格式：
表达式格式＜%= expression %＞：计算表达式并输出其结果。
scriptlet格式＜% code %＞：把代码插入到servlet的service方法。
声明格式＜%! code %＞：把声明加入到servlet类（在任何方法之外）。
下面我们详细说明它们的用法。
12.1.1 jsp表达式
jsp表达式用来把java数据直接插入到输出。其语法如下：
＜%= java expression %＞
计算java表达式得到的结果被转换成字符串，然后插入到页面。计算在运行时进行（页面被请求时），因此可以访问和请求有关的全部信息。例如，下面的代码显示页面被请求的日期/时间：
current time: ＜%= new java.util.date() %＞
为简化这些表达式，jsp预定义了一组可以直接使用的对象变量。后面我们将详细介绍这些隐含声明的对象，但对于jsp表达式来说，最重要的几个对象及其类型如下：
request：httpservletrequest;
response：httpservletresponse;
session：和request关联的httpsession
out：printwriter（带缓冲的版本，jspwriter），用来把输出发送到客户端
下面是一个例子：
your hostname: ＜%= request.getremotehost() %＞
最后，如果使用xml的话，jsp表达式也可以写成下面这种形式：
＜jsp:expression＞
java expression
＜/jsp:expression＞
请记住xml元素和html不一样。xml是大小写敏感的，因此务必使用小写。有关xml语法的说明，请参见《xml教程 》
12.1.2 jsp scriptlet
如果你要完成的任务比插入简单的表达式更加复杂，可以使用jsp scriptlet。jsp scriptlet允许你把任意的java代码插入servlet。jsp scriptlet语法如下：
＜% java code %＞
和jsp表达式一样，scriptlet也可以访问所有预定义的变量。例如，如果你要向结果页面输出内容，可以使用out变量：
＜%
string querydata = request.getquerystring();
out.println("attached get data: " + querydata);
%＞
注意scriptlet中的代码将被照搬到servlet内，而scriptlet前面和后面的静态html（模板文本）将被转换成println语句。这就意味着，scriptlet内的java语句并非一定要是完整的，没有关闭的块将影响scriptlet外的静态html。例如，下面的jsp片断混合了模板文本和scriptlet：
＜% if (math.random() ＜ 0.5) { %＞
have a ＜b＞nice＜/b＞ day!
＜% } else { %＞
have a ＜b＞lousy＜/b＞ day!
＜% } %＞
上述jsp代码将被转换成如下servlet代码：
if (math.random() ＜ 0.5) {
out.println("have a ＜b＞nice＜/b＞ day!");
} else {
out.println("have a ＜b＞lousy＜/b＞ day!");
}
如果要在scriptlet内部使用字符“%＞”，必须写成“%＼＞”。另外，请注意＜% code %＞的xml等价表达是：
＜jsp:scriptlet＞
code
＜/jsp:scriptlet＞
12.1.3 jsp声明
jsp声明用来定义插入servlet类的方法和成员变量，其语法如下：
＜%! java code %＞
由于声明不会有任何输出，因此它们往往和jsp表达式或scriptlet结合在一起使用。例如，下面的jsp代码片断输出自从服务器启动（或servlet类被改动并重新装载以来）当前页面被请求的次数：
＜%! private int accesscount = 0; %＞
自从服务器启动以来页面访问次数为：
＜%= ++accesscount %＞
和scriptlet一样，如果要使用字符串“%＞”，必须使用“%＼＞”代替。最后，＜%! code %＞的xml等价表达方式为：
＜jsp:declaration＞
code
＜/jsp:declaration＞
12.2 jsp指令
jsp指令影响servlet类的整体结构，它的语法一般如下：
＜%@ directive attribute="value" %＞
另外，也可以把同一指令的多个属性结合起来，例如：
＜%@ directive attribute1="value1"
attribute2="value2"
...
attributen="valuen" %＞
jsp指令分为两种类型：第一是page指令，用来完成下面这类任务：导入指定的类，自定义servlet的超类，等等；第二是include指令，用来在jsp文件转换成servlet时引入其他文件。jsp规范也提到了taglib指令，其目的是让jsp开发者能够自己定义标记，但jsp 1.0不支持该指令，有希望它将成为jsp 1.1的主要改进之一。
12.2.1 page指令
page指令的作用是定义下面一个或多个属性，这些属性大小写敏感。
import="package.class"，或者import="package.class1,...,package.classn"：
用于指定导入哪些包，例如：＜%@ page import="java.util.*" %＞。import是唯一允许出现一次以上的属性。
contenttype="mime-type" 或contenttype="mime-type; charset=character-set"：
该属性指定输出的mime类型。默认是text/html。例如，下面这个指令：
＜%@ page contenttype="text/plain" %＞。
和下面的scriptlet效果相同：
＜% response.setcontenttype("text/plain"); %＞
isthreadsafe="true|false"
默认值true表明servlet按照标准的方式处理，即假定开发者已经同步对实例变量的访问，由单个servlet实例同时地处理多个请求。如果取值false，表明servlet应该实现singlethreadmodel，请求或者是逐个进入，或者多个并行的请求分别由不同的servlet实例处理。
session="true|false"
默认值true表明预定义变量session（类型为httpsession）应该绑定到已有的会话，如果不存在已有的会话，则新建一个并绑定session变量。如果取值false，表明不会用到会话，试图访问变量session将导致jsp转换成servlet时出错。
buffer="size kb|none"
该属性指定jspwrite out的缓存大小。默认值和服务器有关，但至少应该是8 kb。
autoflush="true|false"
默认值true表明如果缓存已满则刷新它。autoflush很少取false值，false值表示如果缓存已满则抛出异常。如果buffer="none"，autoflush不能取false值。
extends="package.class"
该属性指出将要生成的servlet使用哪个超类。使用该属性应当十分小心，因为服务器可能已经在用自定义的超类。
info="message"
该属性定义一个可以通过getservletinfo方法提取的字符串。
errorpage="url"
该属性指定一个jsp页面，所有未被当前页面捕获的异常均由该页面处理。
iserrorpage="true|false"
该属性指示当前页面是否可以作为另一jsp页面的错误处理页面。默认值false。
language="java"
该属性用来指示所使用的语言。目前没有必要关注这个属性，因为默认的java是当前唯一可用的语言。
定义指令的xml语法为：
＜jsp:directive.directivetype attribute=value /＞
例如，下面这个指令：
＜%@ page import="java.util.*" %＞
它的xml等价表达是：
＜jsp:directive.page import="java.util.*" /＞
12.2.2 include指令
include指令用于jsp页面转换成servlet时引入其他文件。该指令语法如下：
＜%@ include file="relative url" %＞
这里所指定的url是和发出引用指令的jsp页面相对的url，然而，与通常意义上的相对url一样，你可以利用以“/”开始的url告诉系统把url视为从web服务器根目录开始。包含文件的内容也是jsp代码，即包含文件可以包含静态html、脚本元素、jsp指令和动作。
例如，许多网站的每个页面都有一个小小的导航条。由于html框架存在不少问题，导航条往往用页面顶端或左边的一个表格制作，同一份html代码重复出现在整个网站的每个页面上。include指令是实现该功能的非常理想的方法。使用include指令，开发者不必再把导航html代码拷贝到每个文件中，从而可以更轻松地完成维护工作。
由于include指令是在jsp转换成servlet的时候引入文件，因此如果导航条改变了，所有使用该导航条的jsp页面都必须重新转换成servlet。如果导航条改动不频繁，而且你希望包含操作具有尽可能好的效率，使用include指令是最好的选择。然而，如果导航条改动非常频繁，你可以使用jsp:include动作。jsp:include动作在出现对jsp页面请求的时候才会引用指定的文件，请参见本文后面的具体说明。
12.3 实例：脚本元素和指令的应用
下面是一个使用jsp表达式、scriptlet、声明、指令的简单例子。
＜!doctype html public "-//w3c//dtd html 4.0 transitional//en"＞
＜html＞
＜head＞
＜title＞javaserver pages＜/title＞
＜/head＞
＜body bgcolor="#fdf5e6" text="#000000" link="#0000ee"
vlink="#551a8b" alink="#ff0000"＞
＜center＞
＜table border=5 bgcolor="#ef8429"＞
＜tr＞＜th class="title"＞
jsp应用实例＜/table＞
＜/center＞
＜p＞
下面是一些利用各种jsp功能生成的动态内容:
＜ul＞
＜li＞＜b＞表达式.＜/b＞＜br＞
你的主机名: ＜%= request.getremotehost() %＞.
＜li＞＜b＞jsp scriptlet.＜/b＞＜br＞
＜% out.println("查询字符串: " +
request.getquerystring()); %＞
＜li＞＜b＞声明（和表达式）.＜/b＞＜br＞
＜%! private int accesscount = 0; %＞
服务器启动以来访问次数: ＜%= ++accesscount %＞
＜li＞＜b＞指令（和表达式）.＜/b＞＜br＞
＜%@ page import = "java.util.*" %＞
当前日期: ＜%= new date() %＞
＜/ul＞
＜/body＞
＜/html＞
12.4 jsp预定义变量
为了简化jsp表达式和scriptlet的代码，jsp提供了8个预先定义的变量（或称为隐含对象）。这些变量是request、response、out、session、application、config、pagecontext和page。
12.4.1 request
这是和请求关联的httpservletrequest，通过它可以查看请求参数（调用getparameter），请求类型（get，post，head，等），以及请求的http头（cookie，referer，等）。严格说来，如果请求所用的是http之外的其他协议，request可以是servletrequest的子类（而不是httpservletrequest），但在实践中几乎不会用到。
12.4.2 response
这是和应答关联的httpservletresponse。注意，由于输出流（参见下面的out）是带缓冲的，因此，如果已经向客户端发送了输出内容，普通servlet不允许再设置http状态代码，但在jsp中却是合法的。
12.4.3 out
这是用来向客户端发送内容的printwriter。然而，为了让response对象更为实用，out是带缓存功能的printwriter，即jspwriter。jsp允许通过page指令的buffer属性调整缓存的大小，甚至允许关闭缓存。
out一般只在scriptlet内使用，这是因为jsp表达式是自动发送到输出流的，很少需要显式地引用out。
12.4.4 session
这是和请求关联的httpsession对象。前面我们已经介绍过会话的自动创建，我们知道，即使不存在session引用，这个对象也是自动绑定的。但有一个例外，这就是如果你用page指令的session属性关闭了会话，此时对session变量的引用将导致jsp页面转换成servlet时出错。
12.4.5 application
这是一个servletcontext，也可以通过getservletconfig().getcontext()获得。
12.4.6 config
这是当前页面的servletconfig对象。
12.4.7 pagecontext
主要用来管理页面的属性。
12.4.8 page
它是this的同义词，当前用处不大。它是为了java不再是唯一的jsp编程语言而准备的占位符。