JSP模板應用指南（上）
2020-07-27 21:53:48
供稿：網友
Window 工具包提供了一種典型的布局機制，比如說在一個容器中確定部件元素的位置。在AWT 和 Swing都有布局管理器，而在VisualWorks Smalltalk中有wrapper。本文將介紹一種JSP模板機制，它允許布局被封裝和重新利用。JSP模板最小化了布局改變所造成的影響，這里我們將鼓勵大家采用封裝模塊化設計。
盡管 Web開發工具的改進非常迅速，但是它們仍然落后于圖形用戶界面(GUI)工具包（Swing 和 VisualWorks Smalltalk）。例如，在傳統的GUI工具包中提供了布局管理器，在一個窗體或另一個窗體中，允許布局運算被封裝和重新利用。本文介紹的這種JSP模板機制，就象布局管理器一樣，可以封裝布局，所以它能夠被重新利用而不只是復制使用。
由于在布局的發展過程中出現了許多的變化，而對功能的封裝是非常重要的一步，它能夠被自如修改而做到對其他應用的影響最小。
JSP沒有提供對封裝布局的直接支持，所以具有統一格式的網頁通常可以復制布局代碼；例如，在圖1中，顯示了一個網頁，它包含了標題、頁腳、工具條以及頁面的主要內容。
圖1.網頁布局 點擊放大(22 KB)
在圖1中顯示的網頁布局將以HTML表格標簽來執行：
例1.包含內容：
<html><head><title>JSPtemplates</title></head>
<body background='graphics/background.jpg'>
<table>
<tr valign='top'><td><%@include file='sidebar.html'%></td>
<td><table>
<tr><td><%@include file='header.html'%></td></tr>
<tr><td><%@include file='introduction.html'%></td></tr>
<tr><td><%@include file='footer.html'%></td></tr>
</table>
</td>
</tr>
</table>
</body></html>
在上面的例子中，包括了JSP include 命令，它允許頁面內容改變――通過改變包含的文件――無須修改網頁自身。不過，由于布局是很難被編碼的，布局改變需要對網頁進行修改。如果一個網站有多個相同格式的頁面，那么一般情況下甚至簡單布局的改變也涉及到整個頁面的修改。
為了減少布局改變所造成的影響，我們需要一種僅僅只包含布局的機制；采用這種機制，布局和內容都可以在不修改文件的情況下分開進行修改。這種機制就是JSP模板。
使用模板
模板是一種JSP文件，它包含了參數化了的內容。這里所討論的模板使用的是一套定制化標簽來執行的：template:get，template:put和template:insert。template:get 標簽訪問參數化的內容，就象在例 2.a中的一樣，它將和圖 1一樣的格式來生成網頁。
例 2.a.一個模板
<%@taglib uri='/WEB-INF/tlds/template.tld' prefix='template' %>
<html><head><title><template:get name='title'/></title></head>
<body background='graphics/background.jpg'>
<table>
<tr valign='top'><td><template:get name='sidebar'/></td>
<td><table>
<tr><td><template:get name='header'/></td></tr>
<tr><td><template:get name='content'/></td></tr>
<tr><td><template:get name='footer'/></td></tr>
</table>
</td>
</tr>
</table>
</body></html>
例 2.a幾乎與例1完全一樣，不過在例2.a中我們使用了template:get 取代了例1中的include 命令.讓我們來分析一下template:get 如何運行。
template:get 使用了一個專門的名字（在請求的范圍內）來對一個Java Bean進行修改。Bean包含了URI (統一資源標志符，網頁的一個組件，它包含在template:get中)。例如，在例 2.a的模板列表中，template:get 獲得了一個URI――header.html――從一個名為header 的Bean中（在請求的范圍內）。接著在template:get 中包含了header.html。
template:put 把Bean放到請求的范圍內（此范圍將在后面被template:get修改）。 模板包含在template:insert中。 例 2.b中舉例說明了put 和 insert 標簽的用法：
例 2.b. 從例2.a中使用模板
<%@taglib uri='/WEB-INF/tlds/template.tld' prefix='template' %>
<template:inserttemplate='/articleTemplate.jsp'>
<template:put name='title' content='Templates' direct='true'/>
<template:put name='header' content='/header.html' />
<template:put name='sidebar' content='/sidebar.jsp' />
<template:put name='content' content='/introduction.html'/>
<template:put name='footer' content='/footer.html' />
</template: insert>
在insert 開頭標簽指定了被包含的模板，在這個例子里，模板在例2.a中。每一個put 標簽在請求范圍內存儲了一個Bean，而在insert 結尾標簽包含了模板。模板接著象上面所描述的那樣訪問Bean。
direct 的屬性能夠為template:put指定；如果direct 設置為true， 和標簽相關聯的內容將不包含在template: get中。
一個網站包含了多頁相同格式的頁面，這樣就可以使用一個模板，比如在例 2.a中列出了一個模板，在許多的JSP網頁（例2.b）中，都用到了這個模板。
使用模板的另一個好處是可以進行模塊化設計。例如，例2.b中列出的JSP 文件中包含了header.html，讓我們再來看下面的例2.c。
例2.c. header.html
<table>
<tr>
<td><img src='graphics/java.jpg'/></td>
<td><img src='graphics/templates.jpg'/></td>
</tr>
</table><hr>
由于header.html 是被包含的內容，所以它不必在需要顯示標頭的頁面中復制其代碼。而且，盡管header.html 是一個HTML文件，但是在文件中并沒有使用一般的起始HTML標簽（比如<html>或<body>），因為這些標簽都將被模板定義。由于在模板中包含了header.html，這些標簽在header.html就可以不必再使用了。
注意：JSP提供了兩種方式來包含內容：靜態方式，使用include命令；動態方式，使用include action。include命令包含了目標頁面的引用源，這和C語言中的#include和Java中的import相似。include action 包含了在運行時間內目標所產生的響應。
與JSP include action一樣，模板包含有動態內容。所以，盡管在例1和例2.b中的JSP網頁在功能上是一致的，但是前面包含的靜態內容被后面動態的包含了。
可選內容
所有的模板內容都是可選的，模板的內容可以很容易的在更多的網頁中使用。例如，在圖 2.a和圖 2.B中顯示了兩個頁面――登錄和清單――它們使用的是同一個模板。兩個頁面中都包含一個標頭、頁腳和主要內容。清單頁面中有一個編輯Panel (這是登陸頁面所缺乏的)用來改變清單。
圖 2.a.一個登陸窗口 點擊放大(24 KB)
圖 2.B.一個清單頁 點擊放大(42 KB)
下面，你會發現模板將被登錄和清單頁面共用：
<%@taglib uri='template.tld' prefix='template' %>
……
<table width='670'>
<tr><td width='60'></td>
<td><template:get name='header'/></td></tr>
<tr><td width='60'></td>
<td><template:get name='main-content'/></td></tr>
<tr><td width='60'></td>
<td><template:get name='editPanel'/></td></tr>
<tr><td width='60'></td>
<td><template:get name='footer'/></td></tr>
</table>
……
清單頁面使用了上面的模板以及專門用于編輯Panel的內容:
<%@taglib uri='template.tld' prefix='template' %>
<%@taglib uri='security.tld' prefix='security' %>
<template:inserttemplate='/template.jsp'>
……
<template:put name='editPanel'
content='/editPanelContent.jsp'/>
……
</template:insert>
與上面相對照，登錄頁面沒有專門用于編輯Panel的內容:
<%@taglib uri='template.tld' prefix='template' %>
<template:inserttemplate='/template.jsp'>
<template:put name='title' content='Login' direct='true'/>
<template:put name='header' content='/header.jsp'/>
<template:put name='main-content'
content='/login.jsp'/>
<template:put name='footer' content='/footer.jsp'/>
</template:insert>
由于登錄頁面中沒有專門用于編輯Panel的內容，所以它沒有包括。
基于Role的內容
Web應用程序常常會基于不同的用戶生成不同的內容。 例如，相同的 JSP模板，只有當用戶為管理員的時候才出現編輯Panel，下面是得出的兩個不同的頁面（如圖3.a和3.b.）
圖 3.a. 管理員的清單頁面 點擊放大(27 KB)
圖 3.b.其他用戶的清單頁面 點擊放大(21 KB)
在圖3.a和3.b中的模板使用了template:get的 role 屬性:
<%@taglib uri='template.tld' prefix='template' %>
......
<table>
......
<td><template:get name='editPanel' role='curator'/></td></tr>
......
</table>
......
get 標簽僅僅在用戶的Role 與Role屬性相匹配的時候才包含內容。讓我們來看看標簽handler是如何使用Role屬性的：
public class GettagextendstagSupport {
private String name = null， role = null;
......
public void setRole(String role) { this.role = role; }
......
public int doStartTag() throws JspException {
......
if(param != null) {
if(roleIsValid()) {
// include or print content ......
}
}
......
}
private boolean roleIsValid() {
return role == null || // valid if role isn't set
((javax.Servlet.http.HttpServletRequest)
pageContext.getRequest()).isUserInRole(role);
}
}
