JSP 最佳實踐: 用 jsp:include 控制動態內容

時間 2019-11-11

標籤 jsp 最佳實踐 include 控制動態內容欄目 JSP 简体版

原文原文鏈接

在新的 JSP 最佳實踐系列的前一篇文章中，您瞭解瞭如何使用 JSP include 僞指令將諸如頁眉、頁腳和導航組件之類的靜態內容包含到 Web 頁面中。和服務器端包含同樣，JSP include 僞指令容許某個頁面從另外一個頁面提取內容或數據。清單 1 重溫了 include 僞指令。css

清單 1. JSP include 僞指令


<![CDATA[
<%@ page language="java" contentType="text/html" %>
<html>
<head>
      <title>newInstance.com</title>
      <meta http-equiv="Content-Type" 
        content="text/html; charset=iso-8859-1" />
      <link href="/styles/default.css" 
        rel="stylesheet" type="text/css" />
</head>
<body>
<%@ include file="header.jsp" %>
<%@ include file="navigation.jsp" %>
<%@ include file="bookshelf.jsp" %>
<%@ include file="/mt-blogs/index.jsp" %>
<%@ include file="footer.jsp" %>
</body>
</html>
]]>

雖然 include 很是適於將靜態內容併入 Web 頁面，但對於動態內容卻不盡如人意。咱們在前一篇文章中在試圖從新裝入高速緩存文件時發現了這一問題。與大多數頁眉文件及頁腳文件不一樣，動態內容變化頻繁，必須時刻更新。咱們將首先扼要地重述一下 include 僞指令的侷限性，而後我將向您演示如何用 jsp:include 標記來擴展 JSP 的包含能力。java

高速緩存問題

JSP 測試和開發

在構建 Web 應用程序或網站時，可能須要大量更新頁眉、頁腳和導航連接。僅僅爲了看到對所包含文件所作的更改，而被迫不斷地關閉瀏覽器或清除其高速緩存，這多是件痛苦的事情。另外一方面，爲告終束開發週期，而不得不完全檢查一遍並修改數百個使用了 include 僞指令的頁面，這也是一件痛苦的事情。個人建議是，在測試期間禁用瀏覽器高速緩存。在大多數情形下，這樣作可以完全解決問題。也有極少數情形，這樣作並不奏效，這時能夠在瀏覽器或服務器上不斷地從新啓動 Web 容器來確保不進行高速緩存。瀏覽器

可是，有時侯，進行高速緩存會得不償失。若是提入的內容來自使用動態數據（如 Weblog 或數據庫驅動的 JSP 文件）的程序，甚至若是所包含的內容是常常變化的 HTML（如時間戳記），那麼每當裝入 Web 頁面時，都須要顯示這些文件或程序的最新版本。遺憾的是，JSPinclude 僞指令並不具有這一功能。在測試和開發週期（請參閱側欄「 JSP 測試和開發」）中，在瀏覽器中禁用高速緩存一般可以解決這一問題。可是，對於實際使用的應用程序而言，性能是任何設計決策過程當中的一項重要因素，禁用高速緩存並非一種可行的長遠之計。更好的解決方案是使用 jsp:include 標記。緩存

回頁首服務器

jsp:include 標記

jsp:include 只不過是一個不一樣於 include 的僞指令而已。 jsp:include 的優勢在於：它老是會檢查所含文件中的變化。過一下子咱們將研究這一新標記的工做方式。但首先看一下兩種 include 各自的代碼，以便可以看到兩者之間的異同。jsp

清單 2 顯示了一個簡單頁面，它使用了原始的 JSP include 僞指令。編輯器

清單 2. JSP include 僞指令

<![CDATA[
<%@ page language="java" contentType="text/html" %>
<html>
     <head>
      <title>JSP include element test</title>
     </head>
     <body>
      This content is statically in the main JSP file.<br />
      <%@ include file="included.html" %>
     </body>
</html>
]]>

清單 3 是同一個頁面，只不過這裏轉成使用 jsp:include 標記。ide

清單 3. 轉成使用 jsp:include

<![CDATA[
<%@ page language="java" contentType="text/html" %>
<html>
     <head>
      <title>JSP include element test</title>
     </head>
     <body>
      This content is statically in the main JSP file.<br />
      <jsp:include page="included.html" flush="true" />
     </body>
</html>
]]>

