5.2 指令标识

指令标识主要用于设定整个JSP页面范围内都有效的相关信息，它是被服务器解释并执行的，不会产生任何内容输出到网页中。也就是说，指令标识对于客户端浏览器是不可见的。JSP页面的指令标识与我们的身份证类似，虽然公民身份证可以标识公民的身份，但是它并没有对所有见到过我们的人都公开。

JSP指令标识的语法格式如下：

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

参数说明：

指令名：用于指定指令名称，在JSP中包含page、include和taglib 3条指令。

属性：用于指定属性名称，不同的指令包含不同的属性。在一个指令中可以设置多个属性，各属性之间用逗号或空格分隔。

属性值：用于指定属性值。

例如，在应用Eclipse创建JSP文件时，在文件的最底端会默认添加一条指令，用于指定JSP所使用的语言、编码方式等。这条指令的具体代码如下：

        <%@ page language="java" contentType="text/html; charset=GB18030" pageEncoding="GB18030"%>

注意

指令标识的“<%@”和“%>”是完整的标记，不能添加空格，但是标签中定义的属性与指令名之间是有空格的。

5.2.1 page指令

视频讲解：光盘\TM\lx\5\02 page指令．mp4

page是JSP页面最常用的指令，用于定义整个JSP页面的相关属性，这些属性在JSP中被服务器解析成Servlet时会转换为相应的Java程序代码。page指令的语法格式如下：

        <%@ page attr1="value1" attr2="value2" …%>

page指令包含的属性有15个，下面对一些常用的属性进行介绍。

1.language属性

该属性用于设置JSP页面使用的语言，目前只支持Java语言，以后可能会支持其他语言，如C++、C#等。该属性的默认值为Java。

【例5.2】设置JSP页面语言属性，代码如下：

        <%@ page language="java" %>

2.extends属性

该属性用于设置JSP页面继承的Java类，所有JSP页面在执行之前都会被服务器解析成Servlet，而Servlet是由Java类定义的，所以JSP和Servlet都可以继承指定的父类。该属性并不常用，而且有可能影响服务器的性能优化。

3.import属性

该属性用于设置JSP导入的类包。JSP页面可以嵌入Java代码片段，这些Java代码在调用API时需要导入相应的类包。

【例5.3】在JSP页面中导入类包，代码如下：

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

4.pageEncoding属性

该属性用于定义JSP页面的编码格式，也就是指定文件编码。JSP页面中的所有代码都使用该属性指定的字符集，如果该属性值设置为ISO-8859-1，那么这个JSP页面就不支持中文字符。通常设置编码格式为GBK，因为它可以显示简体中文和繁体中文，而MyEclipse默认支持最新的GB18030编码格式，并未提供GBK编码选项。

【例5.4】设置JSP页面编码格式，代码如下：

        <%@ page pageEncoding="GB18030"%>

5.contentType属性

该属性用于设置JSP页面的MIME类型和字符编码，浏览器会据此显示网页内容。

【例5.5】设置JSP页面的MIME类型和字符编码，代码如下：

        <%@ page contentType="text/html; charset=UTF-8"%>

注意

JSP页面的默认编码格式为ISO-8859-1，该编码格式是不支持中文的，想让页面支持中文，需要将页面的编码格式设置成UTF-8或者GBK的形式。

6.session属性

该属性指定JSP页面是否使用HTTP的session会话对象。其属性值是boolean类型，可选值为true和false。默认值为true，表示可以使用session会话对象；如果设置为false，则当前JSP页面将无法使用session会话对象。

【例5.6】设置JSP页面是否使用HTTP的session会话对象，代码如下：

        <%@ page session="false"%>

上述代码设置JSP页面不使用session对象，任何对session对象的引用都会发生错误。

说明

session是JSP的内置对象之一，在后面的章节将会介绍。

7.buffer属性

该属性用于设置JSP的out输出对象使用的缓冲区大小，默认大小为8KB，且单位只能使用KB。建议程序开发人员使用8的倍数16、32、64、128等，作为该属性的属性值。

【例5.7】设置JSP的out输出对象使用的缓冲区大小，代码如下：

        <%@ page buffer="128KB"%>

说明

out对象是JSP的内置对象之一，在后面的章节中将会介绍。

8.autoFlush属性

该属性用于设置JSP页面缓存满时，是否自动刷新缓存。默认值为true，如果设置为false，则缓存被填满时将抛出异常。

【例5.8】设置JSP页面不自动刷新缓存，代码如下：

        <%@ page autoFlush="false"%>

上述代码取消了页面缓存的自动刷新。

9.isErrorPage属性

