在 JSP 開發中,使用 jsp:include 標簽與 <%@ include 標簽時有一些細節需要特別留意。在我們探討本文主題之前,先來回顧一下二者的區別(就本文而言,兩者在用法上並無差別):
jsp:include:先編譯被包含的 included.jsp 文件,然後再包含(先編譯,後包含)。@ include:先把文件包含進來,然後統一編譯(先包含,後編譯)。某天下午,我想把 jQuery 集成到項目中,卻發現怎麼弄都會出問題,根源就出在路徑上。
當時我的思路是:寫一個公共的 JSP 文件,裡面集中引入一些常用的 js 文件,比如 jQuery 插件。可寫完後發現,單獨測試這個公共 JSP 是完全可以正常使用的,但只要是被其他頁面包含之後,jQuery 就死活用不了。起初我還以為是腳本加載順序的問題。
幾經折騰,終於找到了癥結所在。由於項目文件較多,並非都放在同一個文件夾下。公共 JSP 頁面裡是這樣寫的:
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<script type="text/javascript" src="js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){
alert('hello1');
});
</script>
而在調用它的頁面裡,則是這樣引入的:
<%@ include file="../../common_ext.jsp"%>
問題就出在這裡。include 之後,公共 JSP 被加載到了自己的 JSP 頁面中,此時 jQuery 的相對路徑已經發生了變化。換句話說,公共 JSP 把 jQuery 的相對位置傳給了自己的 JSP,但自己的 JSP 會以自身為基準來解析路徑,於是自然就找不到 jQuery 插件了。
簡單地說,如果使用相對路徑,那麼公共 JSP 中的路徑就應該是相對於它自己所在位置的。但這樣顯然就失去了「公共」的意義,因為它得針對每一個調用它的頁面調整路徑。
為了解決這個問題,這裡採用絕對路徑的方式:
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<%
String tPath = request.getContextPath();
String tBasePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+tPath+"/";
%>
<script type="text/javascript" src="<%=tBasePath%>js/jquery132min.js"></script>
<script type="text/javascript">
$(function(){
alert('hello1');
});
</script>
通過 request.getContextPath() 等方法動態拼出完整的絕對路徑,無論公共 JSP 被哪個頁面包含,都能準確定位到 jQuery 文件。這樣一來,只要在自己的 JSP 頁面中引入公共 JSP 就可以了,不必再為路徑問題頭疼。