您應該注意這兩種代碼類型之間的兩大區別。首先， jsp:include 元素不使用屬於 include 僞指令的 %@ 語法。實際上， jsp 前綴讓 JSP 編譯器知道：它應該尋找標準 JSP 標記集中的元素。其次，指定要包含的文件的屬性從 file 變成了 page 。若是願意，能夠本身測試一下新標記的結果。只需更改上一篇文章（請參閱參考資料）中 included.html 文件的內容，而後從新裝入瀏覽器頁面，就會當即看到新內容。

flush 屬性

您可能已注意到 jsp:include 代碼示例中的 flush 屬性。顧名思義， flush 指示在讀入包含內容以前是否清空任何現有的緩衝區。JSP 1.1 中須要 flush 屬性，所以，若是代碼中不用它，會獲得一個錯誤。可是，在 JSP 1.2 中， flush 屬性缺省爲 false。因爲清空大多數時候不是一個重要的問題，所以，個人建議是：對於 JSP 1.1，將 flush 設置爲 true；而對於 JSP 1.2 及更高版本，將其設置爲關閉。

回頁首

jsp:include 是如何工做的

若是您有點愛刨根問底，那麼可能十分想知道 jsp:include 標記的行爲爲何與 include 僞指令不一樣。道理其實十分簡單： jsp:include 包含的是所包含 URI 的響應，而不是 URI 自己。這意味着：對所指出的 URI 進行解釋，於是包含的是 生成的響應。若是頁面是 HTML，那麼將獲得一點也沒有變化的 HTML。可是，若是是 Perl 腳本、Java servlet 或者 CGI 程序，那麼獲得的將是從該程序解釋而得的結果。雖然頁面一般就是 HTML，但實際程序剛好是達到目的的手段。並且，因爲每次請求頁面的時候都會進行解釋，所以歷來不會象使用 include 僞指令時那樣高速緩存結果。雖然這只是很小的變更，但它卻致使了您所見到的行爲中的所有差別。

回頁首

一種混合搭配的解決方案

include 僞指令在某些網站上有其用武之地。例如，若是站點包含一些（若是有變化，也不多）幾乎沒有變化的頁眉、頁腳和導航文件，那麼基本的 include 僞指令是這些組件的最佳選項。因爲 include 僞指令採用了高速緩存，所以只需放入包含文件一次，其內容就會被高速緩存，其結果會是極大地提升了站點的性能。

然而，對於如今許多 Web 應用程序或站點而言，地毯式的高速緩存並不能解決問題。雖然頁眉和頁腳多是靜態的，可是不可能整個站點都是靜態的。例如，從數據庫提取導航連接是很常見的，而且許多基於 JSP 技術的站點還從其它站點或應用程序上的動態 JSP 頁面提取內容。若是正在處理動態內容，那麼須要採用 jsp:include 來處理該內容。

固然，最好的解決方案是常常把這兩種方法混合搭配使用，將每種構造用到最恰當的地方。清單 4 是混合搭配包含解決方案的一個示例。

清單 4. 混合搭配解決方案

<![CDATA[
<%@ page language="java" contentType="text/html" %>
<html>
<head>
  <title>newInstance.com</title>
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  <link href="/styles/default.css" rel="stylesheet" type="text/css" />
</head>
<body>
<jsp:include page="header.jsp" flush="true">
  <jsp:param name="pageTitle" value="newInstance.com"/>
  <jsp:param name="pageSlogan" value=" " />
</jsp:include>
<%@ include file="/navigation.jsp" %>
<jsp:include page="bookshelf.jsp" flush="true" />
<jsp:include page="/mt-blogs/index.jsp" flush="true" />
<%@ include file="/footer.jsp" %>
</body>
</html>
]]>

上面的代碼顯示了前一篇文章中的示例索引頁面。導航連接和頁腳是靜態內容，一年最多更改一次。對於這些文件，我使用了 include 僞指令。內容窗格包含 Weblog 和「bookshelf」組件，它們是動態生成的。這兩個組件須要一直更新，所以對它們，我使用了 jsp:include 標記。header.jsp 文件有點奇怪。這個組件是從另外一個本質上是靜態的 JSP 頁面提取的。可是，正如您將注意到的那樣，它從包含頁提取頁「標語」，而後將它顯示出來。要處理這一共享信息，咱們必須向頁眉文件傳入參數。而要處理那些參數，就必須使用 jsp:include 元素。