通常当应用程序中所有的页面的某些部分(例如标题、页脚和导航栏)都相同的时候,我们就可以考虑用include。具体在哪些时候用<%@ include file=""%>,哪些时候用<jsp:include page="" flush="true"/>。这种形式。首先要明白的是它们之间的区别。只有了解了它们用法的不同才理解该在何时去用以及如何选择。
两者最重要的区别:JSP指令<%@ include file=""%>,是将被引入的JSP与原JSP融合到一起,而这个融合过程是在翻译阶段进行的。
为什么需要翻译阶段?我们知道,jsp页面并不是原封不动的发送到客户端的,因为浏览JSP页面的客户端并不需要安装Java虚拟机,客户端机器并不能读懂JSP,它能读懂的只有HTML、JavaScript (当然还有其他,例如:Applet、Flex、AxtiveX等等,但那些都需要下载相应的客户端解析器),这样就需要Servlet Engine (例如:Tomcat) 将所有的JSP元素进行处理。这是通过将jsp页面转化成Servlet,然后执行这个Servlet来完成的。服务器需要一个jsp容器来处理jsp页面。jsp容器通常以Servlet的形式实现,这个servlet经过配置,可以处理对jsp页面的所有请求。
JSP容器负责将jsp页面转化成servlet,并编译这个servlet。这两个步骤就构成了翻译阶段。
而jsp翻译之后的servlet输出的内容才是客户端浏览器能够识别的东西,HTML、JavaScript之类的,servlet是使用JspWriter对象输出输出这些HTML、JavaScript的。如果你去翻看翻看jsp编译后的servlet代码,你会发现很有意思的东西,比如Struts的<logic:iterator>标签,被翻译成do{}while()语句实现循环。如果我们把<bean:write>写在<logic:iterator>内部,则在do的内部会出现类似_jspx_meth_bean_write_2(_jspx_th_logic_iterate_0, _jspx_page_context)的方法调用。这些说明了一切。
由此我们知道:jsp页面是把include指令元素(<%@ include file=""%>)所指定的页面的实际内容(也就是代码段)加入到引入它的jsp页面中,合成一个文件后被jsp容器将它转化成servlet。可以看到这时会产生一个临时class文件和一个servlet源文件。而动作元素(<jsp:include page=""/>)是在请求处理阶段引入的,会被JSP容器生成两个临时class文件和两个servlet原文件。而引入的只是servlet的输出结果,即JspWriter对象的输出结果,而不是jsp的源代码。
举个例子:
main.jsp
head.jsp
以head.jsp为例:
1、如果我是用<%@ include file="include/head.jsp"%>引入,注意,head.jsp被我注释掉的字符集和Struts标签的引入,如果打开注释,会怎么样呢??会抛出500异常,/main.jsp(44,4) /include/head.jsp(3,56) Attempt to redefine the prefix html to /WEB-INF/struts-html.tld, when it was already defined as http://struts.apache.org/tags-html in the current scope.这时因为在翻译阶段main.jsp和head.jsp被原封不动的合称为一个jsp,察看Tomcat工作目录只有一个servlet类文件。
\work\Catalina\localhost\IncludeAction\org\apache\jsp\main_jsp.java
\work\Catalina\localhost\IncludeAction\org\apache\jsp\main_jsp.class 试想,在一个类文件中两次引入相同的Struts标签,编译时当然回抛出异常了。
2、那么如果我是以<jsp:include page="include/head.jsp"/>方式引入呢?首先先将head.jap中注释的Struts标签的部分打开,而字符集部分仍然注释。结果出现乱码:
Java代码
什么原因?include动作元素是在请求阶段执行引入的,所以它引入的只是head.jsp被翻译成servlet文件中_jspService这个方法中JspWriter这个对象的输出(out.write()方法的输出流)。该输出的执行是在head.jsp被引入main.jsp之前就进行了,所以main.jsp页面中的字符集设置当然对head.jsp不起作用了。
如果Struts标签部分也注释掉呢?"2004-2006 版权所有"这一行不会输出,因为这一行是由Struts标签输出的,没有输出的原因和字符集相同,我想大家应该明白了。
最后观察Tomcat工作目录下,会有两个Servlet:
第一个:\work\Catalina\localhost\IncludeAction\org\apache\jsp\main_jsp.java
\work\Catalina\localhost\IncludeAction\org\apache\jsp\main_jsp.class
第二个:\work\Catalina\localhost\IncludeAction\org\apache\jsp\include\head_jsp.java
\work\Catalina\localhost\IncludeAction\org\apache\jsp\include\head_jsp.class 另外,如果希望通过修改后缀的方法表示哪些是被引入的文件,例如:将head.jsp改名为head.inc的话,JSP容器不能识别*.inc。所以不能翻译head.inc,所以此时只能使用<%@ include file="head.inc"%>方法引入一个文件了。
我们来总结一下两种include 两种用法的区别,主要有两个方面的不同:
一、执行时间上:
<%@ include file=”relativeURI”%> 是在翻译阶段执行
<jsp:include page=”relativeURI” flush=”true” /> 在请求处理阶段执行。
<%@ include file=”relativeURI”%> 引入静态文本(html,jsp),在JSP页面被转化成servlet之前和它融和到一起。
<jsp:include page=”relativeURI” flush=”true” /> 引入执行页面或servlet所生成的应答文本。