金蝶BOSWeb框架金蝶軟件（中國）有限公司資冰冰目錄總體架構JSFFaceletsExtAOMWAFWeb開發(fā)調(diào)試總體架構金蝶開發(fā)平臺基于aom開發(fā)，aom的底層技術為JSF，表現(xiàn)層采用ext和FaceletsJSF是什么JavaServerFaces(JSF,或者“Faces”)是一個構建JavaWeb應用的UI框架；它基于Java社區(qū)流程(JCP)開發(fā)，并且成為J2EE的一個組成部分。Faces的一個主要目標是為JavaWeb應用開發(fā)領域帶來RAD風格的應用開發(fā)，就像MicrosoftVisualBasic和BorlandDelphi一樣。JSF提供一系列標準部件(按鈕、超鏈接、復選框等等)，一個創(chuàng)建定制組件的模型，以及在服務器端處理客戶端產(chǎn)生事件的方式，并且有良好的工具支持。你可以同步UI組件和相關對象的值，而不必編輯太多令人生厭的代碼。所有的JSF應用都構建于ServletAPI之上，使用HTTP進行通信，并且使用JSP.之類的顯示技術JSF與Struts區(qū)別JSF包含什么JSF生命周期JSF生命周期構建復原組件樹視圖（RestoreViewPhase）JSF組件樹用來構建和維護頁的狀態(tài)和事件。對于每個會話，將會構建一次樹，并且當用戶返回到該頁時復用該樹。在此階段的末尾，當前請求的FacesContext實例的根屬性反映由先前的“Faces響應”生成的視圖的已保存配置（如果有的話）。JSF生命周期應用請求值請求處理生命周期這一階段的目的是使當前請求中包括的信息更新各組件的當前值（如參數(shù)、標題和cookie）更新到相應組件樹中的每個組件。從這里我們可以看到，從客戶端發(fā)過來的請求是么種意義上的純文本信息，而UI組件對應的是java實體，這里必然就存在了數(shù)據(jù)格式轉(zhuǎn)換的問題。所以，在整個生命周期中，這個地方就成了數(shù)據(jù)轉(zhuǎn)換發(fā)生的特定階段（如：數(shù)據(jù)、日期顯示格式）。JSF生命周期處理驗證為保證上一個階段的數(shù)據(jù)正確，特定抽取了這個階段作為數(shù)據(jù)校驗。在這里作為創(chuàng)建此請求的視圖的一部分，可以為每個組件注冊零個或多個驗證器實例。另外，組件類自身也可以在它們的validate()方法中實現(xiàn)驗證邏輯。在此階段的末尾，會完成所有配置的驗證。JSF生命周期更新模型值如果到達了請求處理生命周期的這一階段，就意味著入局請求根據(jù)所執(zhí)行的驗證在語法和語義上都是有效的，且組件樹中每一組件的本地值都已被更新，這一階段主要通過調(diào)用組建樹的每個UI組件的processUpdates（）方法，遞歸更新每個組件樹對應的應用程序的模型數(shù)據(jù)JSF生命周期調(diào)用應用程序如之前構建復原視圖時所述，如果當前請求的視圖是根據(jù)先前請求保存的狀態(tài)信息重新構造的，則JSF實現(xiàn)就能夠確保通過在此Web應用程序的“應用程序”對象上調(diào)用getActionListener。JSF生命周期呈現(xiàn)響應此階段同時完成兩項任務：使響應呈示給客戶機，以及使響應的狀態(tài)得到保存以供后續(xù)請求處理之用。在一個階段中同時處理這兩項任務的原因是在JSP應用程序中呈示響應的行為會導致在呈示頁面時構建視圖。因此，要在視圖的狀態(tài)被呈示給客戶機之后才能保存該狀態(tài)。為什么要選用JSF對于RAD工具的四個層次，JavaServerFaces定義了其中3個：一個基礎組件架構，一個標準的UI部件集，以及一個應用基礎架構。JSF的組件架構定義了一個通用的方式來建立UI部件JavaServerFaces有一個特定的目標：使web開發(fā)更快更容易。它允許開發(fā)人員以組件，事件，BackingBean以及它們之間的交互來進行思考，而不是基于請求，響應和標記。換句話說，它掩蓋了Web開發(fā)的大量的復雜性，使開發(fā)人員能夠集中于他們最擅長的事情：開發(fā)應用系統(tǒng)。典型例子Hello，worldFaceletsFacelets非常適合JSF，專為JSF設計的視圖技術Facelets是用來建立JSF應用程序時的一個可供選擇的表現(xiàn)層技術。Facelets提供了一個強有力的模板化系統(tǒng)，讓你使用HTML樣式的模板來定義JSF的表現(xiàn)層，減少了組件整合進表現(xiàn)層時候冗余的代碼，而不需要一個web容器FaceletsFacelets有以下吸引人的特性：模板化（像Tiles）復合組件定制的邏輯標記表達式語言對設計師友好的頁面開發(fā)創(chuàng)建組件庫用Facelets進行模板化（定義模版）創(chuàng)建layout.xhtml頁面。定義Facelet的命名空間，導入對Facelets的使用。用ui:insert標記定義頁面的邏輯區(qū)域。用純文本和ui:include標記定義合理的默認值用Facelets進行模板化（使用模版）當頁面調(diào)用布局模板時，需要指定模板的位置使用ui:composition標記。為了把參數(shù)傳遞給模板，要使用ui:define標記，它是ui:composition標記的子元素復合組件不要重復自己

