編寫JSF自定義復(fù)合組件的原則和技巧
介紹
JavaServer Faces(JSF)提供可擴(kuò)展的組件模型,開發(fā)人員可以創(chuàng)建可重用的組件,使用這些自定義組件提高開發(fā)效率和降低開發(fā)成本。雖然對于定制和重用而言 JSF組件模型非常強(qiáng)大,但是開發(fā)人員普遍認(rèn)為開發(fā) JSF 自定義組件并不容易,因?yàn)橥ǔV辽傩枰煜?JSF encode/decode 和 state holder 的內(nèi)部機(jī)制并覆蓋相應(yīng)的方法,如 encodeBegine()、decode()、saveState() 和 restoreState() 等,對于開發(fā)復(fù)雜的自定義組件,甚至需要深入理解更多的接口,如 NamingContainer、StateHolder、EditableValueHolder 和 ActionSource 等接口。
然而,重用 JSF 標(biāo)準(zhǔn)組件的功能可以極大地簡化自定義組件的開發(fā),尤其對于自定義復(fù)合組件更是如此。在大部分情況下,我們可以重用 JSF 框架已經(jīng)提供的標(biāo)準(zhǔn)渲染器、狀態(tài)管理、事件監(jiān)聽器、轉(zhuǎn)換器和驗(yàn)證器。已有的文章或書籍對如何重用這些標(biāo)準(zhǔn)功能涉及很少,本文基于重用的策略提出快速開發(fā) JSF自定義復(fù)合組件的原則和技巧。
本文首先總結(jié)了 JSF組件開發(fā)的通用原則,然后通過一個(gè)例子(Value Scroller 自定義復(fù)合組件)的開發(fā)詳解說明了哪些標(biāo)準(zhǔn)功能可以重用以及如何重用,以達(dá)到簡化 JSF自定義復(fù)合組件開發(fā)的目的。
原則和技巧
開發(fā) JSF自定義復(fù)合組件主要有兩個(gè)原則,一方面強(qiáng)調(diào)重用已有的標(biāo)準(zhǔn)組件;另一方面如何確保自定義組件易于重用。
1、盡可能的重用標(biāo)準(zhǔn)組件的功能和實(shí)現(xiàn)
傳統(tǒng)的自定義復(fù)合組件開發(fā)建議完全覆蓋實(shí)現(xiàn) encode/decode 邏輯,但這樣做耗費(fèi)時(shí)間而且容易出錯(cuò)。毫無疑問,我們可以通過重用標(biāo)準(zhǔn)組件的渲染器等機(jī)制減少甚至根本不用自行編寫這部分代碼。另外,為了實(shí)現(xiàn)靈活的配置和使用,自定義復(fù)合組件通常需要提供很多屬性,我們需要寫很多代碼來處理這些屬性的讀寫和狀態(tài)管理。實(shí)際上,我們可以簡單地把自定義復(fù)合組件的屬性傳遞給它自身包含的標(biāo)準(zhǔn)組件,由已有的標(biāo)準(zhǔn)代碼去處理這些屬性,而不用重復(fù)寫這些代碼。
2、清晰地分離組件類、標(biāo)簽類和模型類
JSF組件模型建議在組件類、標(biāo)簽類和模型類之間有明確清晰的責(zé)任分配,以便于重用和擴(kuò)展。組件類不應(yīng)該依賴于javax.faces.component.html 包,因?yàn)榻M件類不僅可以用于 HTML,而且還應(yīng)該可以重用于其它標(biāo)記語言(如 WML)。也就是說組件類不應(yīng)該直接引用 javax.faces.component.html 包內(nèi)的 HTML 組件。例如,在你的組件類中創(chuàng)建一個(gè) HtmlCommandButton 的實(shí)例是不可取的,你應(yīng)該考慮用 javax.faces.component 包中的 UICommand .另一方面,如果你希望你的模型類可以重用于不同的 Web 框架,那么你的模型類就不應(yīng)該依賴于 JSF 的任何包,即模型類只表示業(yè)務(wù)對象而不包含任何用戶界面相關(guān)的組件、數(shù)據(jù)和狀態(tài)。
基于這些傳統(tǒng)方式和本文介紹的原則和技巧,我們可以發(fā)現(xiàn)基于重用的開發(fā)策略會(huì)極大簡化 JSF自定義復(fù)合組件的編寫。開發(fā) JSF自定義組件通常需要如下 3 個(gè)步驟。
1、擴(kuò)展 UIComponent
傳統(tǒng)方式:創(chuàng)建一個(gè)類,擴(kuò)展 UIComponent,保存組件狀態(tài),在 faces-config.xml 中注冊組件
重用技巧:
◆選擇 UIPanel 作為布局容器,重用標(biāo)準(zhǔn)組件作為復(fù)合組件的子組件。
◆實(shí)現(xiàn)內(nèi)部動(dòng)作監(jiān)聽器。
2、定義渲染器或者內(nèi)聯(lián)實(shí)現(xiàn)它
傳統(tǒng)方式:覆蓋實(shí)現(xiàn) encode/decode,在 faces-config.xml 中注冊渲染器。
重用技巧:重用標(biāo)準(zhǔn)渲染器類型。
3、創(chuàng)建自定義標(biāo)簽,繼承 UIComponentTag
傳統(tǒng)方式:返回渲染器類型和組件類型,設(shè)置 JSF 表達(dá)式屬性
重用技巧:傳遞屬性值給作為子組件的標(biāo)準(zhǔn)組件。
【編輯推薦】