精华区文章阅读

发信人: rainy (段誉), 信区: Java
标  题: 十二、脚本元素、指令和预定义变量
发信站: 哈工大紫丁香 (2001年10月20日11:30:59 星期六), 站内信件

　　 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编程语言
而准备的占位符。

--
如果能在开满了栀子花的山坡上与你相遇,          .oooO  Oooo.
如果能深深地爱过一次再别离,                    (   )  (   )
那么,再长久的一生,                              \ (    ) /
不也就只是,                                      \_)  (_/
回首时那短短的一瞬.

※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: sunny.hit.edu.cn]

Java 版 (精华区)