Facelets把它的精華放在復合組件上復合組件的創(chuàng)建創(chuàng)建Facelets標記庫。在web.xml中聲明標記庫。用命名空間導入標記文件ExtJsExtJS可以用來開發(fā)RIA也即富客戶端的AJAX應用，是一個用javascript寫的，主要用于創(chuàng)建前端用戶界面，是一個與后臺技術無關的前端ajax框架。因此，可以把ExtJS用在.Net、Java、Php等各種開發(fā)語言開發(fā)的應用中ExtJS由一系列的類庫組成，一旦頁面成功加載了ExtJS庫后，我們就可以在頁面中通過javascript調(diào)用ExtJS的類及控件來實現(xiàn)需要的功能EXTJSExtJS的類庫由以下幾部分組成底層API(core)：底層API中提供了對DOM操作、查詢的封裝、事件處理、DOM查詢器等基礎的功能。其它控件都是建立在這些底層api的基礎上，底層api位于源代碼目錄的core子目錄中，包括DomHelper.js、Element.js等文件Extjs控件(widgets)：控件是指可以直接在頁面中創(chuàng)建的可視化組件，比如面板、選項板、表格、樹、窗口、菜單、工具欄、按鈕等等，在我們的應用程序中可以直接通過應用這些控件來實現(xiàn)友好、交互性強的應用程序的UI?？丶挥谠创a目錄的widgets子目錄中ExtJs實用工具Utils：Ext提供了很多的實用工具，可以方便我們實現(xiàn)如數(shù)據(jù)內(nèi)容格式化、JSON數(shù)據(jù)解碼或反解碼、對Date、Array、發(fā)送Ajax請求、Cookie管理、CSS管理等擴展等功能ExtJs組件Ext組件是由Component類定義，每一種組件都有一個指定的xtype屬性值，通過該值可以得到一個組件的類型或者是定義一個指定類型的組件。組件體系ExtJs組件使用組件可以直接通過new關鍵子來創(chuàng)建，比如控件一個窗口，使用newExt.Window()，創(chuàng)建一個表格則使用newExt.GridPanel()組件的構造函數(shù)中一般都可以包含一個對象，這個對象包含創(chuàng)建組件所需要的配置屬性及值，組件根據(jù)構造函數(shù)中的參數(shù)屬性值來初始化組件ExtJs組件每一個組件除了繼承基類中的配置屬性以外，還會根據(jù)需要增加自己的配置屬性，另外子類中有的時候還會把父類的一些配置屬性的含義及用途重新定義。學習及使用ExtJS，其中最關鍵的是掌握ExtJS中的各個組件的配置屬性及具體的含義/deploy/dev/docs/AOMAOM：ApusicOperaMask，金蝶中間件公司的Web開發(fā)框架AOM完整實現(xiàn)了JSF1.2規(guī)范，同時，對JSF1.2規(guī)范做了大量擴充，主要有AJAX支持、IoVC編程模型AOM架構圖AOM對Web組件的擴展標準的JSF提供了與HTML元素一一對應的Web組件，標準的JSFWeb組件基本上不能滿足業(yè)務開發(fā)要求AOM在此基礎上提供了一套基于ExtJS的RichComponents，根據(jù)ExtJS所提供的客戶端組件模型，提供了相應的服務器端組件模型、事件和組件渲染器，服務器端組件模型可以被復用，與具體的組件表現(xiàn)形式無關。而組件的渲染器可以自行以替換的方式進行擴展AOM對Web組件的擴展組件使用方式<w:textFieldbinding="#{***ListBean.number}"value=""/><w:buttonid=“btnAddNew”value=“新增" actionBinding="#{***ListBean.addNewAction}"/>通過指定控件屬性jsvar,可以用extjsapi在頁面訪問/help/index.jsp?topic=/org.operamasks.docs/output/eclipse/index.htmlAOM約定優(yōu)于配置目前主流的一些框架如（Struts和spring）通過很多配置實現(xiàn)對象的依賴注入AOM中通過約定優(yōu)于配置的規(guī)則，實現(xiàn)對象的注入AOM數(shù)據(jù)校驗簡單校驗Annotation：@Required客戶端校驗<w:formid=“form1"clientValidate="true">自定義校驗完整上下文校驗

