首页 > 代码库 > JSP指令

JSP指令

以下内容引用自http://wiki.jikexueyuan.com/project/jsp/directives.html:

JSP指令(Directives)为容器提供方向和指导,告诉它如何处理JSP过程的某些方面。

JSP指令影响Servlet类的总体结构。它通常具有以下形式:

<%@ directive attribute="value" %>

指令有若干个属性,可以以键-值对的形式列出并由逗号分隔。

@符号和指令名称之间的空格,以及最后一个属性和结束标志%>之间的空格,是可选的。

指令标签有三种类型:

指令描述
<%@ page ... %>定义page-dependent属性,比如脚本语言,错误页面和缓冲要求。
<%@ include ... %>包含在转换阶段的文件。
<%@ taglib ... %>声明了一个用于页面中的标签库,包括自定义操作。

一、页面指令

页面指令用于为属于当前JSP页面的容器提供指示。可以在JSP页面的任何地方编写页面指令代码。按照惯例,通常在JSP页面的顶部编写页面指令代码。

下面是页面指令的基本语法:

<%@ page attribute="value" %>

可以编写等同于上述语法的XML,如下所示:

<jsp:directive.page attribute="value" />

二、属性

以下是页面指令相关的属性列表:

属性目的
buffer指定一个输出流的缓冲模型。
autoFlush控制Servlet输出缓冲区的行为。
contentType定义了字符编码方案。
errorPage定义了Java未检查运行时异常报告的另一个JSP的URL。
isErrorPage表明这个JSP页面是否是由另一个JSP页面的errorPage属性指定的URL。
extends指定一个超类,生成的Servlet必须扩展
import指定在JSP中使用的包或类的列表,正如Java导入声明为Java类所做的相同。
info定义一个字符串,可以访问Servlet的getServletInfo()方法。
isThreadSafe为生成的Servlet定义线程模型。
language定义了在JSP页面中使用的编程语言。
session指定JSP页面是否参与HTTP会话
isELIgnored指定JSP页面中的EL表达式中是否将被忽略。
isScriptingEnabled决定是否允许使用脚本元素。

三、包含指令

包含指令用于在转换阶段包含一个文件。这个指令告诉容器在转换阶段将其他外部文件的内容与当前JSP合并。可以在JSP页面中的任何位置编写include指令。

一般使用这个指令的形式如下:

<%@ include file="relative url" >

包含指令中的文件名实际上是一个相对URL。如果只指定一个文件名而没有相关路径,JSP编译器就会假定文件与JSP在同一个目录下。

可以编写等同于上述语法的XML,如下所示:

<jsp:directive.include file="relative url" />

四、taglib指令

JSP API允许用户定义自定义的JSP标签,看起来像HTML或XML标签,且标签库是一组用户定义的标签,能够实现自定义的行为。

taglib指令声明了JSP页面使用一组自定义标签,识别库的位置,并提供方法来确定JSP页面中的自定义标签。

taglib指令遵循以下语法:

<%@ taglib uri="uri" prefix="prefixOfTag" >

其中,uri属性值解析为容器理解的一个位置,prefix属性通知容器什么标记是自定义操作。

可以编写相当于上述的语法的XML,如下所示:

<jsp:directive.taglib uri="uri" prefix="prefixOfTag" />

JSP指令