JSP | 指令详解以及实例

原作者为 RioTian@cnblogs，本作品采用 CC 4.0 BY 进行许可，转载请注明出处。

本篇学习自：C语言中文网，部分内容转载仅供学习使用。

前文

JSP 中有一个关键的知识点：指令;

JSP 指令是为JSP 引擎（比如 Tomcat）而设计的，它们并不直接产生任何可见输出，而只是告诉引擎如何处理 JSP 页面中的其余部分。

而JSP 引擎会根据 JSP 的指令信息来编译 JSP，生成 Java 文件。在生成的 Java 文件中，指令就不存在了。

关于生成的 Java 文件在 Tomcat 文件夹中的 work 子文件夹中查看了。

相关博客：Tomcat 的文件结构

一般都会把 JSP 指令放到 JSP 文件的最上方，但这不是必须的。

指令通常以<%@标记开始，以%>标记结束，它的具体语法如下：

<%@ 指令名称 属性1="属性值1" 属性2="属性值2" ... 属性n="属性值n" %>

JSP 中三大指令，它们分别是 page、include 和 taglib，下表是对它们的简要说明。

JSP 三大指令

指明	说明
page	page 指令用于定义 JSP 页面的各种属性。page 是最复杂的一个指令，它的属性很多，常用的属性有 import、language、pageEncoding 等。
include	静态包含指令，用于引入其它 JSP 文件。使用 include 指令引入的其它 JSP 文件，JSP 引擎将把这两个 JSP 文件翻译成一个 servlet，所以将 include 称为静态包含。
taglib	用于在 JSP 页面中导入标签库（JSP 标准标签库、第三方标签库、自定义标签库）。

Page 指令

page 指令是页面指令，可以定义在整个 JSP 页面范围有效的属性和相关的功能。利用 page 指令，可以指定脚本语言，导入需要的类，指明输出内容的类型，指定处理异常的错误页面，以及指定页面输出缓存的大小，还可以一次设置多个属性。

Page 指令的作用对 JSP 页面全局有效，与其书写位置无关，习惯性放置 JSP 页面最前面。

PS：在 JSP 编译时，自动调整至最前面。

page 指令的属性如下：

<%@ page

[language="java"]

[contentType="mimeType[ ;charset=CHARSET ]"]

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

[info="text"]

[extends="package.class"]

[session="true|false"]

[errorPage="relativeURL"]

[isThreadSafe="true|false"]

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

[autoFlush="true|false"]

[isThreadSafe="true|false"]

[isELIgnored="true|false"]

[page Encoding="CHARSET"]

%>

提示：

语法格式说明中的“[”和“]”符号括起来的内容表示可选项。
可以在一个页面上使用多个 page 指令，其中的属性只能使用一次（import 属性除外）。

JSP page 指令将使用这些属性的默认值来设置 JSP 页面，下面介绍 page 指令的 13 个属性。

(1) language 属性：设置当前页面中编写 JSP 脚本所使用的语言，默认值为 java。

例如：

<%@ page language="java" %>

目前只可以使用 Java 语言。

(2) contenType 属性：设置发送到客户端文档响应报头的 MIME（Multipurpose Internet MailExtention）类型和字符编码，多个值之间用“;”分开。contenType 的用法如下：

<%@ page contenType="MIME 类型; charset=字符编码" %>

MIME 类型被设置为 text/html，如果该属性设置不正确，如设置为 text/css，则客户端浏览器显示 HTML 样式时，不能对 HTML 标识进行解释，而直接显示 HTML 代码。

在 JSP 页面中，默认情况下设置的字符编码为 ISO-8859-1，

即 contentType="text/html;charset=ISO-8859-1"。但一般情况下，应该将该属性设置为

contentType="text/html;charset=utf-8"

此处设置 MIME 类型为 text/html，网页所用字符集为 utf-8。

(3) import 属性：用来导入程序中要用到的包或类，可以有多个值，无论是 Java 核心包中自带的类还是用户自行编写的类，都要在 import 中引入。import 属性的用法如下：

<%@ page import="包名.类名" %>

如果想要导入包里的全部类，可以这样使用：

<%@ page import="包名.*" %>

在 JSP page 指令中，可多次使用该属性来导入多个类。例如：

<%@ page import="包名.类1" %> <%@ page import="包名.类2" %>

或者通过逗号间隔来导入多个类：

<%@ page import="包名.类1,包名.类2" %>

在 JSP 中，已经默认导入了以下包：

java.lang.*,javax.servlet.*,javax.servlet.jsp.*,javax.servlet.http.*

所以，即使没有用 import 属性进行导入，在 JSP 页面中也可以调用上述包中的类。

【例1】显示欢迎信息和用户登录的日期时间。

本例通过导入 java.util.Date 类来显示当前的日期时间。具体步骤如下。