AOMJSF生命周期攔截默認提供@BeforePhase、@AfterPhase的標注式攔截其他生命周期可擴展AOMMBean編程模型AOM對標準JSF的ManagedBean進行了擴展：聲明式定義ManagedBeanAOM提供了@ManagedBean、@ManagedProperty等一系列標簽，可以使用這些標簽來以聲明方式定義ManagedBean通過@Inject注入其他ManagedBean

AOMIOVCIoVC——“InversionofView-Control”，即“視圖控制反轉(zhuǎn)”傳統(tǒng)的JSF編程模式傳統(tǒng)方式的JSF設計中，UI所展現(xiàn)出來的數(shù)據(jù)通常位于ManagedBean中，UI上需要與用戶交互的行為（Action）也定義在ManagedBean中，在UI中通過EL表達式，將每個組件與ManagedBean中所持有的數(shù)據(jù)綁定起來。如：<h:outputTextvalue="#{DemoBean.clickText}"/><h:commandButtonaction="#{DemoBean.action}"/>這是以視圖為控制導向的一種設計模式，視圖必須知道其所要綁定的ManagedBean及其屬性和行為，這在一定程度上限制了UI的重用。AOMIOVCIoVC定義了一系列的標注用于將Model與View上的元素對應，開發(fā)者通過在Model上聲明這種對應關系，可以將視圖上的元素與Model中的屬性和方法對應起來在IoVC編程模式下，組件只需簡單的聲明id屬性即可與Model進行關聯(lián)WAFWAFwebapplicationframeworkWAF作用Web開發(fā)平臺的核心職能類似GUI框架，是EASWeb產(chǎn)品開發(fā)的基礎平臺，跟GUI應用框架共用EASWeb服務端組件，協(xié)同BOS框架和業(yè)務模型(BIM)實現(xiàn)模型驅(qū)動架構(MDA)。它提供統(tǒng)一的業(yè)務開發(fā)模型，簡化開發(fā)邏輯，形成一致的開發(fā)模式，最大限度實現(xiàn)代碼的重用機制WAFWAF有什么

