JSP指令元素简介

JSP指令元素简介

指令元素（Directives Elements）

指令主要用来提供整个JSP网页相关的信息，并且用来设定JSP页面的相关属性。

一、page指令

功能：设定整个JSP网页的属性和相关功能。用于对jsp文件中的全局属性进行设置

语法：< %@ page attribute1="value1" attribute2="value2" %>

标签元素：< jsp:directive.page attribute1="value1" attribute2="value2" />

page指令元素的属性

language="language"指定JSP Container要用什么语言来编译JSP网页。目前只可以使用Java语言，不过不排除增加其它语言。默认值为Java。

extends="className"定义此JSP页面产生的Servlet是继承自哪个父类。必须为实现HttpJspPage接口的类。JSP规范对不完全理解其隐意的情况下使用此属性提出警告。

import="importList"定义此JSP页面可以使用哪些Java API。用逗号分隔列出一个或多个全质类名。此列表用于在生成的java servlet中创建相应的导入语句。进行选择的类文件有如下几种：（1）系统环境变量中所指定目录下的类文件；（2）tomcat容器默认tomcat\common\lib目录下的零散类文件或者打包后的jar 文件；（3）建立的web模块所在web-inf\classes目录下的类文件以及web-inf\lib 目录下的jar文件。

以下包是自动包含的，不必被指出：

ng.*;java.servlet.*;java.servlet.jsp.*;java.servlet.htt.*

session="true|false"用来共享信息的有效性，即指明JSP页面是否需要一个HTTP会话，如果为true，那么产生的servlet将包含创建一个HTTP会话（或访问一个HTTP会话）的代码，缺省为true。例如：某些网页有会员用户的，会员登录后会记忆该用户在推出前处于登录状态。

buffer="none|size in kb"指定输出流缓存的大小。有效值是nkb或没有。缺省为8kb。

authflush="true|false: 决定输出流的缓冲区是否要自动清除。当值为true时缓存满时将被自动刷新，当值为false时，缓冲区满会抛出溢出异常。缺省值为true。isThreadSafe="true"此JSP页面能处理来自多个线程的同步请求，此值为true，否则为false，生成的servlet表明它实现了SingleThreadMode接口。SingleThreadMode已经声明不赞成使用（deprecate）

info="text"表示此JSP页面的相关信息，由getServletInfo()方法返回的。isErrorPage="true|false"设置该页面是否作为其他页面的错误处理，即如果此

页面被用作处理异常错误的页面，则为true。在这种情况下，页面可被指定为另一页面page指令元素中errorPage属性的取值。指定此属性为true将使exception 隐含变量对此页面可用。缺省值为false。

errorPage="error_url"表示如果发生异常错误，网页会被重新指向一个URL

页面。错误页面必须在其page指令元素中指定isErrorPage="true" contentType="ctinfo"表示将在生成servlet中使用的MIME类型和可选字符解码。

pageEncoding="ctinfo"表示JSP页面的编码方式。

isELIgnored="true|false"表示是否在此JSP网页中执行或忽略EL表达式。如果为true时JSP Container将忽略EL表达式。

二、include指令

功能：在JSP编译时插入包含一个文件。包含的过程是静态的，包含的文件可以是JSP、HTML、文本或是Java程序。在jsp页面中使用该指令可引用外部文件语法：< %@ include file="relativeURLspec" %>

标签元素：< jsp:directive.include file="relativeURLspec" />

注意：include指令元素和行为元素主要有两个方面的不同点。

1.include指令是静态包含，执行时间是在编译阶段执行，引入的内容为静态文要，在编译成servlet时就和包含者融合到一起。所以file不能是一个变量，也不能在file后接任何参数。

2.include行为是动态包含，执行时间是在请求阶段执行，引入的内容在执行页面时被请求时动态生成再包含到页面中。

三、taglib指令

功能：使用标签库定义新的自定义标签，在JSP页面中启用定制行为。用于声明用户自定义的新标签

语法：< %@ taglib uri="tabLibraryURI" prefix"tagPrefix" %>

标签元素：< jsp:directive.taglib uri="tabLibraryURI" prefix"tagPrefix" />

page指令元素的属性

uri="tagLibraryURI" 标签库描述器的URI，主要是说是tagLibrary的存放位置。prefix="tagPrefix" 用于标识在页面后面部分使用定制标签的唯一前缀。