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

桃扇骨 2021-08-13 19:29 680阅读 0赞

### JSP指令 ###

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

语法格式如下：

<%@ directive attribute="value" %>

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

<table> 
 <thead> 
  <tr> 
   <th align="center">指令</th> 
   <th align="center">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">&lt;%@ page … %&gt;</td> 
   <td align="center">定义网页依赖属性，比如脚本语言，error页面、缓存需求等等</td> 
  </tr> 
  <tr> 
   <td align="center">&lt;%@ include … %&gt;</td> 
   <td align="center">包含其他文件</td> 
  </tr> 
  <tr> 
   <td align="center">&lt;%@ taglib … %&gt;</td> 
   <td align="center">引入标签库的定义</td> 
  </tr> 
 </tbody> 
</table>

##### Page指令 #####

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

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

<%@ page attribute="value" %>

等价的XML格式：

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

**Page指令的常用属性**

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

<%@ 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文件中不可以共享同一个变量，可以定义重名的变量。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70]例子：  
创建两个JSP页面文件date.jsp 和 include.jsp 在include.jsp文件中使用include指令将date.jsp  
文件包含其中，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70 1]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70 2]运行结果：  
![在这里插入图片描述][20190906200324696.png]从图中可以看出，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" />

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70]: /images/20210813/12bb1781f8ce4066bdf50d2692740659.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20190906200248436.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2NvbGRfX19wbGF5_size_16_color_FFFFFF_t_70 2]: /images/20210813/2d747b7a631f49a5b8d4155b030e31d5.png
[20190906200324696.png]: /images/20210813/5453919bab334c3a9f4efa8d2feef9f5.png