1.web應用框架體系為業(yè)務單據(jù)提供復用體系2.UI通用處理如RPC交互、數(shù)據(jù)綁定、異常處理、通用查詢等3.業(yè)務服務調(diào)用如權限控制、BOTP、工作流等4.某些控件如F7,枚舉框，多語言控件，LabelContainer等web應用框架體系序時簿W(wǎng)af序時簿列表界面（ListWinlet）ManagedBean從ListBean繼承，請實現(xiàn)如下方法：getQueryPK()要求返回查詢當前列表數(shù)據(jù)結果的QueryPKgetEditBeanName()要求返回列表對象對應的編輯界面的ManagedBean的名稱getEditUrl()要求返回列表對象對應的編輯界面的UrlgetBizInterface()類似編輯界面的同樣接口實現(xiàn)。該業(yè)務接口的獲取可以通過注入方式實現(xiàn)WAF@IBOSBizCtrl標簽本注釋型負責對BOSIBizCtrl（IBOSObject以及FunctionEJB接口對象）進行統(tǒng)一的注入控制,以及屏蔽與BOS服務端交互的復雜性例如：@IBOSBizCtrl

privateIPurReqservice;Waf序時簿模版templates/list-templates.xhtml定義了列表界面的布局模板，業(yè)務單據(jù)的列表界面視圖從此模板繼承，并提供相應的模板內(nèi)容實現(xiàn)具體使用可以參照Facelets章節(jié)Waf序時簿組件WEB-INF/components/billList-toolbar.xhtml封裝了單據(jù)列表界面工具條部分的內(nèi)容，提供了標準的操作按鈕以及統(tǒng)一的Action綁定，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可例子：<f:viewxmlns:biz=/jsf/biz renderKitId="AJAX"> <ui:definename="toolbar"><biz:billListToolbarbeanName="#{mydemo.PurReqListBean}"> </biz:billListToolbar></ui:define>Waf序時簿組件WEB-INF/components/baseList-toolbar.xhtml

封裝了基礎資料列表界面工具條部分的內(nèi)容，提供了標準的操作按鈕以及統(tǒng)一的Action綁定，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可例子：<f:view

xmlns:biz=http:///jsf/biz

renderKitId="AJAX"> <ui:definename="toolbar"><biz:baseListToolbar

beanName="#{com.kingdee.demo.CurrencyListBean}"> </biz:baseListToolbar> </ui:define>Waf序時簿組件WEB-INF/components/inner-window.xhtml封裝了列表界面跟其他頁面進行Ajax交互的載體，支持UIWindow的彈出框（適用于通用過濾等），也支持其他通過javascript腳本彈出的對話框或新窗口（例如編輯界面或BOTP轉(zhuǎn)換界面等）例子：<f:viewxmlns:biz=/jsf/biz

renderKitId="AJAX"> <ui:definename="inner-window">

<biz:innerWindowbeanName="#{mydemo.PurReqListBean}"> </biz:innerWindow>

</ui:define>Waf編輯界面類圖

Waf編輯界面編輯界面（EditWinlet）ManagedBean從EditBean繼承，請實現(xiàn)如下幾個方法：createNewModel：新增業(yè)務對象getBizInterface：業(yè)務操作接口,該業(yè)務接口的獲取可以通過注入方式實現(xiàn),注入方式和ListBean類似可選實現(xiàn)：getSelectors獲取所選單據(jù)VO屬性，子類可覆蓋實現(xiàn)Updatemodel單據(jù)若含有分錄，更新分錄modelWaf編輯界面模版templates/edit-templates.xhtml定義了編輯界面的布局模板，業(yè)務單據(jù)的編輯界面視圖從此模板繼承，并提供相應的模板內(nèi)容實現(xiàn)

