jsp:include

整理自网上：

在jsp中include有两种形式：
1. <%@ include file=” ”%>
2. <jsp:include page=” ” flush=”true”/>

前者是指令元素、后者是行为元素。

主要有两个方面区别：

1.执行时间上:

<%@ include file=”relativeURI”%> 是在翻译阶段执行
<jsp:include page=”relativeURI” flush=”true” /> 在请求处理阶段执行.

2.引入内容的不同:

<%@ include file=”relativeURI”%> 引入静态文本(html,jsp),在JSP页面被转化成servlet之前和它融和到一起.
<jsp:include page=”relativeURI” flush=”true” />引入执行页面或servlet所生成的应答文本.
另外在两种用法中file和page属性都被解释为一个相对的URI.如果它以斜杠开头,那么它就是一个环境相关的路径.将根据赋给应用程序的URI的前缀进行解释,如果它不是以斜杠开头,那么就是页面相关的路径,就根据引入这个文件的页面所在的路径进行解释.

通常当应用程序中所有的页面的某些部分（例如标题、页脚和导航栏）都相同的时候，我们就可以考虑用include，即<%@ 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文件。下面举个例子。

举个例子：

date.jsp

1 <%@ page language=”java” c%>
2 <%
3 java.util.Date date=new java.util.Date();
4 String date_cn ="";
5 String dateStr = "";
6 switch(date.getDay())
7 {
8 case 0:date_cn ="日"; break;
9 case 1:date_cn ="一"; break;
10 case 2:date_cn ="二"; break;
11 case 3:date_cn ="三"; break;
12 case 4:date_cn ="四"; break;
13 case 5:date_cn ="五"; break;
14 case 6:date_cn ="六"; break;
15 }
16 dateStr = (1900+date.getYear()) + "年" + (date.getMonth()+1) + "月" + date.getDate() + "日(星期" + date_cn + ")";
17 %>
18 document.write("<%=dateStr%>");

test.jsp

1 <%@ page language=”java” contentType=”text/html;charset=gb2312”%>
2 <html>
3 <head>
4 <title>include的两种用法</title>
5 <jsp:include page=”date.jsp” flush=”true”/>
6 <%--@ include file=”date.jsp” %-->
7 
8 <head>
9 <body>
10 <table><tr><td>
11 
12 </td></tr></table>
13 </body>
14 </html>

1.使用<%@ include file=”date.jsp” %>方式在test.jsp中引入date.jsp：

请求test.jsp，

错误：[HTTP Status 500：contentType重复定义，因为date.jsp原封不动加到了test.jsp]

解决：date.jsp文件中删掉<%@ page language=”java” contentType=”text/html;charset=gb2312”%>

查看tomcat下的临时文件,到那里去看看date.jsp文件的内容是否已被加入到了test.jsp文件中。

在目录下会看到test_jsp.java和test_jsp.class两个文件.

这里的java文件就是jsp容器将jsp转化成了servlet而得到的test_jsp.java。相对应的test_jsp.class这个文件就是编译test_jsp.java这个servlet文件产生的类文件。

2.换用<jsp:include page=”dae.jsp” flush=”true”/>

请求test.jsp：

乱码：[2003? ê 12??10?? 13:30:13 ]

解决：date.jsp文件中加上<%@ page language=”java” contentType=”text/html;charset=gb2312”%>

其实Jsp容器除了负责将jsp页面转化成servlet外,还负责调用jsp页面实现类以处理每个请求并产生应答.这个阶段我们就称为请求处理阶段.请求处理阶段仅执行类文件。

当include行为元素引入页面时,实际只是引用了date.jsp这个文件被转化并被编译后产生的servlet类文件。

所以date.jsp是作为一个单独的文件在执行后才被test.jsp文件运行时调用，由于date.jsp文件中没有指定字符编码.所以出现了乱码。

查看tomcat下的临时文件会发现.此时多出了一个 date_jsp.java文件和一个date_jsp.class文件

再查看一下此时test_jsp.java文件的代码会发现.此时只新增加了一句代码: JspRuntimeLibrary.include(request, response, "date.jsp", out, true);

我们可以指定任何能够产生应答的Web资源,(例如一个servlet或一个jsp页面),只要这些资源所产生的类型和jsp页面产生的内容类型相同.JSP容器将通过一个内部的函数调用来执行指定的资源.因此,这些被引入的资源可以帮助处理原来的请求,所以这些资源可以访问请求作用域内的所有对象.以及所有原来的请求参数.

由于在主页面被请求时,这些页面还没有被引入到主页面中,所以你可以对page属性使用一个请求时属性值,以便根据运行时的情况来决定要引入哪一个页面。还可以添加一些将被引入的页面读取的请求参数.

<jsp:include page=”<%=pageSelectedAtRuntime%>” flush=”true” >
<jsp:param name=”fitstParamer” value=”firstValue”>
<jsp:param name=”lastParamer” value=”lastValue”>
</jsp:include>

如果修改了被引入的jsp页面,那么可以立刻使用该页面的最新版本,这是因为对待被引入的页面的方式与对待由浏览器直接调用的jsp页面的方式完全相同.即容器检测页面的变化,并自动进入翻译阶段,以得到页面的最新版本.