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)前組件的渲染類。