金蝶EASBOS開發(fā)學(xué)習(xí)筆記

1、金蝶EAS BOS開發(fā)學(xué)習(xí)筆記一 環(huán)境準(zhǔn)備先把需要用到的透視圖和相應(yīng)的視圖打開，在后面的練習(xí)中需要用到。導(dǎo)入eas包后的結(jié)構(gòu)如上圖所示。BOS透視圖下常用到的窗口如上圖所示，這些必須打開。項(xiàng)目屬性配置如下圖所示：下面是Java透視圖中的配置。 EAS 項(xiàng)目的配置數(shù)據(jù)中心配置調(diào)試Config二 需要用到的熱鍵CTRL+SHIFT+R打開資源CTRL+SHIFT+T打開類型三 制作第一個(gè)列表查詢界面打開“金蝶BOS設(shè)計(jì)開發(fā)工具”透視圖1. 打開 eas/metadata/com/kingdee/eas/demo 節(jié)點(diǎn)說明：app目錄下一般存放實(shí)體、表、查詢等元數(shù)據(jù)；Client目錄下一般存放ui，

2、即界面數(shù)據(jù)；其他公共對(duì)象，如枚舉、異常等通常放在與app、client同級(jí)目錄中。2.3. 右擊XueLi.entity，在彈出菜單中選擇“實(shí)體導(dǎo)出表”,保留默認(rèn)值，名稱為T_DE_XueLi4. 打開T_DE_XueLi.table，修改主鍵名稱，避免因?yàn)橹孛麑?dǎo)致建表錯(cuò)誤5. 右擊T_DE_XueLi.table，選擇“導(dǎo)出.”，在彈出窗口中選擇“導(dǎo)出數(shù)據(jù)表”6. 打開管理控制臺(tái)，在“數(shù)據(jù)中心”選擇使用的數(shù)據(jù)中心，再打開“數(shù)據(jù)庫管理”,把生成的CreateTable.sql中的內(nèi)容COPY進(jìn)去，點(diǎn)擊工具欄的“執(zhí)行(F5)”，最后“提交”。7. 在app文件夾下新建查詢XueLiQuery,實(shí)

3、體選擇XueLi.entity8. 打開查詢XueLiQuery,選擇字段標(biāo)簽頁，選擇“導(dǎo)入”，將要查詢的字段添加進(jìn)來，并調(diào)整各字段順序。還應(yīng)該在“其它”頁中定義排序和主鍵字段。9. 在client文件夾下新建UI，父對(duì)象選擇com.kingdee.eas.framework.client.ListUI(列表界面)，BO對(duì)象選擇XueLiQuery.query，其他用默認(rèn)值即可。(W:apusicmetas)10. 單擊鼠標(biāo)右鍵，在彈出菜單中選擇“編輯表信息”，選擇ID列，把hide屬性值修改為true，以隱藏不希望在列表中顯示的列。注意：ID列不管是否需要顯示，必須要存在于列表中，否則會(huì)出現(xiàn)

4、后文所述的錯(cuò)誤。四 發(fā)布列表界面，查看效果1. 建立Java發(fā)布目錄：D:gmis310_srcdemodevsrc2. 選擇包的根節(jié)點(diǎn)eas，右鍵選擇屬性，在彈出窗口中選擇Solution發(fā)布方案信息，新增一個(gè)發(fā)布方案,命名為demo3. Java發(fā)布目錄輸入前面建立的目錄，J2EE發(fā)布目錄及元數(shù)據(jù)發(fā)布目錄輸入與其他發(fā)布方案相同的目錄 W:apusicmetas4. 選擇app目錄下XueLi.entity，單擊右鍵，選擇發(fā)布；發(fā)布方案選擇demo，完成后察看“校驗(yàn)信息”視圖，發(fā)現(xiàn)有錯(cuò)誤提示，直接雙擊，打開錯(cuò)誤 5. 在邏輯鍵信息中增加CoreBase.id，保存6. 清除校驗(yàn)信息視圖中的內(nèi)

5、容，再點(diǎn)擊工具欄上的“清除元數(shù)據(jù)緩存”，否則有可能會(huì)導(dǎo)致再次發(fā)布失敗 7. 再次發(fā)布XueLi.entity，成功。8. 選擇demo文件夾，右鍵，選擇“發(fā)布”,將前面建立的所有元數(shù)據(jù)（.table,.entity,.query,.ui）全部選中，再次進(jìn)行發(fā)布。9. 切換到Java透視圖。10. 選擇bs_dio節(jié)點(diǎn)，單擊鼠標(biāo)右鍵，刷新，讓新建立的demo文件夾顯示出來。11. 選擇bs_dio節(jié)點(diǎn)，單擊鼠標(biāo)右鍵，“構(gòu)建路徑”->“配置構(gòu)建路徑”，將"demo/dev/src"添加進(jìn)來，在自動(dòng)構(gòu)建完成之后，可以在 D:gmis310_srcbincomkingdeee

6、asdemo 看到編譯好了的class文件12. 重新啟動(dòng)gmis_server服務(wù)器，然后用administrator用戶登錄13. 保存后重新登錄，進(jìn)入系統(tǒng)后可以看到此菜單，但此時(shí)雙擊報(bào)錯(cuò)，查看控制臺(tái)日志，可知是有抽象類方法沒有實(shí)現(xiàn)14. 在Java透視圖中打開XueLiListUI.java文件,此時(shí)可以看到有錯(cuò)誤提示，點(diǎn)擊鼠標(biāo)，自動(dòng)實(shí)現(xiàn)接口類的框架代碼。此時(shí)可以看到項(xiàng)目已經(jīng)不再報(bào)錯(cuò)了。進(jìn)入系統(tǒng)后，發(fā)現(xiàn)點(diǎn)擊“新增”按鈕時(shí)報(bào)錯(cuò)。15. 按CTRL+SHIFT+T,查找DiplomaListUI，打開DiplomaListUI.class文件（這是系統(tǒng)中已有的學(xué)歷窗體）。16. 在XueLi