① 使用 page 指令的 import 属性将 java.util.Date 类导入，然后向用户显示欢迎信息，并把当前日期时间显示出来。具体代码如下：

<%@ page import="java.util.Date" language="java" contentType="text/html;charset=utf-8"%><html><body>您好，欢迎光临C语言中文网！<br/>您登录的时间是<%=new Date()  %></body></html>

② 运行该页面，结果如图 1 所示。

(4) info 属性：设置 JSP 页面的相关信息，如当前页面的作者、编写时间等。此值可设置为任意字符串，由 Servlet.getServletInfo() 方法来获取所设置的值。

【例2】设置并显示 JSP 页面的作者等相关信息。

本例通过 page 指令的 info 属性来设置页面的相关信息，通过 Servlet.getServletInfo() 方法来获取所设置的值，具体步骤如下。

① 使用 page 指令的 info 属性设置页面的作者、版本以及编写时间等。具体代码如下：

<%@ page import="java.util.Date" language="java" contentType="text/html;charset=utf-8"%>

<%@ page info="作者：c.biancheng.net <br/> 版本: v1.0 <br/> 编写时间:2018年11月21 星期三 <br/> 敬请关注, 谢谢！"%><html><body><%String str=this.getServletInfo();out.print (str) ;%></body><html>

② 运行该页面，结果如图 2 所示。

(5)extends 属性：指定将 JSP 页面转换为 Servlet 后继承的类。在 JSP 中，通常不会设置该属性，JSP 容器会提供继承的父类。并且，如果设置了该属性，一些改动会影响 JSP 的编译能力。

(6) session 属性：表示当前页面是否支持 session，如果为 false，则在 JSP 页面中不能使用 session 对象以及 scope=session 的 JavaBean 或 EJB。该属性的默认值为 true。

(7) errorPage 属性：用于指定JSP文件的相对路径，在页面出错时，将转到这个 JSP 文件来进行处理。与此相适应，需要将这个 JSP 文件的 isErrorPage 属性设为 true。

设置 errorPage 属性后，JSP 网页中的异常仍然会产生，只不过此时捕捉到的异常将不由当前网页进行处理，而是由 errorPage 属性所指定的网页进行处理。如果该属性值设置为以“/”开头的路径，则错误处理页面在当前应用程序的根目录下；否则在当前页面所在的目录下。

(8) isErrorPage 属性：指示一个页面是否为错误处理页面。设置为 true 时，在这个 JSP 页面中的内置对象 exception 将被定义，其值将被设定为调用此页面的 JSP 页面的错误对象，以处理该页面所产生的错误。

isErrorPage 属性的默认值为 false，此时不能使用内置对象 exception 来处理异常，否则将产生编译错误。

例如，在发生异常的页面上有如下用法：

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

用上面的代码，就可以指明当该 JSP 页面出现异常时，跳转到 error.jsp 去处理异常。而在 error.jsp 中，需要使用下面的语句来说明可以进行错误处理：

<%@ page isErrorPage="true" %>

【例3】页面出现异常的处理。

本例通过 page 指令的 errorPage 和 isErrorPage 两个属性来演示当页面出现异常时应如何处理。具体步骤如下。

① 创建 2-18.jsp 页面，使用 page 指令的 errorPage 属性指定页面出现异常时所转向的页面。具体代码如下：

<%@ page contentType="text/html; charset=utf-8" errorPage="2-18error.jsp" %><html><body><%//此页面如果发生异常，将向2-18error.jsp抛出异常，并令其进行处理int x1=5;int x2=0;int x3=x1/x2;out .print (x3);%></body></html>

该程序执行的是除法运算，如果除数为 0，将会拋出一个数学运算异常，从 errorPage="2-18error.jsp" 可以看出，程序指定 2-18error.jsp 为其处理异常。

② 创建 2-18error.jsp 页面，使用 page 指令的 isErrorPage 属性指定为出错页面，此页面可以使用 exception 异常对象处理错误信息。具体代码如下：

<%@ page contentType="text/html; charset=utf-8" isErrorPage="true" %><html><body>出现错误，错误如下：<br/><hr><%=exception.getMessage() %></body></html>

③ 运行 2-18.jsp 页面，结果如图 3 所示。

提示：

为了确译当页面出错时跳转到 errorPage 所指的页面，需要打开 IE 浏览器，选择“工具”→“Internet 选项”菜单命令，在弹出的对话框中选择“高级”选项卡，取消选中“显示友好 HTTP 错误信息”复选框。

(9) buffer 属性：内置输出流对象 out 负责将服务器的某些信息或运行结果发送到客户端显示，buffer 属性用来指定 out 缓冲区的大小。其值可以是 none、8KB 或是给定的 KB 值。

值为 none 表示没有缓存，直接输出至客户端的浏览器中；如果将该属性指定为数值，则输出缓冲区的大小不应小于该值，默认为 8KB（因不同的服务器而不同，但大多数情况下都为 8KB）。

