日韩黑丝制服一区视频播放|日韩欧美人妻丝袜视频在线观看|九九影院一级蜜桃|亚洲中文在线导航|青草草视频在线观看|婷婷五月色伊人网站|日本一区二区在线|国产AV一二三四区毛片|正在播放久草视频|亚洲色图精品一区

分享

jsf UIComponent組件接口詳細(xì)注釋說明(jsf1.1規(guī)范) - 征服jsf -...

 chanvy 2009-01-08

UIComponent實(shí)現(xiàn)了StateHolder接口,StateHolder接口表示組件具有了狀態(tài)。
StateHolder接口中常用到saveState,restoreState兩個方法,在開發(fā)自定義組件的時候,需要實(shí)現(xiàn)它們,具體使用上經(jīng)常是把你的組件中全局變量進(jìn)行狀態(tài)化,就是在Object[]中定義它們,jsf在恢復(fù)和保存兩個階段分別調(diào)用組件的這兩個方法,把頁面的狀態(tài)數(shù)據(jù)恢復(fù)在Object[],把組件的Object[]數(shù)據(jù)渲染到頁面。isTransient,setTransient方法表式,你的組件是否想狀態(tài)化。

UIComponent組件主要api
1.public abstract java.util.Map getAttributes()  該方法會獲得該組件的所有屬性值

