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

posted @ 2017-06-05 17:35  EasonJim  阅读(3141)  评论(0编辑  收藏  举报