Waf編輯界面組件WEB-INF/components/billEdit-actions.xhtml封裝了編輯界面下方按鈕部分的內(nèi)容，提供了標準的操作按鈕以及統(tǒng)一的Action綁定，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可例子:<f:viewxmlns:biz=/jsf/biz

renderKitId="AJAX"><ui:definename="actions"> <divclass="kd-panel-btns-right"><biz:billEditActionsbeanName="#{mydemo.PurReqEditBean}"></biz:billEditActions> </div></ui:define>Waf編輯界面組件WEB-INF/components/billEntry-actions.xhtml 封裝了分錄的基本操作以及統(tǒng)一的Action綁定，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可例子：<f:viewxmlns:biz=/jsf/biz

renderKitId="AJAX"><ui:definename="entry>"><divclass="kd-panel-btns-right"><biz:billEntryActionsbeanName="#{mydemo.PurReqEditBean}" entryBeanName="#{mydemo.PurReqEntryBean}"> </biz:billEntryActions></div> </ui:define>Waf編輯界面組件WEB-INF/components/billEdit-toolbar.xhtml封裝了單據(jù)與其他單據(jù)相關常用功能的操作及Action綁定，例如上一個單據(jù)、下一個單據(jù)、單據(jù)轉(zhuǎn)換等，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可Waf編輯界面組件WEB-INF/components/billEdit-actions.xhtml封裝了編輯界面下方按鈕部分的內(nèi)容，提供了標準的操作按鈕以及統(tǒng)一的Action綁定，相關業(yè)務使用此組件時只需設置組件的beanName屬性即可例子:<f:viewxmlns:biz=/jsf/biz

renderKitId="AJAX"><ui:definename="actions"> <divclass="kd-panel-btns-right"><biz:billEditActionsbeanName="#{mydemo.PurReqEditBean}"></biz:billEditActions> </div></ui:define>WafUI通用處理數(shù)據(jù)綁定JSF體系本身提供了完善的數(shù)據(jù)綁定功能，不需要類似GUI的loadFields及storeFields等自己處理。對于一些特定類型的屬性綁定，框架提供常用的Converter處理，包括IObjectValueConverter、BOSUUidConverter、DataTimeConverter等。支持EL表達式；可以綁定簡單數(shù)據(jù)類型（string,int,float等）；可以通過數(shù)據(jù)類型轉(zhuǎn)換器綁定復雜數(shù)據(jù)類型（任意數(shù)據(jù)類型）；支持表格、F7的數(shù)據(jù)綁定；WafUI通用處理多語言處理服務端多語言處理Web框架基類BaseBean提供了getResoureText(Stringkey)方法，從文件名等于類名的多語言文件中獲取多語言文本；com.kingdee.bos.waf.resource.Resources提供了getText(Stringbundle,Stringkey)方式更加靈活的獲取多語言信息。客戶端JSF視圖標簽多語言處理通過EL表達式獲取多語言信息：#{messages[‘資源鍵’]}客戶端javascript腳本多語言處理對于jsp視圖，通過擴展jsp的TagSupport，實現(xiàn)把服務端資源文件動態(tài)生成客戶端javascript多語言腳本數(shù)組，然后在js腳本中通過操作此數(shù)據(jù)來獲取相應的多語言信息；對于facelet視圖，需要通過擴展TagHandler來實現(xiàn)jsp一樣的標簽功能，對于視圖部分使用上對開發(fā)者是一致的。 用法：在JSF視圖中申明 <kd:jsMessageBundlejsVar="resource"resourceName="#{myBean.resourceName}“l(fā)ocale=“#{myBean.locale}”/>，然后就可以在javascript中使用resource[“key”]即可獲取對應的多語言字符。WafUI通用處理應用上下文WafUI通用處理異常處理HTTP錯誤異常包括用戶訪問的url不存在、會話失效、訪問拒絕等，框架統(tǒng)一攔截，導航到統(tǒng)一的友好頁面系統(tǒng)異常包括數(shù)據(jù)庫取數(shù)出錯、代碼運行空指針等，框架統(tǒng)一攔截，如果是ajax請求，彈出錯誤提示框；如果非ajax請求，導航到統(tǒng)一頁面用戶異常主要是便于開發(fā)人員把自己認為的異常邏輯或者在應用中出現(xiàn)的問題展現(xiàn)出來，框架統(tǒng)一攔截處理，異常處理方式跟上面“系統(tǒng)異?！碧幚硪粯覹afUI通用處理通用過濾通用過濾默認過濾只需要在XXXListBean實現(xiàn)getQueryPK()即可自定義過濾頁面提供一個繼承monquery.UserQueryBean的ManagedBean，假如為MyUserQueryBean，同時還有相應的Facelets視圖，myUserQuery.xhtml；在序時簿ManagedBean里，覆蓋getUserQueryView()方法，返回上面的Facelets視圖路徑，例如：@Override protectedStringgetUserQueryView(){

