JSP--指令（page、include、taglib）详解

JSP指令

为了设置JSP页面中的一些信息，Sun公司提供了JSP指令。JSP2.0 中共定义了page、include、taglib三种指令，每种指令都定义了各自的属性。

语法格式如下：

<%@ directive attribute="value" %>

指令可以有很多个属性，它们以键值对的形式存在，并用逗号隔开。
JSP中三种指令标签：

指令	描述
<%@ page … %>	定义网页依赖属性，比如脚本语言，error页面、缓存需求等等
<%@ include … %>	包含其他文件
<%@ taglib … %>	引入标签库的定义

Page指令

Page指令为容器提供当前页面的使用说明。一个JSP页面可以包含多个page指令。
在JSP页面中，经常需要对页面的某些特性进行描述，例如，页面的编码方式，JSP页面采用的语言等，这时，可以通过page指令来实现。

Page指令的具体语法格式如下所示：

<%@ page attribute="value" %>

等价的XML格式：

<jsp:directive.page attribute="value" />

Page指令的常用属性

属性名称	取值 or 范围	描述
pageEncoding	当前页面	指定页面的编码格式
contentType	有效的文档类型	客户端浏览器根据该属性判断文档类型，例如： HTML格式为 text/html 纯文本格式为 text/plain JPG图像为 image/jpeg GIF图像为 image/gif Word文档为 application/msword
buffer	8kb	jsp缓存大小
autoFlush	true / false	是否自动刷新
errorPage	某个JSP页面的相对路径	指定一个错误页面，如果该JSP程序抛出一个未捕捉的异常，则转到errorPage指定的页面。eooroPage指定页面的isErrorPage属性为true，且内置的exception对象为未捕捉的异常。
isErrorPage	true / false	指定该页面是否为错误处理页面，如果为true，则该JSP内置有一个Exception对象的exception，可直接使用。默认情况下，isErrorPage的值为false
import	任何包名、类名	指定在JSP页面翻译成的Servlet源文件中导入的包或类。import是唯一可以声明多次的page指令属性。一个import属性可以引用多个类，中间用英文逗号隔开
language	java	指明解释该JSP文件时采用的语言，默认为Java
session	true / false	指明该JSP内是否内置Session对象，如果为true，则说明内置Session对象，可以直接使用，否则没有内置Session对象。默认情况下，sessiion属性为true。需要注意的是，JSP引擎自动导入以下4个包： java.lang. javax.servlet. javax.servlet.jsp. javax.servlet.http.

<%@ page language="java" 
		 contentType="text/html; charset=UTF-8"
    	 pageEncoding="UTF-8"
    	 buffer="8kb"
    	 autoFlush="true"
    	 session="true"
    	 errorPage="/error.jsp"
    	 isErrorPage="false"
    	 isThreadSafe="true" %>
<%@ page import="java.io.*" %>

include 指令

在实际开发时，有时需要在JSP页面静态包含一个文件，例如HTML文件，文本文件等，这时，可以通过include指令来实现。
包含的文件就好像是该JSP文件的一部分，会被同时编译执行。

include指令的具体语法格式如下所示：

• 静态包含（jsp include指令）

<%@ include file="被包含的文件相对url地址" %>

• 动态包含（jsp include动作）

<jsp:include page="被包含的文件相对url地址" flush="true/false" %>

区别：

• 静态包含，两个jsp文件会编译成一个java文件，两个jsp文件中可以共享同一个变量，但不能定义重名变量。
• 动态包含，两个jsp文件会生成两个java文件，两个jsp文件中不可以共享同一个变量，可以定义重名的变量。

例子：
创建两个JSP页面文件date.jsp 和 include.jsp 在include.jsp文件中使用include指令将date.jsp
文件包含其中，如下图所示：
运行结果：
从图中可以看出，date.jsp 文件中用于输出当前日期的语句已显示出来，这说明include指令成功的将date.jsp 文件中的代码合并到了include.jsp 文件中。

关于include指令的具体应用，有很多问题需要注意，接下来，将这些问题进行列举，具体如下：

• 被引入的文件必须遵循JSP语法，其中的内容可以包含静态HTML、JSP脚本元素和JSP指令等普通JSP页面具有的一切内容。
• 除了指令元素之外，被引入的文件中的其它元素都被转换成相应的Java源代码，然后插入进当前JSP页面所翻译成的Srvlet源文件中，插入位置与include指令在当前JSP页面中的位置保持一致。

taglib指令

JSP API允许用户自定义标签，一个自定义标签库就是自定义标签的集合。
Taglib指令引入一个自定义标签集合的定义，包括库路径、自定义标签。

Taglib指令的语法：

<%@ taglib uri="uri" prefix="prefixOfTag" %>

uri属性确定标签库的位置，prefix属性指定标签库的前缀。

等价的XML语法：

<jsp:directive.taglib uri="uri" prefix="prefixOfTag" />