JavaWeb课程系列

4.6  jsp指令

4.6.1 指令简介

1)JSP指令(directive)是为JSP引擎而设计的,它们并不直接产生任何可见输出,而只是告诉引擎如何处理JSP页面中的其余部分。

2)JSP指令的基本语法格式:

       <%@ 指令名 属性名="值" %>

       举例:<%@ page contentType="text/html;charset=gb2312"%>

       注意:属性名部分是大小写敏感的

3)在目前的JSP2.0中,定义了page、include和taglib这三种指令,每种指令中又都定义了一些各自的属性。如果要在一个JSP页面中设置同一条指令的多个属性,可以使用多条指令语句单独设置每个属性,也可以使用同一条指令语句设置该指令的多个属性。

       第一种方式:

                      <%@ page contentType="text/html;charset=gb2312"%>

                      <%@ page import="java.util.Date"%>

       第二种方式:

                      <%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>

4.6.2 page指令和include指令

1)page指令

page指令用于定义JSP页面的各种属性,无论page指令出现在JSP页面中的什么地方,它作用的都是整个JSP页面。为了保持程序的可读性和遵循良好的编程习惯,page指令最好是放在整个JSP页面的起始位置

JSP 2.0规范中定义的page指令的完整语法:

<%@ page

[ language="java" ]

[ extends="package.class" ]

[ import="{package.class | package.*}, ..." ]

[ session="true | false" ]

[ buffer="none | 8kb | sizekb" ]

[ autoFlush="true | false" ]

[ isThreadSafe="true | false" ]

[ info="text" ]

[ errorPage="relative_url" ]

[ isErrorPage="true | false" ]

[contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]

[ pageEncoding="characterSet | ISO-8859-1" ]

[ isELIgnored="true | false" ]

%>

              [1]import属性:指定 JSP 页面转换成 Servlet时应该导入的包。

              [2]pageEncoding属性:设置JSP页面翻译成Servlet源文件时使用的字符集。

              [3]contentType属性:设置 Content-Type 响应报头,标明即将发送到客户程序的文档的 MIME 类型以及浏览器对响应内容的解码字符集。

              [4]errorPage属性:指定当前JSP抛出异常时的转发页面。

              [5]isErrorPage属性:指定当前页面是不是一个显示错误消息的页面,如果是,则会自动创建exception对象,否则就不会创建exception对象。

              [6]session属性:控制页面是否参与HTTP会话,其本质是要不要自动创建session隐含对象以供使用。

              [7]isELIgnored属性:指定当前页面是否忽略EL表达式,如果忽略,EL表达式的内容将会原封不动的输出到浏览器端。

  • include指令

a include指令用于通知JSP引擎在翻译当前JSP页面时将其他文件中的内容合并进当前JSP页面转换成的Servlet源文件中,这种在源文件级别进行引入的方式称之为静态引入,当前JSP页面与静态引入的页面紧密结合为一个Servlet

b)语法:

   <%@ include file="relativeURL"%>

   其中的file属性用于指定被引入文件的相对路径。 

c)细节:

  • 被引入的文件必须遵循JSP语法,其中的内容可以包含静态HTML、JSP脚本元素、JSP指令和JSP行为元素等普通JSP页面所具有的一切内容。
  • 被引入的文件可以使用任意的扩展名,即使其扩展名是html,JSP引擎也会按照处理JSP页面的方式处理它里面的内容,为了见明知意,JSP规范建议使用.jspf(JSP fragments)作为静态引入文件的扩展名。

在将JSP文件翻译成Servlet源文件时,JSP引擎将合并被引入的文件与当前JSP页面中的指令元素(设置pageEncoding属性的page指令除外),所以,除了import和pageEncoding属性之外,page指令的其他属性不能在这两个页面中有不同的设置值。