JSP include指令和include动作 详解
原文出处 ：
http://www.cnblogs.com/azai/archive/2009/11/12/1601533.html (好)
http://developer.51cto.com/art/200902/111134.htm
解释一：
include指令是编译阶段的指令，即include所包含的文件的内容是编译的时候插入到JSP文件中，JSP引擎在判断JSP页面未被修改，否则视为已被修改。由于被包含的文件是在编译时才插入的，因此如果只修改了include文件内容，而没有对JSP修改，得到的结构将不会改变，所以直接执行已经存在的字节码文件，而没有重新编译。因此对不经常变化的内容，用include指令是合适的，如果需要的内容是经常变化的，则需要动作元素<jsp:include>.下面将详细区分他们之间的不同
1.include指令
include可以在JSP页面转换成Servlet之前，将JSP代码插入其中。它的主要优点是功能强大，所包含的代码可以含有总体上影响主页面的JSP构造，比如属性、方法的定义和文档类型的设定。它的缺点是难于维护只要被包含的页面发生更改，就得更改主页面，这是因为主页面不会自动地查看被包含的页面是否发生更改。
语法：<%@ include file="sample.jsp" %>
2.include动作
jsp:include动作是在主页面被请求时，将次级页面的输出包含进来。尽管被包含的页面的输出中不能含有JSP，但这些页面可以是其他资源所产生的 结果。服务器按照正常的方式对指向被包含资源的URL进行解释，因而这个URL可以是Servlet或JSP页面。服务器以通常的方式运行被包含的页面， 将产生的输出放到主页面中，这种方式与RequestDispatcher类的include方法一致。它的优点是在被包含的页面发生更改时，无须对主页 面做出修改。它的缺点是所包含的是次级页面的输出，而非次级页面的实际代码，所以在被包含的页面中不能使用任何有可能在整体上影响主页面的JSP构造。
语法： <jsp:include page="sample.jsp" flush="true"> <jsp:param name="name" value="value"/> </jsp:include>
其中参数设置可以没有，如果没有参数设置，则必须采用<jsp:include page="sample.jsp" flush="true"/>形式
3. 使用include动作还是include指令？
使用include指令，如果被包含的文件发生改变，那么，用到它的所有Jsp页面都需要更新。
仅当include动作不能满足要求时，我们才应该使用include指令。
有 些开发人员认为include指令生成的代码执行起来比使用include动作的代码更快。尽管原则上由可能的确如此，但性能上的差异很小，以致难以测 量，同时，include动作在维护上的优势十分巨大，当两种方法都可以使用时，include动作几乎肯定是首选的方法。
对于文件包含，应该尽可能地使用include动作。仅在所包含的文件中定义了主页面要用到的字段或方法，或所包含的文件设置了主页面的响应报头时，才应该使用include指令。
既然include指令产生难以维护的代码，为什么人们还要使用它呢？
因为include指令更为强大。include指令允许所包含的文件中含有影响主页面的Jsp代码，比如响应报头的设置和字段、方法的定义。
例子：//subpage.jsp
<%! int num=0; %>
//mainpage.jsp
<html>
<body>
<%@ include file="subpage.jsp" %>
<%= num %>
</body>
</html>
当然使用include动作时这是不可能的，因为num变量未定义，主页面不能成功的转换成servlet。
解释二：
以下是对include 两种用法的区别，主要有两个方面的不同：
执行时间上：
＜%@ include file=”relativeURI”%＞ 是在翻译阶段执行
＜jsp:include page=”relativeURI” flush=”true” /＞ 在请求处理阶段执行.
引入内容的不同：
＜%@ include file=”relativeURI”%＞引入静态文本(html,jsp),在JSP页面被转化成servlet之前和它融和到一起.
＜jsp:include page=”relativeURI” flush=”true” /＞引入执行页面或servlet所生成的应答文本.
另外在两种用法中file和page属性都被解释为一个相对的URI.如果它以斜杠开头,那么它就是一个环境相关的路径.将根据赋给应用程序的URI的前缀进行解释,如果它不是以斜杠开头,那么就是页面相关的路径,就根据引入这个文件的页面所在的路径进行解释。
我们都知道在JSP中include有两种形式,分别是
＜%@ include file=” ”%＞
＜jsp:include page=” ” flush=”true”/＞
前者是指令元素，后者是动作元素。具体它们将在何处用？如何用及它们有什么区别？这应该是很多人看到它都会想到的问题。下面一起来看看吧。
通常当应用程序中所有的页面的某些部分（例如标题、页脚和导航栏）都相同的时候，我们就可以考虑用include。具体在哪些时候 用＜%@ include file=” ”%＞，哪些时候用＜ jsp:include page=” ” flush=”true”/＞.这种形式。首先要明白的是它们之间的区别。只有了解了它们用法的不同才 理解该在何时去用以及如何选择。
＜%@ include file=” ”%＞,jsp的include指令元素读入指定页面的内容。并把这些内容和原来的页面融合到一起。（这个过程是在翻译阶段:也就是jsp被转化成servlet的阶段进行的。
这里对翻译阶段进行一下说明:我们知道，jsp页面不能原封不动地被传送给浏览器，所有的jsp元素都必须首先由服务器进行处理。这是通过将jsp页面转达化成servlet，然后执行这个servlet来完成的。服务器需要一个jsp容器来处理jsp页面。jsp容器通常以servlet的形式来实现，这个servlet经过配置，可以处理对jsp页面的所有请求。
Jsp容器负责将jsp页面转化成servlet（称为jsp页面实现类?JSP Page implementation class）,并编译这个servlet。这两步就构成了翻译阶段.
由此我们就会知道：jsp页面是把include指令元素所指定的页面的实际内容（也就是代码段）加入到引入它的jsp页面中,合成一个文件后被jsp容器将它转化成servlet。可以看到这时会产生一个临时class文件和一个java文件。下面举个例子。
服务器用tomcat，引入页面的jsp文件叫test.jsp。被引入的页面叫date.jsp.这个jsp文件里存放的是一个有关时间的jsp代码,当前的上下文根设为test
date.jsp的源文件：
＜%@ page language=”java” contentType="text/html;charset=gb2312"%＞
＜%
java.util.Date date=new java.util.Date();
String date_cn ="";
String dateStr = "";
switch(date.getDay())
{
case 0:date_cn ="日"; break;
case 1:date_cn ="一"; break;
case 2:date_cn ="二"; break;
case 3:date_cn ="三"; break;
case 4:date_cn ="四"; break;
case 5:date_cn ="五"; break;
case 6:date_cn ="六"; break;
}
dateStr = (1900+date.getYear()) + "年" + (date.getMonth()+1) + "月" + date.
|
以下是test.jsp的源文件：
＜%@ page language=”java” contentType=”text/html;charset=gb2312”%＞ |
在test.jsp 文件中，我们只输出了一行文本“ 有关jsp中include的两种用法.敬请关注。”,现在让我们先 用＜%@ include file=”date.jsp” %＞这种形式引入date.jsp这个文件。你想会出现什么问题了吗？此时出现 了错误提示：
HTTP Status 500 ?
|
以下还有一堆错误，但我们只要看这里就知道问题的所在了。状态码为http 500服务器内部错误。再看下面的提示。在date.jsp页面中不能指定多个contentType.
原因就在这里了。是因为在翻译阶段,date.jsp文件的代码被原封不动地加入到了test.jsp页面从而合成一个文件。合成后的文件中就会相同的：
＜%@ page language=”java” contentType=”text/html;charset=gb2312”%＞ |
这句代码。解决的办法是把date.jsp文件中的这句删掉，刷新后再请求test.jsp页面。
请求test.jsp在页面显示如下：
2003年12月10日 13:12:40 |
这时我们还不能发现什么。还是去查看tomcat下的临时文件吧。到那里去看看date.jsp文件的内容是否已被加入到了test.jsp文件中。
＜注.此处的tomcat装在E盘根目录下＞
目录
E:\tomcat\work\Standalone\localhost\test.
在这个目录下会看到
test_jsp.java和test_jsp.class两个文件。
这里的java文件就是jsp容器将jsp转化成了servlet而得到的test_jsp.java这个文件。
相对应的test_jsp.class这个文件就是编译test_jsp.java这个servlet文件产生的类文件了。打开所产生的servlet文 件（test_jsp.java）。此时我们会发现，在test.jsp 文件被转化成servlet文件时，在输出的＜haed＞之间加入 了一些不是test.jsp页面里面的代码,新加入的内容就是 date.jsp里面的代码: 新加入了哪些内容或是否真的加入了新的内容请自己测试去看 一下就会一目了然了.在这里不再详述.
以上就是我们用＜%@ include file=”date.jsp”%＞这种形式得到的结果.
下面我们换用＜jsp:include page=”dae.jsp” flush=”true”/＞也就是将＜%@ include file=”date.jsp”%＞换成＜jsp:include page=”dae.jsp” flush=”true”/＞,然后请求test.jsp.
2003? ê 12??10?? 13:30:13 |
此时会在页面上看见.我们所引入date.jsp输出的日期中中文出现了乱码.什么原因?是因为include行为元素是在请求处理阶段执行的(此处要对请求处理阶段进行说明一下，Jsp容器除了上面提到的负责将jsp页面转化成servlet外,还负责调用jsp页面实现类以处理每个请求并产生应答.这个阶段我们就称为请求处理阶段.请求处理阶段仅执行类文件，即翻译过后的servelet类)。
所以在我们作include行为元素引入页面时,实际只是引用了date.jsp这个文件被转化并被编译后产生的servlet类文件.既如此, date.jsp就是作为一个单独的文件在执行后才被test.jsp文件运行时调用.由于date.jsp文件中没有指定字符编码.所以出现了乱 码.解决办法是在date.jsp文件中重新把刚才去掉的
＜%@ page language=”java” contentType=”text/html;charset=gb2312”%＞ |
这行语句加入后刷新重新运行.此时页面显示正确,并跟用include指令正常运行时一样.再查看tomcat下的临时文件会发现.此时多出了一个 date_jsp.java文件和一个date_jsp.class文件.这两个文件得来的方式跟test_jsp.java 和 test_jsp.class文件得来的方式一样.再查看一下此时test_jsp.java文件的代码会发现.此时只新增加了一句代码:
JspRuntimeLibrary.include(request, response, "date.jsp", out, true); |
它并没有把date.jsp文件的代码加入到test.jsp.
只是在运行时引入了date.jsp页面执行后所产生的应答.这意味着我们可以指定任何能够产生应答的Web资源,(例如一个servlet或一个jsp页面),只要这些资源所产生的类型和jsp页面产生的内容类型相同.JSP容器将通过一个内部的函数调用来执行指定的资源.因此,这些被引入的资源可以帮 助处理原来的请求,所以这些资源可以访问请求作用域内的所有对象.以及所有原来的请求参数.及子页面能够通过request请求到主页面中的请求资源。
由于在主页面被请求时,这些页面还没有被引入到主页面中,所以你可以对page属性使用一个请求时属性值,以便根据运行时的情况来决定要引入哪一个页面.还可以添加一些将被引入的页面读取的请求参数.
＜jsp:include page=”＜%=pageSelectedAtRuntime%＞” flush=”true” ＞ |
如果修改了被引入的jsp页面,那么可以立刻使用该页面的最新版本,这是因为对待被引入的页面的方式与对待由浏览器直接调用的jsp页面的方式完全相同.即容器检测页面的变化,并自动进入翻译阶段,以得到页面的最新版本.如果是使用include指令，子页面被改变，主页面不改变的话，容器是检测不到页面变化的。
注意：include动作元素同jsp其它元素一样,没有行为体时要以”/”结束.就像下面这样.＜jsp:include page=”＜%=pageSelectedAtRuntime%＞” flush=”true” /＞