2. public abstract javax.faces.el.ValueBinding getValueBinding(java.lang.String name) 該方法會從組件的值綁定集合表中獲取對應(yīng)的值綁定對象,值綁定對象(ValueBinding )的目的是使用EL表達(dá)式解析你綁定的模型值,例如頁面有個(#use.name),那么值綁定就會解析這個字符串,通過變量解析獲取User對象,再用值解析獲取name值。

3.public abstract java.lang.String getClientId(javax.faces.context.FacesContext context) 主要是在UIViewRoot組件中生成組件在頁面的映射Id,如果你為組件定義了一個id,那么他會基于這個id生成一個具有組件層次的客戶端Id,使用':'來分隔,如果沒有為組件定義id,那么會動態(tài)生成一個id,例如會在頁面渲染結(jié)果看到'form1:input1'這樣的Id,就是告訴你一個Input組件的id是'input',它在id是'form1'的form組件中。clientId常常在jsf內(nèi)部對組件用來整理,定位。

 4.public abstract java.lang.String getFamily() 告訴你這個組件屬于那個家族的,用的不多。主要是內(nèi)部創(chuàng)建渲染類使用。

5. public abstract java.lang.String getId() 這個Id就是頁面上你指定的組件Id,它可以讓你方便的查找組件樹上的組件,最好給你的頁面組件都設(shè)定一個id,在服務(wù)端開發(fā)有時候會用到,如果沒有設(shè)定,jsf會自動生成一個唯一的id,如果自定義id在組件中有沖突,那么jsf會拋出id沖突異常。

6.public abstract javax.faces.component.UIComponent getParent() 得到該組件的父組件,注意:html標(biāo)記不會成為一個組件。

7. public abstract boolean isRendered() 如果該組件這個方法設(shè)定為false,那么該組件以及它的子組件都會停止解碼,驗(yàn)證,值更新,渲染等操作

8. public abstract java.lang.String getRendererType()  指定了該組件使用哪個渲染類進(jìn)行渲染,這就是組件與渲染分離,并且互相可以復(fù)用的機(jī)制。

9. public abstract boolean getRendersChildren();  如果組件的此方法設(shè)定為真,那么jsf將繼續(xù)尋找它的子組件進(jìn)行渲染。否者渲染只渲染到當(dāng)前組件。

10. public abstract java.util.List getChildren(); 獲得該組件的直屬子組件列表

11. public abstract int getChildCount() 獲得獲得該組件的直屬子組件列表數(shù)

12.public abstract javax.faces.component.UIComponent findComponent(java.lang.String expr) 尋找該組件的子組件,通過頁面上指定的組件Id,在它的父組件的findComponent去查找這個組件,一般用于自定義組件開發(fā)上,例如:jsf消息渲染的時候就是通過findComponent方法去尋找for屬性定義的組件。

13.public abstract java.util.Map getFacets() 得到該組件的所有facet類型的組件,facet組件主要作用:一個功能強(qiáng)大的組件中會有很多增強(qiáng)功能,這些增強(qiáng)功能可以定義成多個小的facet組件,這樣可以從組件的主功能中分解開,降低組件內(nèi)部功能的耦合性,同時也可以做為組件的插件機(jī)制來擴(kuò)展。

14.public abstract java.util.Iterator getFacetsAndChildren() 獲取自己所以的直屬子組件和facet組件,常用在子組件查找操作上,例如jsf核心機(jī)制中,遍歷組件增加事件時就要遞歸使用此方法。

15.    public abstract void broadcast(javax.faces.event.FacesEvent event) 對于jsf生命周期的幾個階段都會用到遞歸遍歷組件的事件,使用的就是這個方法,常用在內(nèi)部機(jī)制上。標(biāo)準(zhǔn)的觀察者模式。

16.    public abstract void decode(javax.faces.context.FacesContext context) jsf聲明周期中的解碼部分就是調(diào)用此方法,主要用在應(yīng)用請求值階段,通過遞歸遍歷,每一個組件會在這個階段操作request等容器對象來實(shí)現(xiàn)并隱藏request請求的表現(xiàn)邏輯,并封裝成事件交給組件的事件列表,由后面的階段來處理。需要注意的是很可能此方法會把工作委托給渲染類的decode上,所以jsf的渲染機(jī)制不僅僅是簡單的輸出html等展現(xiàn)標(biāo)記,還用來封裝和隱藏容器內(nèi)的通信機(jī)制,讓容器內(nèi)對象從我們眼前消失!

17. 

    public abstract void encodeBegin(javax.faces.context.FacesContext context)
            throws java.io.IOException;

    public abstract void encodeChildren(javax.faces.context.FacesContext context)
            throws java.io.IOException;

    public abstract void encodeEnd(javax.faces.context.FacesContext context)
            throws java.io.IOException;

組件渲染階段需要經(jīng)歷的步驟,渲染機(jī)制是一個復(fù)雜的過程,原理上是把tag標(biāo)記渲染的工作委托給了servlet之上來處理,jsf 的tag標(biāo)記只作為組件,視圖之間的映射之用。這三個階段更明確了渲染成視圖標(biāo)記這樣一個工作,同樣可以委托給渲染類去做。

 18.protected abstract void addFacesListener(javax.faces.event.FacesListener listener) 為組件增加監(jiān)聽,標(biāo)準(zhǔn)的觀察者模式。

19.protected abstract javax.faces.event.FacesListener[] getFacesListeners(java.lang.Class clazz) 得到組件的監(jiān)聽列表,監(jiān)聽器在組件的事件列表遍歷時會被調(diào)用,clazz參數(shù)是用來區(qū)分不同的監(jiān)聽器,目前常用ActionListener.class,ValueChangeListener.class

20.protected abstract void removeFacesListener(javax.faces.event.FacesListener listener);從組件的監(jiān)聽列表中刪除不需要的監(jiān)聽器。

21.public abstract void queueEvent(javax.faces.event.FacesEvent event) 把新創(chuàng)建的事件增加到組件的事件隊(duì)列,此方法常常用在應(yīng)用請求值階段,每個組件會根據(jù)條件創(chuàng)建自己的事件,加入到事件列表,所有事件會全局的放入U(xiǎn)IViewRoot組件中,UIViewRoot組件是jsf各個階段對組件樹進(jìn)行遞歸遍歷處理的啟動點(diǎn)。

22.

   public abstract void processRestoreState(javax.faces.context.FacesContext context,
                                             java.lang.Object state);

    public abstract void processDecodes(javax.faces.context.FacesContext context);

    public abstract void processValidators(javax.faces.context.FacesContext context);

    public abstract void processUpdates(javax.faces.context.FacesContext context);

    public abstract java.lang.Object processSaveState(javax.faces.context.FacesContext context);

    jsf生命周期中組件需要處理的五個重要階段:恢復(fù)狀態(tài),解碼,驗(yàn)證,更新,保持狀態(tài)(另外包括調(diào)用應(yīng)用,渲染),開發(fā)自定義組件,需要特別關(guān)注這些方面,渲染階段由組件的編碼方法實(shí)現(xiàn),調(diào)用應(yīng)用階段則是actionListener監(jiān)聽器集合的處理期。

23. protected abstract javax.faces.context.FacesContext getFacesContext() 獲取jsf上下文環(huán)境,F(xiàn)acesContext 是一個線程安全模型,在設(shè)計(jì)上接近pojo,所以在jsf環(huán)境對FacesContext的調(diào)用得到了簡化,但是jsf整體的編程規(guī)則上更希望你能把FacesContext 作為命令參數(shù)傳遞給各個實(shí)現(xiàn)細(xì)節(jié),以保證上下文的真實(shí)性,這一點(diǎn)在開發(fā)自定義組件上要注意!
24. protected abstract javax.faces.render.Renderer getRenderer(javax.faces.context.FacesContext context) 獲取當(dāng)前組件的渲染類。

    本站是提供個人知識管理的網(wǎng)絡(luò)存儲空間,所有內(nèi)容均由用戶發(fā)布,不代表本站觀點(diǎn)。請注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購買等信息,謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請點(diǎn)擊一鍵舉報(bào)。
    轉(zhuǎn)藏 分享 獻(xiàn)花(0

    0條評論

    發(fā)表

    請遵守用戶 評論公約

    類似文章 更多