7、ListUI.java中，參考DiplomaListUI實(shí)現(xiàn)getEditUIName和getBizInterface方法。protected ICoreBase getBizInterface() throws Exception return XueLiFactory.getRemoteInstance();protected String getEditUIName() return "com.kingdee.eas.basedata.hraux.client.DiplomaEditUI"至此，列表UI已可正常執(zhí)行，但新增界面調(diào)用的是系統(tǒng)原有的DiplomaEditU

8、I。接下來再實(shí)現(xiàn)我們自己的EditUI。五 制作對(duì)應(yīng)的編輯界面1. 切換到BOS設(shè)計(jì)視圖，在Client下新建UI，命名為XueLiEditUI，父對(duì)象為com.kingdee.eas.framework.client.EditUI（編輯界面），BO對(duì)象選擇XueLi.entity，綁定控件時(shí)只保留需要用戶輸入的控件。2. 發(fā)布此UI，發(fā)布方案選擇demo3. 切換到Java透視圖，刷新 /bs_dio/demo/dev/src 目錄，讓新加的UI出現(xiàn)在樹中，此時(shí)會(huì)自動(dòng)構(gòu)建，提示有錯(cuò)誤4. 打開 XueLiEditUI.java，查看錯(cuò)誤信息，發(fā)現(xiàn)是有未實(shí)現(xiàn)的抽象方法，生成它5. 打開Dipl

9、omaEditUI的JAVA類，將createNewData和getBizInterface方法的代碼COPY到XueLiEditUI.java中，并做相應(yīng)修改。6.7. 重新運(yùn)行代碼，可以看到現(xiàn)在已可以調(diào)出新做的編輯窗口，增加二條數(shù)據(jù)，可以成功保存。8. 返回到ListUI，點(diǎn)擊各條記錄時(shí)，發(fā)現(xiàn)提示"沒有定義正確的keyField，請(qǐng)重載getKeyFileedNmae()方法"。（如果前面步驟嚴(yán)格按照截圖中操作，則不會(huì)出現(xiàn)此錯(cuò)誤，因此不需要后面的這幾步）9. 經(jīng)比較，發(fā)現(xiàn)在查詢對(duì)象中沒有定義主鍵ID。因此，打開XueLiQuery.query，在字段頁中增加id字段，在

10、其它頁中增加id字段的主鍵定義。10. 問題還不在這里。打開XueLiListUI，重新綁定XueLiQuery.query，把ID列加入到表格中，然后設(shè)置此列為隱藏。11. 保存后重新發(fā)布，再在java視圖中刷新，重新構(gòu)造應(yīng)用。12. 重啟Server，然后起動(dòng)應(yīng)用，測試成功。六 需要注意的問題1. 關(guān)于發(fā)布的問題只要是更改了app下的對(duì)象，一定要重新發(fā)布。由于app的發(fā)布目錄是在W:apusicmetascomkingdeeeasdemoapp目錄下，這是服務(wù)器的目錄，因此發(fā)布之后必須要重啟服務(wù)器才能生效。如果更改了client下的對(duì)象，由于只是在客戶端的，因此發(fā)布后只需重啟應(yīng)用即可。2.

11、 關(guān)于查詢時(shí)的過濾條件問題如下圖所示，在查詢時(shí)，過濾條件中沒有可供選擇的內(nèi)容。解決方法是打開列表界面的查詢對(duì)象，如上圖所示，在擴(kuò)展屬性中加入通用查詢條件即可。注意此擴(kuò)展屬性是針對(duì)每個(gè)字段進(jìn)行設(shè)置的。3. EditUI中數(shù)據(jù)保存前，對(duì)數(shù)據(jù)進(jìn)行合法性校驗(yàn)的問題通常有二種方法。一種是重載actionSubmit動(dòng)作，在代碼中進(jìn)行處理。此種方法需要先在EditUI中生成Action事件，以便在發(fā)布后超類中有相應(yīng)的虛方法，如此在繼承類中才可以重載方法。 public void actionSubmit_actionPerformed(ActionEvent e) throws Exception /名稱

12、是否可為空if (txtName.getText() = null | txtName.getText().trim().length() = 0) MsgBox.showError(this, "請(qǐng)輸入名稱！");this.txtName.requestFocusInWindow();return; /編碼是否為空if (txtNumber.getText() = null | txtNumber.getText().trim().length() = 0) MsgBox.showError(this, "請(qǐng)輸入編碼！");this.txtNumber

13、.requestFocusInWindow();return; super.actionSubmit_actionPerformed(e); 此種方法較繁瑣。另一種方法較簡單。打開基類的EditUI.class，可以看到有verifyInput方法是空的，在保存之前基類會(huì)調(diào)用此方法。因此，只需要在繼承類中重載實(shí)現(xiàn)此方法即可。在大多數(shù)情況下，推薦使用此種方法進(jìn)行數(shù)據(jù)合法性校驗(yàn)。protected void verifyInput(ActionEvent e) throws Exception super.verifyInput(e); /名稱是否可為空if (txtName.getText() = null | txtName.getText().trim().length() = 0) MsgBox.showError(this, "請(qǐng)輸入名稱！");this.txtName.requestFocusInWindow();SysUtil.abort(); /編碼是否為空if (txtN