【Java.Web】JSP —— 语法基础 —— 包含include

最新推荐文章于 2022-04-09 23:12:35 发布

王晓斌

最新推荐文章于 2022-04-09 23:12:35 发布

阅读量1.3k

点赞数

分类专栏： Java.Web 文章标签： Java Web

本文链接：https://blog.csdn.net/robinjwong/article/details/39785039

版权

Java.Web 专栏收录该内容

67 篇文章 0 订阅

订阅专栏

在JSP 指令中，可以通过include指令来包含其他文件的方法，include指令的语法为：

<%@ include file="被包含组件的绝对或相对URL" %>

除了使用include指令，还可以使用include标签来包含其他文件，include标签的语法为：

<jsp:include page="被包含的组件的绝对或相对URL" />

include指令用于静态包含；而include标签用于动态包含；

无论是静态包含还是动态包含，源组件和被包含的目标组件都共享请求范围内的共享数据。

静态包含

假设源JSP文件为include_source.jsp，被包含的目标JSP文件为include_destination.jsp。

当客户端请求访问源JSP时，JSP容器按照一下流程响应客户请求：

解析源JSP文件include_source.jsp；在解析<%@ include file="include_destination.jsp" %>时，把目标JSP文件include_destination.jsp的所有的源代码融合到include_source.jsp中。
把融合后的JSP源代码翻译为Servlet源文件，再把它翻译成为Servlet类。
初始化源JSP文件include_source.jsp对应的Servlet，再运行它的服务方法。

由此可见，静态包含发生在解析JSP源组件阶段，被包含的目标文件中的内容被原封不动地添加到JSP源组件中，Servlet容器然后再对JSP源组件进行翻译和编译。

静态包含的目标组件可以为HTML文件或者JSP文件，但不允许为Servlet。

如果目标组件为JSP文件，那么该JSP文件可以访问在源组件中定义的局部变量，因为实际上JSP源组件和JSP目标组件对应的是同一个Servlet。

为了区分JSP源组件及被静态包含的JSP或HTML目标组件，可以将静态包含的JSP文件用“*.jspf”作为文件扩展名，被静态包含的HTML文件用“*.htmf”作为文件扩展名；或者被静态包含的JSP或HTML文件都用“.inc”作为文件扩展名。

示例：

include_source.jsp

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Static Include Source JSP</title>
</head>
<body>
    <%  int var = 1;
        request.setAttribute("username", "New User"); %>
        
    The output is from include_source.jsp before include include_destination.jsp <br/>    
    <%@ include file="include_destination.jsp" %>
    The output is from include_source.jsp after include include_destination.jsp <br/>    
    
</body>
</html>

include_destination.jsp

<p>
    Output is from include_destination.jsp<br/>
    
    var = <%= var %><br/>
    username = <%= request.getAttribute("username") %><br/>
</p>

在浏览器中访问如下URL:

http://localhost:8080/base-webapp/jsp/include_source.jsp

浏览器显示为：

动态包含

将源组件include_source.jsp中的include指令改为：

<%-- 
    <%@ include file="include_destination.jsp" %>
--%>
    <jsp:include page="include_destination.jsp" />

在浏览器中访问上面的URL，将会得到一个编译错误，变量var无法解析。

这是因为对于动态包含，目标组件和源组件分别对应不同的Servlet，两个不同的Servlet之间无法访问对方的服务方法中的局部变量。

在<CATALINA-HOME>/work目录下，会发现对应目标组件的Servlet类未生成对应的class文件：

当客户端首次请求访问源组件include_source.jsp时，JSP容器按照以下流程响应客户请求：

解析include_source.jsp并把它翻译为Servlet源文件，include_source.jsp中的<jsp:include page="include_destination.jsp" />被翻译成如下程序代码：

org.apache.jasper.runtime.JspRuntimeLibrary.include(request, response, "include_destination.jsp", out, false);

把Servlet源文件编译为Servlet类。
初始化与include_source.jsp对应的Servlet，再运行它的服务方法。
当Servlet容器执行上面生成的include方法时，会解析include_destination.jsp。
如果没有语法错误，那么把include_destination.jsp翻译为Servlet源文件，再编译Servlet源文件。假定无编译错误，将生成Servlet类，再初始化该Servlet并调用它的服务方法。

当Servlet容器执行完源JSP组件的include方法后，继续执行源JSP组件后面的代码。

由此可见，动态包含发生在运行JSP源组件阶段，动态包含的目标租金啊可以为HTML文件，JSP文件，或者为Servlet。如股票目标组件为JSP，Servlet容器会在运行JSP源组件的过程中，运行与JSP目标组件对应的Servlet的服务方法。

JSP目标组件生成的响应结果被包含到JSP源组件的响应结果中。

<jsp:include>标签还有一个flush属性，可选值为true和false，如果flush属性为true，就表示源组件在包含目标组件之前，先把已经生成的响应正文提交给客户；flush属性默认为false。

将上面的动态包含语句改为：

<jsp:include page="include_destination.jsp" flush="true" />

再次在浏览器中请求访问该JSP，则浏览器显示为：

而生成的错误将被写到容器的log中。

将目标JSP组件改为：

<p>
    Output is from include_destination.jsp<br/>
    <%--
    var = <%= var %><br/>
    --%>
    
    username = <%= request.getAttribute("username") %><br/>
</p>

再次访问，浏览器显示为：