開發自己的jsf組件并不是一件容易的事情,因為jsf組件對于應用程序員來說還是過于復雜跟耗費時間了。開發不依賴于具體實現jsf-api的第三方jar包的組件就更不容易了,要做的工作比較的多.本例參照了一個jsf1.1組件的開源跟jsf1.2-RI的源碼,理論上應該是可以通用的組件,并且是一個實用的基于jsf1.2的日歷組件。.因為源碼太長,不方便在這里一一貼出來,只好簡略介紹一下各個類的功能,及一些配置了,感興趣的朋友可以從附件里下載.如果要用在別的地方可以自己打個jar包.jsf自定義組件至少需要三個類:
處理標簽屬性的類com.sun.faces.metal.MetalCalendarTag,維護狀態處理輸入的類com.sun.faces.metal.MetalCalendar和一個外部呈現器類com.sun.faces.metal.MetalCalendarRenderer(其中addRequiredMessage(FacesContext context, MetalCalendar cal)之類的方法很有趣,定義了<h:message> 標簽的一些類容),這里著重說明一下標簽處理類,因為jsf1.2跟jsf1.1的實現有些不一樣,原因是jsf1.2使用了統一的EL語言。
Jsf1.2中所有的自定義標簽的屬性都是一個javax.el.ValueExpression的實例,所有的方法綁定都是一個javax.el.MethodExpression的實例,不再需要去創建一個ValueBinding和MethodBiding.關于這一點可以參考網上的jsf1.2新特性的文檔。com.sun.faces.metal.HtmlBasicRenderer類很干脆,直接從jsf1.2-RI中copy過來略加改動,是com.sun.faces.metal.MetalCalendarRenderer的超類。
com.sun.faces.metal.metl. StaticResourcePhaseListener類一個事件監聽類,它的作用是把一些js,css,圖像文件等輸出到客戶端,以定制組件的外觀,而不是在呈現器類中通過writerAttribute(“img”,”tt.gif”,”img”)之類的通過圖象的URL去定位這個文件。這樣的目的只有一個,就是文件打成jar包,以便供第三方使用。
com.sun.faces.metal.util.FacesMessage類很也很干脆從javax.faces.application.FacesMessage類繼承而來,實際上只是為了改變下一FACES_MESSAGES 屬性,使之看起來像這樣public static final String FACES_MESSAGES = "com.sun.faces.metal.util.Messages"; com.sun.faces.metal.util包中有兩個Messages.properties屬性文件,一個是針對中文的.
com.sun.faces.metal.util.FacesMessageFactory類也只是從jsf1.2-ri包中復制過來的.這樣我們就可以完全不依賴jsf-api的實現而定義了自己的message屬性.
剩下的就是一些輔助類了,也還算容易看的懂.
原本應該很庸長的一些敘述在這里極度濃縮了,簡直就是沒法理解的,好在如果有自定義jsf組件的基礎,源碼也應該還看得懂.
源碼下載