---
title: "几个典型的JSP指令及各个指令的含义"
author: "mmdev"
date: "2011-12-08T22:35:00Z"
tags: []
slug: "jsp"
draft: false
lastmod: "2011-12-09T23:38:09Z"
id: 1300599
url: "https://mmdev.iteye.com/blog/1300599"
---

2011-12-08 20:502人阅读[评论](http://blog.csdn.net/mc171799274/article/details/7054849#comments)(0)[收藏](http://blog.csdn.net/mc171799274/article/details/7054849 "收藏")[举报](http://blog.csdn.net/mc171799274/article/details/7054849#report "举报")

一、指令元素(directive elements)：控制所生成的servlet结构。

JSP指令用于“转换阶段”提供整个JSP页面的相关信息，影响由JSP页面生成的Servlet的整体结构。  
指令不会产生任何的输出到当前的输出流中。

1，指令元素语法：  
&lt;%@ directive {attr="value"}* %&gt;  
说明：  
&lt;和% 以及和@，%和&gt;之间不能有任何的空格。  
属性值两边的双引号可以替换为单引号。引号标记不能完全省略。  
在属性中使用引号使用\\进行转义。  
2，指令的xml语法：  
&lt;jsp:directive.directiveType attr="value1" attr="value2" ... /&gt;

在编写XML兼容的jsp页面时，只要不在同一页面中混用xml语法和标准语法，就可以使用指令的xml兼容模式。

3，指令的三种类型：  
page，include，taglib。

二、page指令 : 用于**设置JSP页面的属性**，这些属性将用于和JSP容器通信，控制所生成的servlet结构。

page指令作用整个JSP页面，可以将一个指令放在文档中任何地方。

a，page指令的语法：  
&lt;%@ page attr="value1" attr="value2" ... %&gt;

xml语法格式的page指令：  
&lt;jsp:directive.page attr="value1" attr="value2" ... /&gt;

b，page指令的13个属性

1，import属性：page指令中唯一容许在同一文档出现多次的属性。属性的值可以以逗号隔开。  
指定jsp页面转换成servlet应该输入的包。对于没有明确指定包的类，将根据jsp页面所在的包(生成的servlet的目录)决定类的包的位置。  
这意味着，将在jsp页面所在的包来寻找该类。

**一定要将实用工具类和bean包放在指定的包中。不要依赖于自动导入**。

2，language属性：  
用于指定在脚本元素中使用的脚本语言，默认java。在jsp2.0规范中，只能是java。

3，contentType和pageEncoding属性：  
contentType属性设置**发送到客户端文档的响应报头**的MIME类型和字符编码。多个使用;号分开。  
pageEncodeing属性只用于更改字符编码。

servlet默认MIME是text/plain，jsp默认MIME是text/html。

3，session属性：控制页面是否参与会话

默认true。如果存在已有会话，则预定义session变量，绑定到已有会话中。否则创建新会话将其绑定到session。  
对于高流量网站，设置false可以节省大量服务器内存。  
设置false表示不自动创建新会话，在jsp页面转换为servlet时，这时对变量session的访问导致错误。  
设置为false并不是禁用会话跟踪，它只是阻止jsp页面为不拥有会话的用户创建新会话。

\* 对于不需要会话跟踪的页面那就设置为false；当设置为false时session对象是不可访问的。

4，isELlgnored属性:  
定义在jsp页面中是否执行或忽略EL表达式。true表示忽略，false表示执行。  
默认值依赖于web.xml的版本。servlet2.3之前默认true，servlet2.4默认false。  
用于JSP版本不一致造成使用EL表达式出现的问题。使用:isELlgnored="true";

5，buffer和autoFlush属性：  
buffer属性指定out对象(JspWriter)使用的缓冲区大小，以kb为单位，默认8kb。  
none表示不使用缓冲区。这样要求设置报头或状态代码的jsp元素要出现在文件的顶部，任何HTML内容之前。

autoFlush属性控制当缓冲区满了后，是自动清空输出缓冲区(默认true)，还是在缓冲区溢出后抛出异常(false)。  
在buffer=none的时候，autoFlush=false是错误的。

6，info属性：  
定义一个可以在servlet中通过getServletInfo方法获取的字符串。

jsp容器做的是在servlet中生成getServletInfo方法返回info属性指定的String。

7，errorPage和isErrorPage属性：指定页面专用的错误页面。  
errorPage属性用来指定一个jsp页面，由该页面来处理当前页面中抛出但没有捕获的任何异常。指定的页面可以通过exception变量访问异常信息。  
isErrorPage属性表示当前页是否可以作为其他jsp页面的错误页面。true或false。  
错误页面应该放在WEB-INF目录下面，只让服务器访问，也不会生成转发的调用，客户端只能看到最初的请求页面URL,看不到错误页面的URL。

如果为整个web应用程序指定错误页面，或为应用中不同类型的错误指定错误处理页面，使用web.xml中的error-page元素。

如果一个页面通过该属性定义了专有的错误页面，那么在web.XML文件中定义的任何错误页面不会被使用。

只能够在错误处理页面中使用错误对象exception。

8，isThreadSafe属性：采用显式的同步来代替该方法。  
控制由jsp页面生成的servlet是否允许并发访问(默认true允许)。  
这种阻止并发访问的实现是基于SingleThreadModel接口。所以，避免使用isThreadSafe属性。

9，extends属性：避免使用。这是服务器提供商该做的事情。父类必须是对HttJspPage接口的实现类。而HttJspPage是应用于HTTP协议的请求和响应的JspPage扩展接口。  
指定JSP页面生成的servlet的超类。

三，include指令：在页面转换期间将文件包含到jsp页面。

include指令用于在jsp页面中静态包含一个文件，该文件可以是jsp页面，html页面，文本文件或一段Java代码。  
在主页面“转换为servlet前”将jsp代码插入。被包含的页面发生更改的时候，主页面也要更新（转译）。  
对于文件包含，使用jsp:include。仅在所包含的文件中定义了主页面需要的字段和方法，或者所包含的文件设置了主页面的响应报头时，才使用include指令。

1，include语法：  
&lt;%@ include file="url"%&gt;  
file的属性值被解释为相对于当前jsp文件的URL.

2，在被包含的文件中不要使用和主页重复的HTML标签。这样会影响原jsp文件中同样的标签导致错误。  
因为原文件和被包含文件可以互相访问彼此定义的变量和方法，所以要避免变量和方法在命名上的问题。

3，在jsp中，只有3种功能可以将外部内容包含到JSP文档中。  
a，jsp:include动作

b，include指令

c，jsp:plugin动作

4，include指令：  
服务器将被包含文件内容每字节插入到主页面中，然后将产生的页面作为单个JSP页面进行处理。

5，jsp:include动作：在“请求”期间将其他页面的“输出”包含进来。这样的行为和RequestDispatcher类的include方法完全相同。

优点：包含页面被更改，无需对主页面做修改。  
缺点：被包含页面不能使用任何有可能影响主页面的jsp构造。  
也就是不能将完整的HTML文档作为被包含页面，只能含有适合于出现在文件插入点的HTML标签。

参数(使用jsp:param动作元素增加请求参数)：  
在被包含页面与主页面使用相同的请求对象。可以在被包含页面“看到”主页面的参数，而在主页面“看不到”被包含页面的参数。

a，page属性：指定所包含的页面，应该是指向某种资源的相对URL.  
**相对URL不以/开头，则表示为相对于主页面的位置。以/开头表示相对于WEB应用的根目录。**  
如果由服务器来处理该资源，按相对于当前web应用进行解释；只有浏览器处理该资源时，按相对于服务器的根目录来解释。

对于/开头的URL，服务器总是相对于当前web应用对它进行解释，浏览器总是相对于服务器的根目录来对它进行解释。

可以将要包含的页面放在WEB-INF目录下面，对客户端隐藏。

b，flush属性：指定将页面包含进来之前是否应该清空主页面的输入流(默认false)。

6，include指令和jsp:include动作的区别：  
调用的时间：  
jsp:include动作在“请求期间”被包含。  
include指令在“转换期间”被包含。  
包含的内容：  
jsp:include动作是包含jsp页面或servlet的“输出”和HTML文本。  
include指令是文件的实际内容。

最终转换的servle个数：  
jsp:include动作在请求期间，会将被请求页面转译为独立的servlet。和主页面的servlet对应。  
include指令在转换期间将被包含页面的内容插入到主页面中，得到主页面转译成的servlet。

可否设置影响主页面的响应报头和参数：  
jsp:incurred动作不可以，include指令可以。  
更新：  
jsp:include动作是在请求期间被插入所以他的更改不需要更新主页面。  
include指令的更新意味着主页面servlet的更新。

四，taglib指令：声明用户使用的自定义标签。

声明用户使用自定义的标签，将标签库描述符文件导入到jsp页面。

taglib指令语法：  
&lt;%@ taglib (uri="tigLibURL" 或 tagDir="tagDir") prefix="tagPrefix" %&gt;

uri属性:定位标签库描述符的位置。唯一标识和前缀相关的标签库描述符，可以使用绝对或相对URL。  
tagDir属性：指示前缀将被用于标识在WEV-INF/tags目录下的标签文件。

prefix属性：标签的前缀，区分多个自定义标签。不可以使用保留前缀和空前缀，遵循XML命名空间的命名约定。

一、指令元素(directive elements)：控制所生成的servlet结构。

JSP指令用于“转换阶段”提供整个JSP页面的相关信息，影响由JSP页面生成的Servlet的整体结构。  
指令不会产生任何的输出到当前的输出流中。

1，指令元素语法：  
&lt;%@ directive {attr="value"}* %&gt;  
说明：  
&lt;和% 以及和@，%和&gt;之间不能有任何的空格。  
属性值两边的双引号可以替换为单引号。引号标记不能完全省略。  
在属性中使用引号使用\\进行转义。  
2，指令的xml语法：  
&lt;jsp:directive.directiveType attr="value1" attr="value2" ... /&gt;

在编写XML兼容的jsp页面时，只要不在同一页面中混用xml语法和标准语法，就可以使用指令的xml兼容模式。

3，指令的三种类型：  
page，include，taglib。

二、page指令 : 用于**设置JSP页面的属性**，这些属性将用于和JSP容器通信，控制所生成的servlet结构。

page指令作用整个JSP页面，可以将一个指令放在文档中任何地方。

a，page指令的语法：  
&lt;%@ page attr="value1" attr="value2" ... %&gt;

xml语法格式的page指令：  
&lt;jsp:directive.page attr="value1" attr="value2" ... /&gt;

b，page指令的13个属性

1，import属性：page指令中唯一容许在同一文档出现多次的属性。属性的值可以以逗号隔开。  
指定jsp页面转换成servlet应该输入的包。对于没有明确指定包的类，将根据jsp页面所在的包(生成的servlet的目录)决定类的包的位置。  
这意味着，将在jsp页面所在的包来寻找该类。

**一定要将实用工具类和bean包放在指定的包中。不要依赖于自动导入**。

2，language属性：  
用于指定在脚本元素中使用的脚本语言，默认java。在jsp2.0规范中，只能是java。

3，contentType和pageEncoding属性：  
contentType属性设置**发送到客户端文档的响应报头**的MIME类型和字符编码。多个使用;号分开。  
pageEncodeing属性只用于更改字符编码。

servlet默认MIME是text/plain，jsp默认MIME是text/html。

3，session属性：控制页面是否参与会话

默认true。如果存在已有会话，则预定义session变量，绑定到已有会话中。否则创建新会话将其绑定到session。  
对于高流量网站，设置false可以节省大量服务器内存。  
设置false表示不自动创建新会话，在jsp页面转换为servlet时，这时对变量session的访问导致错误。  
设置为false并不是禁用会话跟踪，它只是阻止jsp页面为不拥有会话的用户创建新会话。

\* 对于不需要会话跟踪的页面那就设置为false；当设置为false时session对象是不可访问的。

4，isELlgnored属性:  
定义在jsp页面中是否执行或忽略EL表达式。true表示忽略，false表示执行。  
默认值依赖于web.xml的版本。servlet2.3之前默认true，servlet2.4默认false。  
用于JSP版本不一致造成使用EL表达式出现的问题。使用:isELlgnored="true";

5，buffer和autoFlush属性：  
buffer属性指定out对象(JspWriter)使用的缓冲区大小，以kb为单位，默认8kb。  
none表示不使用缓冲区。这样要求设置报头或状态代码的jsp元素要出现在文件的顶部，任何HTML内容之前。

autoFlush属性控制当缓冲区满了后，是自动清空输出缓冲区(默认true)，还是在缓冲区溢出后抛出异常(false)。  
在buffer=none的时候，autoFlush=false是错误的。

6，info属性：  
定义一个可以在servlet中通过getServletInfo方法获取的字符串。

jsp容器做的是在servlet中生成getServletInfo方法返回info属性指定的String。

7，errorPage和isErrorPage属性：指定页面专用的错误页面。  
errorPage属性用来指定一个jsp页面，由该页面来处理当前页面中抛出但没有捕获的任何异常。指定的页面可以通过exception变量访问异常信息。  
isErrorPage属性表示当前页是否可以作为其他jsp页面的错误页面。true或false。  
错误页面应该放在WEB-INF目录下面，只让服务器访问，也不会生成转发的调用，客户端只能看到最初的请求页面URL,看不到错误页面的URL。

如果为整个web应用程序指定错误页面，或为应用中不同类型的错误指定错误处理页面，使用web.xml中的error-page元素。

如果一个页面通过该属性定义了专有的错误页面，那么在web.XML文件中定义的任何错误页面不会被使用。

只能够在错误处理页面中使用错误对象exception。

8，isThreadSafe属性：采用显式的同步来代替该方法。  
控制由jsp页面生成的servlet是否允许并发访问(默认true允许)。  
这种阻止并发访问的实现是基于SingleThreadModel接口。所以，避免使用isThreadSafe属性。

9，extends属性：避免使用。这是服务器提供商该做的事情。父类必须是对HttJspPage接口的实现类。而HttJspPage是应用于HTTP协议的请求和响应的JspPage扩展接口。  
指定JSP页面生成的servlet的超类。

三，include指令：在页面转换期间将文件包含到jsp页面。

include指令用于在jsp页面中静态包含一个文件，该文件可以是jsp页面，html页面，文本文件或一段Java代码。  
在主页面“转换为servlet前”将jsp代码插入。被包含的页面发生更改的时候，主页面也要更新（转译）。  
对于文件包含，使用jsp:include。仅在所包含的文件中定义了主页面需要的字段和方法，或者所包含的文件设置了主页面的响应报头时，才使用include指令。

1，include语法：  
&lt;%@ include file="url"%&gt;  
file的属性值被解释为相对于当前jsp文件的URL.

2，在被包含的文件中不要使用和主页重复的HTML标签。这样会影响原jsp文件中同样的标签导致错误。  
因为原文件和被包含文件可以互相访问彼此定义的变量和方法，所以要避免变量和方法在命名上的问题。

3，在jsp中，只有3种功能可以将外部内容包含到JSP文档中。  
a，jsp:include动作

b，include指令

c，jsp:plugin动作

4，include指令：  
服务器将被包含文件内容每字节插入到主页面中，然后将产生的页面作为单个JSP页面进行处理。

5，jsp:include动作：在“请求”期间将其他页面的“输出”包含进来。这样的行为和RequestDispatcher类的include方法完全相同。

优点：包含页面被更改，无需对主页面做修改。  
缺点：被包含页面不能使用任何有可能影响主页面的jsp构造。  
也就是不能将完整的HTML文档作为被包含页面，只能含有适合于出现在文件插入点的HTML标签。

参数(使用jsp:param动作元素增加请求参数)：  
在被包含页面与主页面使用相同的请求对象。可以在被包含页面“看到”主页面的参数，而在主页面“看不到”被包含页面的参数。

a，page属性：指定所包含的页面，应该是指向某种资源的相对URL.  
**相对URL不以/开头，则表示为相对于主页面的位置。以/开头表示相对于WEB应用的根目录。**  
如果由服务器来处理该资源，按相对于当前web应用进行解释；只有浏览器处理该资源时，按相对于服务器的根目录来解释。

对于/开头的URL，服务器总是相对于当前web应用对它进行解释，浏览器总是相对于服务器的根目录来对它进行解释。

可以将要包含的页面放在WEB-INF目录下面，对客户端隐藏。

b，flush属性：指定将页面包含进来之前是否应该清空主页面的输入流(默认false)。

6，include指令和jsp:include动作的区别：  
调用的时间：  
jsp:include动作在“请求期间”被包含。  
include指令在“转换期间”被包含。  
包含的内容：  
jsp:include动作是包含jsp页面或servlet的“输出”和HTML文本。  
include指令是文件的实际内容。

最终转换的servle个数：  
jsp:include动作在请求期间，会将被请求页面转译为独立的servlet。和主页面的servlet对应。  
include指令在转换期间将被包含页面的内容插入到主页面中，得到主页面转译成的servlet。

可否设置影响主页面的响应报头和参数：  
jsp:incurred动作不可以，include指令可以。  
更新：  
jsp:include动作是在请求期间被插入所以他的更改不需要更新主页面。  
include指令的更新意味着主页面servlet的更新。

四，taglib指令：声明用户使用的自定义标签。

声明用户使用自定义的标签，将标签库描述符文件导入到jsp页面。

taglib指令语法：  
&lt;%@ taglib (uri="tigLibURL" 或 tagDir="tagDir") prefix="tagPrefix" %&gt;

uri属性:定位标签库描述符的位置。唯一标识和前缀相关的标签库描述符，可以使用绝对或相对URL。  
tagDir属性：指示前缀将被用于标识在WEV-INF/tags目录下的标签文件。

prefix属性：标签的前缀，区分多个自定义标签。不可以使用保留前缀和空前缀，遵循XML命名空间的命名约定。