<%@ include file=""%>与<jsp:include page=""/>区别

我们都知道在jsp中include有两种形式,分别是Include指令:<%@ include file=""%>和include动作:<jsp:include page="" flush="true"/>。前者是指令元素、后者是行为元素。具体它们将在何处用?如何用及它们有什么区别?这应该是很多人看到它都会想到的问题。下面一起来看看吧。

通常当应用程序中所有的页面的某些部分(例如标题、页脚和导航栏)都相同的时候,我们就可以考虑用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

<%@ page language="java" pageEncoding="GBK"%>

<%@ taglib uri="http://struts.apache.org/tags-bean" prefix="bean" %>
<%@ taglib uri="http://struts.apache.org/tags-html" prefix="html" %>
<%@ taglib uri="http://struts.apache.org/tags-logic" prefix="logic" %>
<%@ taglib uri="http://struts.apache.org/tags-tiles" prefix="tiles" %>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html:html lang="true">
  <head>
    <html:base />

    <title>index.jsp</title>
    <meta http-equiv="Content-Type" content="text/html; charset=GBK" />
    <meta http-equiv="pragma" content="no-cache">
    <meta http-equiv="cache-control" content="no-cache">
    <meta http-equiv="expires" content="0">    
    <meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
    <meta http-equiv="description" content="This is my page">
    <!--
    <link rel="stylesheet" type="text/css" href="styles.css">
    -->
  </head>

  <body>
    <!-- Header Page Information -->
<%--    <%@ include file="include/head.jsp"%>--%>
    <jsp:include page="include/head.jsp"></jsp:include>
    <!-- Nav Bar -->
<%--    <%@ include file="include/menubar.jsp"%>--%>
    <jsp:include page="include/menubar.jsp"></jsp:include>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
    我是主体<br><br><br>
<%-- <%@ include file="include/copyright.jsp"%> --%>
<%-- <jsp:include page="/includeSample_copyright.do"></jsp:include> --%>
<%--    <jsp:include flush="true" page="include/copyright.jsp"></jsp:include> --%>
  </body>
</html:html>

head.jsp

<%--<%@ page language="java" pageEncoding="GBK"%>--%>

<%--<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>--%>
<%--<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>--%>
<%--<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>--%>

<table>
    <tr>
        <td><bean:message key="copyright.inc.copyright"/>
        我是Head 我是Head我是Head我是Head我是Head我是Head我是Head</td>
    </tr>
</table> 

以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标签,编译时当然回抛出异常了。

  1. 那么如果我是以<jsp:include page="include/head.jsp"/>方式引入呢?首先先将head.jap中注释的Struts标签的部分打开,而字符集部分仍然注释。结果出现乱码:
    结果:
    2004-2006 版权所有 
    ????Head ????Head????Head????Head????Head????Head????Head 
    ????MenuBar     
    我是主体...
    
    什么原因?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所生成的应答文本。
<jsp:include page=”relativeURI?a=1&b=2” flush=”true” />可以携带参数

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。