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" />
示例:
include指令的一个很好的例子是一个具有多页内容的公共页眉和页脚。
定义以下三个文件(a)header.jps,(b)footer.jsp和(c)main.jsp如下:
以下是header.jsp内容的:
<%! int pageCount = 0; void addCount() { pageCount++; } %> <% addCount(); %> <html> <head> <title>The include Directive Example</title> </head> <body> <center> <h2>The include Directive Example</h2> <p>This site has been visited <%= pageCount %> times.</p> </center> <br/><br/>
以下是内容footer.jsp中 -
<br/><br/> <center> <p>Copyright © 2010</p> </center> </body> </html>
最后这里是main.jsp的内容-
<%@ include file="header.jsp" %> <center> <p>Thanks for visiting my page.</p> </center> <%@ include file="footer.jsp" %>
现在把所有这些文件保存在根目录下,并尝试访问main.jsp。
刷新main.jsp,会发现页面匹配计数器不断增加。
四、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" />
示例:
例如,假设custlib标签库包含一个名为hello的标签。如果想使用一个前缀为mytag的hello标签,标签将是<mytag:hello>,它将在JSP文件中被使用如下:
<%@ taglib uri="http://www.example.com/custlib" prefix="mytag" %> <html> <body> <mytag:hello/> </body> </html>
测试工程:https://github.com/easonjim/5_java_example/tree/master/jspbasics/test2