指令是一种JSP句法元素,它告诉JSP转换器应该如何将某个JSP页面转换成Servlet。
JSP 2.2中定义了几个指令:page、include、taglib、tag、attribute以及variable。其中最重要的是:page和include。
1.The page Directive
1.1.语法
<%@ page attribute1="value1" attribute2="value2" ... %>
@和page之间的空格是可选的,attribute1、attribute2等都是page指令的属性。
page指令可以出现在页面中的任何位置。只是当它包含contentType或者pageEncoding属性时,它必须放置在所有的模板数据之前, 并且是在利用Java代码发送任何内容之前。因为必须在发送任何内容之前设置内容类型和字符编码。
page指令可以多次出现。但是在多个page指令中多次出现的同一个属性,它的值必须一致,只有import属性除外。
1.2.属性
import
指定要导入的一种或多种Java类型,供本页的Java代码所用。
导入List接口:
<%@ page import="java.util.List" %>
利用通配符*可以导入整个包:
<%@ page import="java.util.*" %>
导入多重类型时,两种类型之间要用逗号隔开:
<%@ page import="java.util.ArrayList, java.util.Calendar, java.io.PrintWriter" %>
默认导入的包:
javax.servlet.*; javax.servlet.http.*; javax.servlet.jsp.*;
contentType
指定该页面隐式对象response的内容类型,其默认值为text/html。
pageEncoding
指定该页面的字符编码,其默认值为ISO-8859-1。
1.3.不常用属性
session
值为true时,表示这个页面参与Session管理;
值为false时,表示不参与Session管理。
默认值为true,意味着如果之前还没有javax.servlet.http.HttpSession实例,那么调用这个JSP页面时会创建一个。
buffer
指定隐式对象out的缓冲区大小,以千字节为单位。强制以kb为后缀。
缓冲区的默认容量大于或等于8kb,具体取决于JSP容器。
这个属性还可以设置为none,表示不适用缓存,但这样会导致输出的内容直接被写入相应的PrintWriter。
autoFlush
默认值为true,表示当缓冲区满时,被缓存的输出应当自动刷新。
值为false时,表示只有在调用隐式对象response的flush方法时,才进行刷新缓冲区。因此,当缓冲区益处时,就会抛出一个异常。
isThreadSafe
表示页面中实现的线程安全级别。建议JSP的作者不要使用这个属性,因为它会产生一个包含不建议使用的代码的Servlet。
info
指定所生成的Servlet的getServletInfo方法的返回值。
errorPage
表示负责处理该页面可能会出现的错误的页面。
isErrorPage
表名这个页面是否负责处理错误。
isElIgnored
表名是否忽略EL表达式。
language
指定这个JSP页面使用的脚本语言,其默认值为java,这个值是JSP 2.2中唯一有效的值。
extends
指定这个JSP页面的实现类必须扩展的超类。该属性很少使用。
deferredSyntaxAllowedAsLiteral
指明是否允许使用字符序列“#{”作为该页面和编译单元的String字面值。
默认值为false。
与EL表达式有关。
trimDirectiveWhitespaces
表名是否从输出内容中删除只包含空格的模板文本。
默认值为false。
2.The include Directive
利用include指令可以将另一个文件的内容放到当前的JSP页面中。在一个JSP页面中可以使用多个include指令。
如果某部分特殊的内容需要被其他页面所用,或者被处于不同位置的某个页面所用,那么将这部分内容做成一个include文件是很有帮助的。
2.1.语法
<%@ include file="url" %>
此处@和include之间的空格是可选的,并且url是表示一个include文件的相对路径。
如果url以一个正斜线(/)开头,那么其在服务器中就会被解读成是一条绝对路径。
如果不是以正斜线开头,则会被解读为相对于当前JSP页面的路径。
include指令和include动作的区别
使用include指令时,这种包含是发生在页面转换的时候,例如JSP容器将页面转换成一个Servlet的时候。
使用include动作时,这种包含则是发生在请求的时候。因此,可以利用include动作传递参数。
使用include指令时,被包含资源的文件扩展名并不重要。
使用include动作时,文件扩展名必须为jsp,以便它能够将其作为一个JSP页面进行处理。
3.The taglib Directive
可以通过使用这个指令来为JSP页面扩展标签库
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>