include指令 - java学习教程_ java培训机构_java编程思想

有时候，需要在JSP页面静态包含一个文件，例如HTML文件，文本文件等，这时，可以通过include指令来实现，include指令的具体语法格式如下所示：

<%@ include file="relativeURL"%>

在上面的语法格式中，file属性用于指定被引入文件的相对路径。

为了大家更好地理解include指令的使用，接下来，通过一个案例来学习include指令的具体用法，如例1所示。

例1 include.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<html>
<head>
<title>欢迎你</title>
</head>
<body>
    欢迎你，现在的时间是：
    <%@ include file="date.jsp"%>
</body>
</html>

在例1中， include指令指向了文件date.jsp，并且该文件与include.jsp位于相同的目录下，date.jsp的具体实现代码如例2所示。

例2 date.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<html>
<head><title>Insert title here</title>
</head>
<body>
<% out.println(new java.util.Date().toLocaleString());%>
</body>
</html>

启动tomcat服务器，在浏览器中访问[http://localhost:8080/chapter07/include.jsp]，浏览器的显示界面如图1所示。

图1 运行结果

从图1中可以看出，date.jsp文件中用于输出当前日期的语句显示了出来，说明include指令成功地将date.jsp文件中的代码合并到了include.jsp文件中。

关于include指令的具体应用，有很多问题需要注意，接下来，将这些问题进行列举，具体如下：

（1）被引入的文件必须遵循JSP语法，其中的内容可以包含静态HTML、JSP脚本元素和JSP指令等普通JSP页面所具有的一切内容。

（2）除了指令元素之外，被引入的文件中的其它元素都被转换成相应的Java源代码，然后插入进当前JSP页面所翻译成的Servlet源文件中，插入位置与include指令在当前JSP页面中的位置保持一致。

（3） file属性的设置值必须使用相对路径，如果以“/”开头，表示相对于当前WEB应用程序的根目录（注意不是站点根目录），否则，表示相对于当前文件。需要注意的是，这里的file属性指定的相对路径是相对于文件（file），而不是相对于页面（page）