通过该属性可以将当前JSP页面设置成错误处理页面，以处理另一个JSP页面的错误，也就是异常处理。这意味着当前JSP页面业务的改变。

【例5.9】将当前JSP页面设置成错误处理页面，代码如下：

        <%@ page isErrorPage = "true"%>

10.errorPage属性

该属性用于指定处理当前JSP页面异常错误的另一个JSP页面，指定的JSP错误处理页面必须设置isErrorPage属性为true。errorPage属性的属性值是一个url字符串。

【例5.10】设置处理JSP页面异常错误的页面，代码如下：

        <%@ page errorPage="error/loginErrorPage.jsp"%>

注意

如果设置该属性，那么在web.xml文件中定义的任何错误页面都将被忽略，而优先使用该属性定义的错误处理页面。

5.2.2 include指令

视频讲解：光盘\TM\lx\5\03 include指令．mp4

文件包含指令include是JSP的另一条指令标识。通过该指令可以在一个JSP页面中包含另一个JSP页面。不过该指令是静态包含，也就是说被包含文件中所有内容会被原样包含到该JSP页面中，即使被包含文件中有JSP代码，在包含时也不会被编译执行。使用include指令，最终将生成一个文件，所以在被包含和包含的文件中，不能有相同名称的变量。include指令包含文件的过程如图5.3所示。

图5.3 include指令包含文件的过程

include指令的语法格式如下：

        <%@ include file="path"%>

该指令只有一个file属性，用于指定要包含文件的路径。该路径可以是相对路径，也可以是绝对路径，但不可以是通过<%=%>表达式所代表的文件。

说明

使用include指令包含文件可以大大提高代码的重用性，而且也便于以后的维护和升级。

【例5.11】应用include指令包含网站Banner和版权信息栏。（实例位置：光盘\TM\sl\5\2）

（1）编写一个名称为top.jsp的文件，用于放置网站的Banner信息和导航条。这里将Banner信息和导航栏设计为一张图片。这样完成top.jsp文件，只需要在该页面通过<img>标记引入图片即可。top.jsp文件的代码如下：

        <%@ page pageEncoding="GB18030"%>
        <img src="images/banner.JPG">

（2）编写一个名称为copyright.jsp的文件，用于放置网站的版权信息。copyright.jsp文件的具体代码如下：

        <%@ page pageEncoding="GB18030"%>
        <%
        String copyright="&nbsp; All Copyright&copy;2016 吉林省明日科技有限公司";
        %>
        <table width="778" height="61" border="0" cellpadding="0"
        cellspacing="0" background="images/copyright.JPG">
          <tr>
            <td> <%= copyright %></td>
          </tr>
        </table>

（3）创建一个名称为index.jsp的文件，在该页面中包括top.jsp和copyright.jsp文件，从而实现一个完整的页面。index.jsp文件的具体代码如下：

        <%@ page language="java" contentType="text/html; charset=GB18030" pageEncoding="GB18030"%>
        <html>
        <head>
        <meta http-equiv="Content-Type" content="text/html; charset=GB18030">
        <title>使用文件包含include指令</title>
        </head>
        <body style="margin:0px; ">
        <%@ include file="top.jsp"%>
        <table width="781" height="279" border="0" cellpadding="0" cellspacing="0" background="images/center.JPG">
          <tr>
            <td>&nbsp; </td>
          </tr>
        </table>
        <%@ include file="copyright.jsp"%>
        </body>
        </html>

运行程序，将显示如图5.4所示的效果。

图5.4 包含版权信息页

技巧

在应用include指令进行文件包含时，为了使整个页面的层次结构不发生冲突，建议在被包含页面中将<html>、<body>等标记删除。因为在包含该页面的文件中已经指定这些标记。

5.2.3 taglib指令

视频讲解：光盘\TM\lx\5\04 taglib指令．mp4

在JSP文件中，可以通过taglib指令标识声明该页面中所使用的标签库，同时引用标签库，并指定标签的前缀。在页面中引用标签库后，就可以通过前缀来引用标签库中的标签。taglib指令的语法格式如下：

        <%@ taglib prefix="tagPrefix" uri="tagURI" %>

参数说明：

prefix：用于指定标签的前缀。该前缀不能命名为jsp、jspx、java、javax、sun、servlet和sunw。

uri：用于指定标签库文件的存放位置。

【例5.12】在页面中引用JSTL中的核心标签库。示例代码如下：

        <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

说明

关于引用JSTL中的核心标签库，以及使用JSTL核心标签库中标签的相关内容，请参见第12章，这里不进行详细介绍。

上一章目录下一章