(10) autoFlush 属性：当缓冲区满时，设置是否自动刷新缓冲区。默认值为 true，表示当缓冲区满时，自动将其中的内容输出到客户端；如果设为 false，则当缓冲区满时会出现 JSP Buffer overflow 溢出异常。

提示：

当 buffer 属性的值设置为 none 时，autoFush 属性的值不能设置为 false。

(11) isThreadSafe 属性：设置 JSP 页面是否可以多线程访问。默认值为 true，表示当前 JSP 页面被转换为 Servlet 后，会以多线程的方式处理来自多个用户的请求；如果设置为 false，则转换后的 Servlet 会实现 SingleThreadMode 接口，并且将以单线程的方式来处理用户请求。

(12) pageEncoding 属性：设置 JSP 页面字符的编码，常见的编码类型有 ISO-8859-1、gb2312、utf-8 和 GBK 等。默认值为 ISO-8859-1。其用法如下：

<%@ page pageEncoding="字符编码" %>

例如：

<%@ page pageEncoding="utf-8" %>

这表示网页使用了 utf-8 编码，与 contentType 属性中的字符编码设置作用相同。

PS：一般 JSP 页面显示内容的编码格式由 contentType 决定，而当页面保存时调用 PageEncoding 的编码保存。

(13) isELIgnored 属性：其值可设置为 true 或 false，表示是否在此 JSP 网页中执行或忽略表达式语言 ${}。设置为 true 时，JSP 容器将忽略表达式语言。

Include 指令

include 指令用于通知 JSP 引擎在翻译当前 JSP 页面时，将其他文件中的内容合并进当前 JSP 页面转换成的 Servlet 源文件中，这种在源文件级别进行引入的方式，称为静态引入，当前 JSP 页面与静态引入的文件紧密结合为一个 Servlet。这些文件可以是 JSP 页面、HTML 页面、文本文件或是一段 Java 代码。其语法格式如下：

<%@ include file="relativeURL|absoluteURL" %>

说明如下：

(1) file 属性指定被包含的文件，不支持任何表达式，例如下面是错误的用法：

<% String f="top.html"; %>

<%@ include file="<%=f %>" %>

(2) 不可以在 file 所指定的文件后接任何参数，如下用法也是错误的：

<%@ include file="top.jsp?name=zyf" %>

(3)如果 file 属性值以“/”开头，将在当前应用程序的根目录下查找文件；如果是以文件名或文件夹名开头，将在当前页面所在的目录下查找文件。

提示：

使用 include 指令是以静态方式包含文件，也就是说，被包含文件将原封不动地插入 JSI 文件中，因此，在所包含的文件中不能使用、标记，否则会因为与原有的 JSP 文件有相同标记而产生错误。另外，因为原文件和被包含文件可以相互访问彼此定义的变量和方法，所以要避免变量和方法在命名上产生冲突。

【例1】使用 include 指令标记静态插入一个文本文件 Hello.txt，并在当前页面同一个 Web 服务目录中显示“很高兴认识你！Nice to meet you.”，具体操作步骤如下。

① Hello.txt 文本文件的代码如下：

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

很高兴认识你!

Nice to meet you.

② 创建 2-19.jsp 页面，具体代码如下：

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

<html><body bgcolor=cyan>

<H3><% include file="Hello.txt" %>

</H3>

</body>

</html>

JSP指令应用实例

编写三个 JSP 页面：first.jsp、second.jsp 和 third.jsp。另外，要求用“记事本”编写一个 hello.txt 文件。

hello.txt 中的每行都有若干个英文单词，这些单词之间用空格分隔，每行之间用
分隔，如下所示：

package apple void back public<br>private throw class hello welcome

实训步骤

(1) first.jsp 的具体要求。

first.jsp 使用 page 指令设置 contentType 属性的值为 text/plain，使用 include 指令静态插入 hello.txt 文件。first.jsp 的代码如下：

<%@ page contentType="text/plain" %>

<html>

<body>

    <font Size=4 color=blue>

    <%@ include file="Hello.txt" %>

</body>

</html>

(2) second.jsp 的具体要求。

second.jsp 使用 page 指令设置 contentType 属性的值为 application/vn.ms-powerpoint，使用 include 指令静态插入 hello.txt 文件。second.jsp 的代码如下：

<%@  page contentType="application/vnd.ms-powerpoint" %>

<html>

<body>

    <font Size=2 color=blue>

    <%@include file="Hello.txt"%>

</font>

</body>

</html>

(3) third.jsp 的具体要求。

third.jsp 使用 page 指令设置 contentType 属性的值为 application/msword，使用 include 指令静态插入 hello.txt 文件。third.jsp 的代码如下：

<%@page contentType="application/msword" %>

<html>

<body>

<font Size=4 color=blue>

<%@include file="Hello.txt"%>

</font>

</body>

</html>