JSP模板應用指南（上）

2024-09-05 00:19:27

字體：大中小

來源：轉載

供稿：網友

菜鳥學堂：

使用jsp模板來封裝網頁布局

　　window 工具包提供了一種典型的布局機制，比如說在一個容器中確定部件元素的位置。在awt 和 swing都有布局管理器，而在visualworks smalltalk中有wrapper。本文將介紹一種jsp模板機制，它允許布局被封裝和重新利用。jsp模板最小化了布局改變所造成的影響，這里我們將鼓勵大家采用封裝模塊化設計。

　　盡管工具的改進非常迅速，但是它們仍然落后于圖形用戶界面(gui)工具包（swing 和 visualworks smalltalk）。例如，在傳統的gui工具包中提供了布局管理器，在一個窗體或另一個窗體中，允許布局運算被封裝和重新利用。本文介紹的這種jsp模板機制，就象布局管理器一樣，可以封裝布局，所以它能夠被重新利用而不只是復制使用。

　　由于在布局的發展過程中出現了許多的變化，而對功能的封裝是非常重要的一步，它能夠被自如修改而做到對其他應用的影響最小。

　　jsp沒有提供對封裝布局的直接支持，所以具有統一格式的網頁通?？梢詮椭撇季执a；例如，在圖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='http://www.pushad.com/info/graphics/java.jpg'/></td>

　　　　 <td><img src='http://www.pushad.com/info/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);

　　 }

　　}