return"/mydemo/myUserQuery.xhtml";}Waf業(yè)務服務調(diào)用單據(jù)套打框架已經(jīng)提供默認實現(xiàn)，用戶只需要定義套打模板即可通過導出PDF方式實現(xiàn)網(wǎng)絡互斥數(shù)據(jù)互斥避免同時編輯同一張單據(jù)日志框架默認已經(jīng)提供，業(yè)務開發(fā)無需編碼色彩方案目前支持藍、綠、紅、橙四種色彩方案，默認藍色支持擴展（增加相應的色彩方案目錄結構）Waf業(yè)務服務調(diào)用—權限權限控制頁面訪問權限頁面按鈕權限Waf業(yè)務服務調(diào)用—編碼規(guī)則應用編碼規(guī)則服務定義相關編碼規(guī)則，然后再Web單據(jù)里直接根據(jù)規(guī)則自動生成編碼Waf業(yè)務服務調(diào)用—工作流單據(jù)的提交及工作流審批Waf業(yè)務服務調(diào)用—工作流Waf業(yè)務服務調(diào)用—Botp配置BOTP規(guī)則Waf業(yè)務服務調(diào)用—Botp在費用申請單通過[關聯(lián)生成]操作完成費用報銷單的生成Waf控件F7<kd:promptBox>容器控件<kd:container>復合控件<kd:labelContainer>枚舉控件<kd:enumCombo>多語言控件<kd:multiLangBox>Waf控件F7主要屬性：queryInfo：定義queryviewUrl屬性定義打開自定義url,不寫將使用通用f7界面。diaplayFormat:'$name$'F7默認顯示效果editFormat:'$number$'F7編輯時效果commitFormat:'$number$'popWidth:打開窗口寬popHeight:打開窗口高muti:是否為多選模式store：綁定后臺默認的數(shù)據(jù)集合，用于回填編輯table頁面cu:是否cu過濾orgType：對應的組織類型filterInfo：缺省的過濾條件permItemName：缺省綁定的權限項Waf控件F7F7修改后如果需要觸發(fā)服務端事件，可以通過ajaxaction，直接綁定datachanged屬性的el表達式<kd:promptBoxvalue="#{mydemo.PurReqEditBean.model.currency}"queryInfo="com.kingdee.eas.basedata.assistant.app.CurrencyQuery"><ajax:actionevent="datachanged"action="#{mydemo.PurReqEntryBean.removeRow}"/></kd:promptBox>F7修改后如果需要觸發(fā)客戶端事件<kd:promptBoxjsvar=”F7”value="#{mydemo.PurReqEditBean.model.currency}"queryInfo="com.kingdee.eas.basedata.assistant.app.CurrencyQuery"></kd:promptBox>可自行添加javascript腳本實現(xiàn)：Ext.onReady(function(){ F7.on("datachanged",fu