《Servlet和JSP学习指南》一3.4 指令-阿里云开发者社区

开发者社区> 华章出版社> 正文
登录阅读全文

《Servlet和JSP学习指南》一3.4 指令

简介: 本节书摘来自华章出版社《Servlet和JSP学习指南》一书中的第3章,第3.4节,作者(加)Budi Kurniawan,更多章节内容可以访问云栖社区“华章计算机”公众号查看

3.4 指令

指令(Directive)是第一种JSP句法元素,其指示JSP转换器应该如何将某个JSP页面转换成Servlet的命令。JSP 2.2中定义了几个指令,但最重要的是这两个:page和include,这些在本章中都会讨论到。其他章节中还会讲到的其他指令有:taglib、tag、attribute及variable。

3.4.1 page指令

利用page指令可以就当前JSP页面的某些方面对JSP转换器提出指示。例如,可以告诉JSP转换器隐式对象out应该使用多大容量的缓存区,要使用哪种内容类型,要导入哪些Java类型等。
page指令的语法如下:
image

@和page之间的空格是可选的,attribute1、attribute2等都是page指令的属性。下面是page指令的属性列表:
import。指定要导入的一种或多种Java类型,供本页的Java代码所用。例如,import="java.util.List"导入List接口。利用通配符还可以导入整个包,如import= "java.util."。导入多种类型时,两种类型之间要用一个逗号隔开,如import="java.util.ArrayList,java.util.Calendar,java.io.PrintWriter"。下面这些包中的所有类型都是隐式导入的:java.lang、javax.servlet、javax.servlet.http、javax.servlet.jsp。
session。值为true时,表示这个页面参与Session管理;值为false时,表示不参与Session管理。默认值为true,意味着如果之前还没有javax.servlet.http.HttpSession实例,那么调用JSP页面将始终会创建一个。
buffer。指定隐式对象out的缓冲区大小,以千字节为单位。强制以kb作为后缀。缓冲区的默认容量大于或等于8 KB,具体取决于JSP容器。这个属性值还可以为none,表示不使用缓存,但这样会导致输出的内容直接被写入相应的PrintWriter。
autoFlush。默认值为true,表示当缓冲区满时,被缓存的输出应该自动刷新。值为false时,表示只有在调用隐式对象response的flush方法时,才进行刷新缓冲区。因此,当缓冲区溢出时会抛出一个异常。
isThreadSafe。表示页面中实现的线程安全级别。建议JSP的作者不要使用这个属性,因为它会产生一个包含不建议使用的代码的Servlet。
info。指定所生成Servlet的getServletInfo方法返回值。
errorPage。表示负责处理该页面可能出现的错误的页面。
isErrorPage。表明这个页面是否负责处理错误。
contentType。指定该页面隐式对象response的内容类型,其默认值为text/html。
pageEncoding。指定该页面的字符编码,其默认值为ISO-8859-1。
isELIgnored。表明是否忽略EL表达式。EL是Expression Language的缩写,将在第4章中讨论。
language。指定该页面使用的脚本语言,其默认值为java,这是JSP 2.2中唯一有效的值。
extends。指定这个JSP页面的实现类必须扩展的超类。该属性很少使用,使用时应该特别小心。
deferredSyntaxAllowedAsLiteral。指明是否允许用字符序列#{作为该页面和编译单元的String字面值,其默认值为false。#{很重要,因为它在Expression Language中是一个特殊的字符序列(详情查看第4章的相关内容)。
trimDirectiveWhitespaces。表明是否从输出内容中删除只包含空格的模板文本,其默认值为false,也就是说,不删除空格。
page指令可以出现在页面中的任何位置。只是当它包含contentType或者pageEncoding属性时,它就必须放在所有的模板数据之前,并且是在利用Java代码发送任何内容之前。这是因为,必须在发送任何内容之前设置内容类型和字符编码。
page指令也可以多次出现。但是,在多个page指令中多次出现的同一个属性,它的值必须一致,只有import属性例外。放在多个page指令中的import属性,其效果可以累积。例如,下面的page指令将会同时导入java.util.ArrayList和java.io.File。
image

其结果与下面这行代码的相同:
image

下面再举个例子。这个page指令将session属性值设为false,并将页面的缓冲区容量设为16 KB:
image

3.4.2 include指令

利用include指令可以将另一个文件的内容放到当前的JSP页面中。在一个JSP页面中可以使用多个include指令。如果某部分特殊的内容需要被其他页面所用,或者被处于不同位置的某个页面所用,那么将这部分内容做成一个include文件是很有帮助的。
include指令的语法如下:
image

此处@和include之间的空格是可选的,并且url是表示一个include文件的相对路径。如果url以一个正斜线(/)开头,那么其在服务器中就会被解读成是一条绝对路径。如果不是以正斜线开头,则被解读为是相对于当前JSP页面的路径。
JSP转换器转换include指令时,用include文件的内容替换指令。换句话说,如果已经写好如代码清单3-4所示copyright.jspf文件。
fimage

同时,又有如代码清单3-5所示的main.jsp页面。
image

那么,在main.jsp页面中使用include指令时,其结果与编写以下JSP页面将是一样的。
image

为了让上述include指令生效,copyright.jspf文件必须与所包含的页面放在同一个目录下。
按照规范,include文件的扩展名应为jspf,表示为JSP fragment。如今,JSP fragment也称作JSP segment,只是为了保持一致,仍然用jspf作为扩展名。
注意,也可以包含静态的HTML文件。
本章稍后将讲到的include action,与include指令类似。这两者之间的细微差别将在3.6节中解释,要理解这两者之间的差别,这一点很重要。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:

华章出版社

官方博客
官网链接