征服jsf

            BlogJava :: 首頁 :: 新隨筆 :: 聯系 :: 聚合  :: 管理 ::
            6 隨筆 :: 0 文章 :: 27 評論 :: 0 Trackbacks

          2007年11月2日 #

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

          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;

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

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

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

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

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

          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生命周期中組件需要處理的五個重要階段:恢復狀態,解碼,驗證,更新,保持狀態(另外包括調用應用,渲染),開發自定義組件,需要特別關注這些方面,渲染階段由組件的編碼方法實現,調用應用階段則是actionListener監聽器集合的處理期。

          23. protected abstract javax.faces.context.FacesContext getFacesContext() 獲取jsf上下文環境,FacesContext 是一個線程安全模型,在設計上接近pojo,所以在jsf環境對FacesContext的調用得到了簡化,但是jsf整體的編程規則上更希望你能把FacesContext 作為命令參數傳遞給各個實現細節,以保證上下文的真實性,這一點在開發自定義組件上要注意!
          24. protected abstract javax.faces.render.Renderer getRenderer(javax.faces.context.FacesContext context) 獲取當前組件的渲染類。
          posted @ 2007-11-02 16:38 方順 閱讀(3020) | 評論 (0)編輯 收藏

          主站蜘蛛池模板: 山东省| 日喀则市| 万全县| 晋江市| 聊城市| 抚远县| 石城县| 沙洋县| 凤山县| 神池县| 奉贤区| 清流县| 府谷县| 威宁| 石河子市| 昌黎县| 塘沽区| 三江| 邢台县| 论坛| 白银市| 海晏县| 安乡县| 榆社县| 合作市| 崇仁县| 泽州县| 布拖县| 安新县| 荔浦县| 牙克石市| 常德市| 青岛市| 林周县| 巴林右旗| 岳阳市| 西宁市| 星座| 寿阳县| 启东市| 黑河市|