1、SG-UAP集成開發(fā)工具使用手冊(cè)國家電網(wǎng)公司應(yīng)用系統(tǒng)統(tǒng)一開發(fā)平臺(tái)（SG-UAP V3.0.0）集成開發(fā)工具使用手冊(cè)國網(wǎng)信息通信產(chǎn)業(yè)集團(tuán)研發(fā)中心2017年7月修訂記錄版本號(hào)修訂說明修訂人修訂時(shí)間審核人2.0編制界面設(shè)計(jì)器相關(guān)內(nèi)容王濤、趙子彧2013-11-192.0界面設(shè)計(jì)器提綱調(diào)整叢興滋2013-11-212.0提綱調(diào)整和內(nèi)容補(bǔ)充張晶2013-11-292.0界面設(shè)計(jì)器內(nèi)容修訂王濤2013-12-032.0模型驅(qū)動(dòng)張賀2013-12-052.0增加 4.8 數(shù)據(jù)庫兼容性章節(jié) 內(nèi)容陳萬里2014-2-192.1增加 0 動(dòng)態(tài)樹場景 內(nèi)容陳萬里2014-6-202.1增加 5.7.1

2、.11 工作流場景 內(nèi)容劉彬2014-2-202.3增加6規(guī)劃設(shè)計(jì)器內(nèi)容徐冉2014-9-232.3增加.2.7測(cè)試代碼內(nèi)容，更新.1基本操作內(nèi)容徐冉2014-9-232.3增加 Pdm文件導(dǎo)入生成OM胡斌君2014-9-232.3增加 7.9 共享模型庫胡斌君2014-9-232.5增加6.3.2部分徐冉2014-11-182.5增加陳萬里2014-11-192.5增加5.8王濤2014-11-21目錄1引言11.1概述11.2適用范圍11.3名詞解釋12基礎(chǔ)環(huán)境概述52.1開發(fā)透視圖52.2權(quán)限登錄配置62.3Tomcat93項(xiàng)

3、目創(chuàng)建及部署143.1UAP項(xiàng)目143.1.1創(chuàng)建UAP項(xiàng)目143.1.2配置UAP項(xiàng)目243.1.3部署UAP項(xiàng)目303.2模塊項(xiàng)目323.2.1創(chuàng)建模塊項(xiàng)目323.2.2配置模塊項(xiàng)目363.2.3開發(fā)模塊項(xiàng)目433.2.4部署模塊項(xiàng)目463.2.5調(diào)試模塊項(xiàng)目493.3擴(kuò)展模塊項(xiàng)目553.3.1新建擴(kuò)展模塊553.3.2配置擴(kuò)展模塊593.3.3開發(fā)擴(kuò)展模塊603.3.4部署擴(kuò)展模塊614模型驅(qū)動(dòng)624.1模型驅(qū)動(dòng)概述624.2模型驅(qū)動(dòng)界面介紹624.2.1設(shè)計(jì)器界面624.2.2大綱視圖664.2.3屬性視圖744.2.4模型驅(qū)動(dòng)視圖754.2.5模型驅(qū)動(dòng)首選項(xiàng)754.3模型驅(qū)動(dòng)詳細(xì)使用

4、步驟774.3.1創(chuàng)建業(yè)務(wù)對(duì)象模型774.3.2新增包914.3.3新增圖914.3.4新增業(yè)務(wù)實(shí)體924.3.5新增屬性944.3.6設(shè)置編輯器964.3.7新增校驗(yàn)器1004.3.8新增業(yè)務(wù)操作1034.3.9新增枚舉1064.3.10創(chuàng)建關(guān)聯(lián)關(guān)系1074.3.11生成代碼1134.3.12Hibernate懶加載代碼特殊處理1254.3.13業(yè)務(wù)實(shí)體修改1264.4內(nèi)置實(shí)體應(yīng)用1324.5引用實(shí)體應(yīng)用1364.6數(shù)據(jù)庫反向功能應(yīng)用1414.7基于自動(dòng)生成的代碼擴(kuò)展1454.7.1Bizc擴(kuò)展1454.7.2Controller擴(kuò)展1474.7.3自定義事務(wù)1494.7.4Hbm擴(kuò)展150

5、4.7.5Po擴(kuò)展1515可視化界面設(shè)計(jì)器1515.1設(shè)計(jì)器首選項(xiàng)1515.1.1默認(rèn)配置項(xiàng)1515.1.2瀏覽器清單1525.2界面模型創(chuàng)建1565.2.1模型創(chuàng)建向?qū)?565.2.2空白模板創(chuàng)建1635.2.3場景模板創(chuàng)建1645.3設(shè)計(jì)器工作區(qū)1665.3.1畫布操作區(qū)1665.3.2大綱視圖1715.3.3屬性視圖1735.3.4右鍵菜單1745.3.5常用控件介紹1745.4界面模型設(shè)計(jì)1805.4.1界面模型可視設(shè)計(jì)1805.4.2事件函數(shù)編寫2005.4.3界面模型依賴2035.4.4公共函數(shù)使用2085.5腳本代碼生成2195.5.1腳本文件生成方式2195.5.2腳本文件生成

6、向?qū)?195.5.3生成代碼修改注意事項(xiàng)2235.6設(shè)計(jì)效果瀏覽2235.6.1啟動(dòng)Tomcat2235.6.2使用默認(rèn)瀏覽器預(yù)覽2265.6.3使用其它瀏覽器預(yù)覽2275.7典型場景模板2285.7.1預(yù)置模板介紹2285.7.2模板庫概述2746輔助功能2756.1前端MX代碼生成2756.1.1創(chuàng)建MX Weblet2756.1.2創(chuàng)建MX視圖2806.1.3創(chuàng)建MX類2856.2Web服務(wù)代碼生成2916.2.1服務(wù)發(fā)布功能2916.2.2服務(wù)調(diào)用功能2996.3SAP RFC函數(shù)3056.3.1R3服務(wù)器配置3056.3.2函數(shù)代碼生成3076.4模塊依賴關(guān)系3096.5REST服務(wù)

7、URL3116.6代碼格式檢查3136.7代碼缺陷分析3176.8API文檔集成3186.8.1自動(dòng)為依賴的平臺(tái)插件添加javadoc地址3186.8.2在文件編輯器中選中查看API3201 引言1.1 概述集成開發(fā)工具是統(tǒng)一應(yīng)用平臺(tái)提供的快速開發(fā)應(yīng)用系統(tǒng)的環(huán)境，它以Eclipse為基礎(chǔ)，以標(biāo)準(zhǔn)插件的方式進(jìn)行功能擴(kuò)展，是所有基于平臺(tái)進(jìn)行二次開發(fā)的統(tǒng)一入口。集成開發(fā)工具提供可視化、簡易化、標(biāo)準(zhǔn)化的開發(fā)環(huán)境，集成代碼編寫功能、分析功能、編譯功能、調(diào)試功能、測(cè)試功能、發(fā)布功能等一體化的開發(fā)軟件服務(wù)套件。為系統(tǒng)設(shè)計(jì)人員、開發(fā)人員和管理人員提供對(duì)系統(tǒng)開發(fā)、系統(tǒng)測(cè)試、系統(tǒng)調(diào)試、系統(tǒng)部署等軟件生命周期的協(xié)同

8、開發(fā)、版本管理和項(xiàng)目管理。1.2 適用范圍本文檔通過文字配圖的方式介紹了統(tǒng)一應(yīng)用平臺(tái)集成開發(fā)工具的各功能項(xiàng)，其中所涉及的各種配置文件、配置項(xiàng)的詳細(xì)說明，請(qǐng)參考開發(fā)手冊(cè)。本文檔適用于統(tǒng)一應(yīng)用平臺(tái)的所有用戶。因?yàn)榘姹镜牟煌?，本文檔的截圖可能與實(shí)際情況不完全一致，請(qǐng)以實(shí)際情況為主。1.3 名詞解釋表格 1 名詞解釋名詞相關(guān)解釋統(tǒng)一應(yīng)用平臺(tái)State Grid Unified Application Platform，英文縮寫“SG-UAP”。國家電網(wǎng)公司新一代應(yīng)用開發(fā)與運(yùn)維平臺(tái)，提供一套技術(shù)統(tǒng)一、架構(gòu)柔性、性能高效、安全可靠的企業(yè)級(jí)信息系統(tǒng)基礎(chǔ)框架和公共套件集，支撐業(yè)務(wù)系統(tǒng)的設(shè)計(jì)、開發(fā)、測(cè)試、發(fā)布、

9、運(yùn)行的全過程。（中文簡稱“統(tǒng)一應(yīng)用平臺(tái)”，英文簡稱“UAP”）。Studio統(tǒng)一應(yīng)用平臺(tái)的集成及可視化開發(fā)環(huán)境，集設(shè)計(jì)、編碼、測(cè)試調(diào)試和部署于一體，為不同的開發(fā)階段提供了指導(dǎo)和幫助，優(yōu)化了軟件開發(fā)過程和團(tuán)隊(duì)開發(fā)流程。統(tǒng)一應(yīng)用平臺(tái)服務(wù)端提供統(tǒng)一應(yīng)用平臺(tái)的模塊，整個(gè)項(xiàng)目組共用一個(gè)，由項(xiàng)目管理人員統(tǒng)一維護(hù)，開發(fā)人員只需要知道統(tǒng)一應(yīng)用平臺(tái)服務(wù)端的地址。（簡稱“服務(wù)端”）UAP項(xiàng)目依賴于統(tǒng)一應(yīng)用平臺(tái)服務(wù)端的標(biāo)準(zhǔn)的空的Web應(yīng)用。模塊具有OSGi規(guī)范（Open Service Gateway Initiative ，開放服務(wù)網(wǎng)關(guān)規(guī)范）特定描述的Java程序包，是OSGi規(guī)范定義的模塊化實(shí)體單元。統(tǒng)一應(yīng)用平

10、臺(tái)的微內(nèi)核對(duì)標(biāo)準(zhǔn)的OSGi模塊進(jìn)行擴(kuò)展形成了動(dòng)態(tài)模塊，以上兩者統(tǒng)稱為模塊。擴(kuò)展模塊依附于模塊，無法獨(dú)立運(yùn)行，可以看成是模塊的一部分，能向模塊中添加代碼和資源。持久模型數(shù)據(jù)庫中的表在Studio中的體現(xiàn)形式，按照Herbernate配置文件的規(guī)范對(duì)表進(jìn)行了封裝。持久模型文件保存持久模型信息的文件，以.pm后綴結(jié)尾。場景對(duì)用戶常用的業(yè)務(wù)模塊進(jìn)行分析和抽象，發(fā)現(xiàn)這些模塊的代碼在結(jié)構(gòu)上高度類似，具有通用性或定制批量生成特性，因此歸納出了以下常用場景：單表場景、主從表場景、樹場景。平臺(tái)基礎(chǔ)設(shè)施統(tǒng)一應(yīng)用平臺(tái)中最底層的部分，其中包含核心框架和平臺(tái)微內(nèi)核。平臺(tái)公共套件統(tǒng)一應(yīng)用平臺(tái)提供的各類公共服務(wù)：如任務(wù)調(diào)度

11、、即席報(bào)表、數(shù)據(jù)緩存、信息通信等。一體化平臺(tái)門戶、可視化體系、BPM、統(tǒng)一授權(quán)平臺(tái)、數(shù)據(jù)中心等服務(wù)統(tǒng)稱一體化平臺(tái)。微內(nèi)核一個(gè)控制、管理模塊運(yùn)行的框架。透視圖在集成開發(fā)工具上的對(duì)某個(gè)插件的開發(fā)模式，如debug透視圖。界面模型提供一套中立的設(shè)計(jì)時(shí)界面描述規(guī)范，定義前端界面開發(fā)中涉及的各類元素，通過編譯器可轉(zhuǎn)換生成運(yùn)行時(shí)代碼。界面編輯器提供界面模型到MX腳本的編譯轉(zhuǎn)換支持，轉(zhuǎn)換過程不可逆。數(shù)據(jù)源瀏覽器端數(shù)據(jù)容器的描述性信息，是模型驅(qū)動(dòng)或REST服務(wù)對(duì)應(yīng)的元數(shù)據(jù)的引用，用作界面中數(shù)據(jù)控件的數(shù)據(jù)源。界面視圖一個(gè)界面包含多個(gè)View；View和controller成對(duì)出現(xiàn)，前者為控件樹，后者為事件處理代

12、碼。View中隱含控件樹，支持MX框架全部控件。工具欄顯示編譯、預(yù)覽、視圖切換等常規(guī)按鈕。業(yè)務(wù)對(duì)象建模提供圖形化的模型圖編輯器對(duì)業(yè)務(wù)實(shí)體、屬性、關(guān)系、權(quán)限、持久化映射策略、枚舉等類型業(yè)務(wù)對(duì)象進(jìn)行建模和管理。界面建模提供圖形化的界面建模工具對(duì)界面模型文件、模板、數(shù)據(jù)源等對(duì)象進(jìn)行管理，同時(shí)，支撐為UI組件進(jìn)行數(shù)據(jù)源和權(quán)限信息的設(shè)置，具備基于界面模型生成UAP MxFramework前端(face)代碼的能力。模型驅(qū)動(dòng)引擎基于業(yè)務(wù)對(duì)象模型生成UAP模塊項(xiàng)目的后端代碼及配置文件，內(nèi)容包括： HBM映射文件、POJO、BizC、Controller及Hibernate和Spring配置文件；同時(shí)提供業(yè)務(wù)

13、對(duì)象模型物理文件(.om文件)解析和反解析功能，在運(yùn)行時(shí)提供業(yè)務(wù)對(duì)象模型元數(shù)據(jù)訪問、數(shù)據(jù)校驗(yàn)、通用業(yè)務(wù)對(duì)象查詢等服務(wù)。設(shè)計(jì)視圖提供業(yè)務(wù)模型圖在建模工作區(qū)的圖形化展示，并能響應(yīng)視圖上的所有事件（如單擊、雙擊、拖動(dòng)、右鍵等）。模型校驗(yàn)實(shí)現(xiàn)對(duì)模型級(jí)別的校驗(yàn)項(xiàng)包括：格式校驗(yàn)、唯一性檢查等）與校驗(yàn)對(duì)象（實(shí)體、枚舉、關(guān)聯(lián)關(guān)系等；輸出校驗(yàn)日志，并提供校驗(yàn)結(jié)果快速定位錯(cuò)誤功能。導(dǎo)航屬性PO文件生成時(shí)創(chuàng)建的對(duì)象，用于實(shí)現(xiàn)在實(shí)體A中查找實(shí)體B命名空間歸屬于業(yè)務(wù)對(duì)象模型，用于生成代碼時(shí)組合包名，例如com.sgcc.uap業(yè)務(wù)實(shí)體業(yè)務(wù)實(shí)體是用于描述業(yè)務(wù)對(duì)象生命周期內(nèi)相關(guān)數(shù)據(jù)的信息模型，包含屬性和操作。兩實(shí)體間可以創(chuàng)

14、建關(guān)聯(lián)關(guān)系，對(duì)應(yīng)數(shù)據(jù)庫的表和外鍵約束。引用實(shí)體從本模型以外的OM文件引入的業(yè)務(wù)實(shí)體，用于解決跨模塊引用，在本模塊中引用另一模塊的實(shí)體。內(nèi)置實(shí)體UAP平臺(tái)中默認(rèn)定義權(quán)限系統(tǒng)中的業(yè)務(wù)實(shí)體，如果場景中需要這種實(shí)體，可將此實(shí)體引用到OM，內(nèi)置實(shí)體不可修改，做場景代碼時(shí)，可以讀數(shù)據(jù)，不可以改數(shù)據(jù)。數(shù)據(jù)庫反向?qū)嶓w從數(shù)據(jù)庫反向?qū)氲絆M中的業(yè)務(wù)實(shí)體，無需手工創(chuàng)建，從數(shù)據(jù)庫中已存在的表導(dǎo)入到OM中，適用于數(shù)據(jù)庫設(shè)計(jì)完整且已創(chuàng)建數(shù)據(jù)庫表的項(xiàng)目。自定義代碼防覆蓋模型驅(qū)動(dòng)生成代碼后，用戶修改過代碼，在屬性或方法前加上“keep”的注釋，再次用模型驅(qū)動(dòng)生成代碼時(shí)保留用戶手動(dòng)修改的代碼段，包括java和xml文件服務(wù)端

15、強(qiáng)制校驗(yàn)業(yè)務(wù)實(shí)體屬性配置校驗(yàn)器則生成代碼時(shí)，在后端生成強(qiáng)制校驗(yàn)代碼，在調(diào)用保存方法時(shí)，強(qiáng)制調(diào)用服務(wù)端生成的校驗(yàn)。前端js本身不是安全的，同時(shí)瀏覽器可以禁用js腳本，所以后臺(tái)的校驗(yàn)還是必須的?？缒K模型引用從另一模塊項(xiàng)目的OM文件中引用業(yè)務(wù)實(shí)體，用于在本模塊中引用另一模塊的實(shí)體。數(shù)據(jù)庫反向建模從數(shù)據(jù)庫中將表和表之間的外鍵關(guān)系導(dǎo)入到OM文件，生成業(yè)務(wù)實(shí)體和關(guān)聯(lián)關(guān)系編輯器一個(gè)屬性在展示前端頁面上的編輯器類型枚舉類型一個(gè)鍵值對(duì)的集合，用于配置選擇類編輯器的數(shù)據(jù)來源，生成代碼時(shí)在UAP的枚舉文件中生成對(duì)應(yīng)的鍵值對(duì)。校驗(yàn)器屬于業(yè)務(wù)實(shí)體屬性的配置內(nèi)容，校驗(yàn)一個(gè)屬性對(duì)應(yīng)的編輯器填寫內(nèi)容是否正確，用于前端和后端

16、校驗(yàn)。導(dǎo)航屬性PO文件生成時(shí)創(chuàng)建的對(duì)象，用于實(shí)現(xiàn)在實(shí)體A中查找實(shí)體B命名空間歸屬于業(yè)務(wù)對(duì)象模型，用于生成代碼時(shí)組合包名業(yè)務(wù)實(shí)體業(yè)務(wù)實(shí)體是用于描述業(yè)務(wù)對(duì)象生命周期內(nèi)相關(guān)數(shù)據(jù)的信息模型，包含屬性和操作。引用實(shí)體從本模型以外的OM文件引入的業(yè)務(wù)實(shí)體內(nèi)置實(shí)體UAP平臺(tái)中默認(rèn)定義權(quán)限系統(tǒng)中的業(yè)務(wù)實(shí)體數(shù)據(jù)庫反向?qū)嶓w從數(shù)據(jù)庫反向?qū)氲絆M中的業(yè)務(wù)實(shí)體自定義代碼防覆蓋模型驅(qū)動(dòng)生成代碼后，用戶修改過代碼，再次用模型驅(qū)動(dòng)生成代碼時(shí)保留用戶手動(dòng)修改的代碼段，包括java和xml文件服務(wù)端強(qiáng)制校驗(yàn)在調(diào)用保存方法時(shí)，強(qiáng)制調(diào)用服務(wù)端生成的校驗(yàn)跨模塊模型引用從另一模塊項(xiàng)目的OM文件中引用業(yè)務(wù)實(shí)體數(shù)據(jù)庫反向建模從數(shù)據(jù)庫中將表

17、和表之間的外鍵關(guān)系導(dǎo)入到OM文件，生成業(yè)務(wù)實(shí)體和關(guān)聯(lián)關(guān)系編輯器一個(gè)屬性在展示前端頁面上的編輯器類型枚舉類型一個(gè)鍵值對(duì)的集合，用于配置選擇類編輯器的數(shù)據(jù)來源校驗(yàn)器校驗(yàn)一個(gè)屬性對(duì)應(yīng)的編輯器填寫內(nèi)容是否正確2 基礎(chǔ)環(huán)境概述2.1 開發(fā)透視圖在集成開發(fā)工具中提供了“UAP開發(fā)透視圖”，將和UAP項(xiàng)目開發(fā)相關(guān)的多個(gè)視圖和操作集合到一起。2.2 權(quán)限登錄配置配置服務(wù)接口地址、登錄用戶名、密碼及所要注冊(cè)的業(yè)務(wù)系統(tǒng)列表等信息。打開IDE，點(diǎn)擊“window-Preferences-UAP IDE-權(quán)限登錄配置”選項(xiàng)，進(jìn)入“權(quán)限登錄配置”頁面，如下圖所示。輸入服務(wù)接口地址后，在業(yè)務(wù)系統(tǒng)列表中顯示所有可用的業(yè)務(wù)系

18、統(tǒng)。輸入用戶名和密碼，點(diǎn)擊登錄按鈕，提示“登錄成功”。若用戶名或密碼錯(cuò)誤，則提示“用戶認(rèn)證失敗”。2.3 Tomcat在首次進(jìn)入工作空間時(shí)，集成開發(fā)工具默認(rèn)創(chuàng)建一個(gè)Server實(shí)例，即“Tomcat 6 at localhost”。在 “Server視圖”中，雙擊 “Tomcat 6 at localhost”，可以對(duì)該Server實(shí)例進(jìn)行編輯。編輯器包括兩部分Overview和Modules。 OverviewOverview中包括的信息包括：一般信息、服務(wù)器位置、服務(wù)器選項(xiàng)、發(fā)布、超時(shí)、端口號(hào)、MIME映射。發(fā)布設(shè)置，設(shè)置是否自動(dòng)發(fā)布，當(dāng)資源發(fā)生變化時(shí)是否自動(dòng)發(fā)布，自動(dòng)發(fā)布的時(shí)間間隔等。超

19、時(shí)設(shè)置，設(shè)置服務(wù)器操作超過多少秒就失效，例如，服務(wù)器啟動(dòng)時(shí)間限制為450秒，終止時(shí)間限制為150秒，超過設(shè)定時(shí)間就失效了。端口號(hào)設(shè)置，設(shè)置Tomcat管理端口號(hào)，HTTP訪問端口號(hào)，AJP訪問端口號(hào)。服務(wù)器位置設(shè)置，Studio中默認(rèn)的ServerLocation是“User workspace metadata”，當(dāng)通過Studio啟動(dòng)Tomcat時(shí)，服務(wù)器中只運(yùn)行了Eclipse工作空間中已發(fā)布到Tomcat上的項(xiàng)目，即可以訪問http:/localhost:8080/uap但是無法訪問http:/localhost:8080/。要想訪問http:/localhost:8080/或者h(yuǎn)tt

20、p:/localhost:8080/admin/index.jsp等Tomcat頁面，需要重新配置ServerLocation。注意：如果已經(jīng)有項(xiàng)目Publish到Server上了（啟動(dòng)應(yīng)用也會(huì)發(fā)布項(xiàng)目），Server Locations欄是不可修改的，可以先Remove項(xiàng)目并Clean Server，使Server Locations欄可修改。選擇“Use Tomcat installation”，此時(shí)通過Studio啟動(dòng)Tomcat時(shí)，%TOMCAT_HOME%webapps目錄下的所有應(yīng)用都會(huì)被啟動(dòng)。 ModulesModules對(duì)部署到服務(wù)器上的模塊進(jìn)行編輯。用戶可以添加、刪除和編輯發(fā)

21、布到服務(wù)器上的模塊。選中應(yīng)用后點(diǎn)擊“Edit”按鈕，通過是否勾選“Auto reloading enabled”項(xiàng)來配置修改源碼后是否自動(dòng)重啟。選中時(shí)為修改源碼后應(yīng)用自動(dòng)重啟；不選時(shí)為修改源碼后應(yīng)用不會(huì)自動(dòng)重啟。當(dāng)用戶在Studio中修改Tomcat 的配置文件后，經(jīng)常出現(xiàn)Clean Tomcat服務(wù)器以后，仍然不生效的情況。導(dǎo)致用戶弄不清楚準(zhǔn)確的原因，不知是自己配置錯(cuò)了，還是緩存沒有刷新。解決方案如下：1、打開 Servers視圖，雙擊 Tomcat實(shí)例，打開Tomcat編輯器。點(diǎn)擊“Open launch configuration”2、選中“Arguments”，復(fù)制“-Dcatalin

22、a base”的值，打開該文件目錄。3、打開該目錄下的conf文件夾，將看到tomcat的配置文件。4、如果在工作空間修改了相應(yīng)的配置文件，為了防止Tomcat配置文件不生效，可以手動(dòng)將文件覆蓋這里的配置文件，然后再從Studio啟動(dòng)Tomcat服務(wù)器。3 項(xiàng)目創(chuàng)建及部署3.1 UAP項(xiàng)目3.1.1 創(chuàng)建UAP項(xiàng)目1、點(diǎn)擊工具欄上的New按鈕，選擇“UAP項(xiàng)目”，也可以選擇菜單欄中的“File-New-UAP項(xiàng)目”。2、在打開的“新建UAP項(xiàng)目”向?qū)е休斎腠?xiàng)目名稱，其他選項(xiàng)保持默認(rèn)值。3、點(diǎn)擊“Next” 按鈕進(jìn)入下一個(gè)向?qū)ы撁?，可以選擇增加源文件和class文件存放路徑，這里保持默認(rèn)值即可。

23、4、點(diǎn)擊“Next”按鈕進(jìn)入下一個(gè)向?qū)ы撁妫渲庙?xiàng)目的Web應(yīng)用，保持默認(rèn)值即可，其中“Context Root”中的值是應(yīng)用的上下文路徑。5、點(diǎn)擊“Next”按鈕進(jìn)入下一個(gè)向?qū)ы撁?，配置?xiàng)目的數(shù)據(jù)庫連接。6、點(diǎn)擊“增加連接”按鈕，打開新建數(shù)據(jù)庫連接對(duì)話框，選擇對(duì)應(yīng)的數(shù)據(jù)庫類型，目前支持Oracle，達(dá)夢(mèng)和DB2數(shù)據(jù)庫，這里示例選擇“Oracle”。7、點(diǎn)擊“Next”按鈕，點(diǎn)擊箭頭指向的小圓圈符號(hào)，配置oracle數(shù)據(jù)庫的驅(qū)動(dòng)。8、選中“Oracle Thin Driver oracle 10”，點(diǎn)擊“OK”按鈕。9、在對(duì)話框中輸入數(shù)據(jù)庫ID、主機(jī)名、端口號(hào)、用戶名、密碼，并勾選“Save

24、password”這樣下次連接數(shù)據(jù)庫時(shí)可以不用再次輸入密碼。10、點(diǎn)擊“Test Connection”對(duì)數(shù)據(jù)庫連接進(jìn)行測(cè)試，如果測(cè)試成功，會(huì)彈出提示對(duì)話框，點(diǎn)擊“OK”按鈕關(guān)閉對(duì)話框。11、點(diǎn)擊“Next”，顯示數(shù)據(jù)庫連接摘要12、點(diǎn)擊“Finish”完成數(shù)據(jù)庫連接配置，返回UAP項(xiàng)目新建向?qū)?，如果連接成功會(huì)在Scheme中顯示數(shù)據(jù)庫的ID。13、點(diǎn)擊“Finish”按鈕完成新建向?qū)У呐渲?，開始創(chuàng)建UAP項(xiàng)目。14、項(xiàng)目創(chuàng)建完成后回到“UAP開發(fā)透視圖”，在“Package”視圖中新增了一個(gè)剛才創(chuàng)建的UAP項(xiàng)目，同時(shí)在“Data Source Explorer”視圖中新增了一個(gè)數(shù)據(jù)庫連接。3

25、.1.2 配置UAP項(xiàng)目UAP項(xiàng)目創(chuàng)建完成后，需要對(duì)應(yīng)用進(jìn)行配置，應(yīng)用中的配置文件包括：WebContent/WEB-INF/configuration目錄下的配置文件和WEB-INF/repositoty/platform/modulelist/client_exclude_perties文件以及WebContent/WEB-INF/web.xml文件。WebContent/WEB-INF/configuration目錄下存放著一些重要的系統(tǒng)配置，分別是： config.ini：DM相關(guān)配置， datasource.xml：應(yīng)用的數(shù)據(jù)源 perties

26、：log4j配置 policy.xml：應(yīng)用的策略注：config.ini相關(guān)配置步驟請(qǐng)參考2.1.2配置config.ini文件 配置數(shù)據(jù)源數(shù)據(jù)源配置在UAP項(xiàng)目的WebContentWEB-INFconfigurationdatasource.xml文件中，支持JDBC、DBCP、JNDI三種方式。如果采用JNDI方式，請(qǐng)確保應(yīng)用服務(wù)器已經(jīng)創(chuàng)建或配置了對(duì)應(yīng)的數(shù)據(jù)源，具體請(qǐng)參考應(yīng)用服務(wù)器的相關(guān)文檔。數(shù)據(jù)源的配置可以手工編輯datasource.xml文件或通過界面配置。界面配置如下所示。右鍵單擊UAP項(xiàng)目，選擇“Properties”，打開屬性配置框，選擇“項(xiàng)目數(shù)據(jù)庫連接”。在

27、“數(shù)據(jù)庫連接類型”中選擇要采用的連接類型，不同的連接類型對(duì)應(yīng)的datasource.xml內(nèi)容如下。 配置perties應(yīng)用的日志在UAP項(xiàng)目的WebContentWEB-INFperties文件中配置，默認(rèn)的日志存放路徑是“D:sguap-logclient”，日志級(jí)別是“info”，具體請(qǐng)參考log4j的相關(guān)配置說明。 配置policy.xmlpolicy.xml中配置的是應(yīng)用的策略，在開發(fā)階段，可以通過module-repository節(jié)點(diǎn)來部署模塊項(xiàng)目，以路徑的方式直接指向模塊項(xiàng)目的源代碼。如果有

28、多個(gè)模塊項(xiàng)目位于不同的路徑，可以配置多個(gè)module-repository節(jié)點(diǎn)，但是每個(gè)module-repository節(jié)點(diǎn)的id必須是唯一的，如果兩個(gè)module-repository節(jié)點(diǎn)的id相同，后者會(huì)把前者覆蓋掉。1、雙擊UAP項(xiàng)目的WebContentWEB-INFconfigurationpolicy.xml文件,點(diǎn)擊“應(yīng)用策略配置”標(biāo)簽頁。2、右鍵點(diǎn)擊platform-dynamic-policy，點(diǎn)擊“添”-“module-repositoty”。3、輸入屬性值，path可以通過“打開”按鈕進(jìn)行查找。4、右鍵module-repository選擇“添加”-“module”，添

29、加屬性值。 配置web.xmlUAP開發(fā)平臺(tái)將原web.xml中的servlet、listener、filter以及taglib 拆分到了開發(fā)平臺(tái)的各個(gè)模塊中，用戶只需要關(guān)注的是Version這個(gè)參數(shù)，表示的是當(dāng)前應(yīng)用要采用的UAP開發(fā)平臺(tái)版本。 配置client_include_perties該文件用于配置UAP項(xiàng)目需要啟動(dòng)的平臺(tái)公共套件，統(tǒng)一應(yīng)用開發(fā)平臺(tái)提供以下可選公共套件： gov：系統(tǒng)治理 report：報(bào)表 taskdispatch：任務(wù)調(diào)度 bpm：流程管理 uds：非結(jié)構(gòu)化集成 gis：GIS集成 以上公共套件默認(rèn)不啟動(dòng)，如果要啟

30、動(dòng)這些模塊，需要在此文件中配置公共套件的名稱。如果要啟動(dòng)統(tǒng)一存放在服務(wù)端的業(yè)務(wù)系統(tǒng)模塊，可以在此配置業(yè)務(wù)系統(tǒng)存放的目錄，例如：在服務(wù)端的WEB-INFrepositoryapplication目錄下有一個(gè)子目錄sgerp-app,里面存放的是業(yè)務(wù)系統(tǒng)模塊，如果要啟動(dòng)這些模塊，需要添加子目錄名稱sgerp-app。 配置client_exclude_perties配置在UAP項(xiàng)目中不需要啟動(dòng)的模塊，用戶可以在此文件中排除不相關(guān)的或者不需要的模塊，使應(yīng)用只啟動(dòng)最少的模塊，提高應(yīng)用的啟動(dòng)速度。目前可選的UAP開發(fā)平臺(tái)相關(guān)的模塊包括：com.sgcc.uap.cor

31、e.axis、 com.sgcc.uap.core.xfire、org.apache.cxf，用戶可以根據(jù)應(yīng)用的實(shí)際需要啟動(dòng)或者不啟動(dòng)某些模塊。3.1.3 部署UAP項(xiàng)目1、打開“Servers”視圖，在已經(jīng)創(chuàng)建的Server實(shí)例上右鍵選擇“Add and Remove Projects”2、在彈出的“Add and Remove Projects”對(duì)話框中，雙擊“Available porjects”中的UAP項(xiàng)目，項(xiàng)目出現(xiàn)在“Configured projects”中，點(diǎn)擊“Finish”按鈕完成配置。3.2 模塊項(xiàng)目3.2.1 創(chuàng)建模塊項(xiàng)目1、打開新建項(xiàng)目向?qū)c(diǎn)擊工具欄上的New按鈕，選

32、擇“模塊項(xiàng)目”，也可以選擇菜單欄中的“File-New-模塊項(xiàng)目”2、在打開的模塊項(xiàng)目新建向?qū)е?，輸入模塊項(xiàng)目的名稱，其他選項(xiàng)保持默認(rèn)值。3、點(diǎn)擊“Next”進(jìn)入下一個(gè)向?qū)ы撁妫羞x項(xiàng)保持默認(rèn)值即可。其中： Module Type模塊類型l FullModule：表示模塊既包含Java代碼，又包含Spring配置文件、界面資源；l AppModule：表示模塊僅包含Spring配置文件；l WebModule：表示模塊僅包含界面資源(例如jsp、js、css、jpg、html等等) ；l InterfaceModule：表示模塊僅包含接口類，DM不會(huì)對(duì)一個(gè)接口模塊進(jìn)行除了裝載之外的任何操作；

33、 Start Method啟動(dòng)方式l auto：表示這個(gè)模塊將自動(dòng)啟動(dòng)l lazy：表示這個(gè)模塊將延遲加載l manual：表示這個(gè)模塊需要人工啟動(dòng) Order Num啟動(dòng)順序值越大啟動(dòng)越晚。但延遲加載的模塊無論Order-Num多小，也不可能先于自動(dòng)啟動(dòng)的模塊。4、點(diǎn)擊“Finish”按鈕開始創(chuàng)建模塊項(xiàng)目。新建完成后的模塊項(xiàng)目，包括配置文件MANIFEST.MF和deploy.xml3.2.2 配置模塊項(xiàng)目 配置MANIFEST.MF雙擊META-INFMANIFEST.MF，打開模塊配置文件編輯器，編輯器中包括Overview、Dependencies、Runtime、Bui

34、ld、MANIFEST.MF、perties等6個(gè)選項(xiàng)卡。Dependencies選項(xiàng)，添加模塊依賴關(guān)系。模塊依賴有兩種粒度， Required Plug-ins表示依賴整個(gè)模塊，Import-Packages表示依賴的包。點(diǎn)擊Required Plug-ins的Add按鈕，彈出Plug-in Selection對(duì)話框，輸入輸入要依賴的其他模塊的名稱。模塊項(xiàng)目默認(rèn)已經(jīng)添加了對(duì)UAP開發(fā)平臺(tái)com.sgcc.uap.core、com.sgcc.uap.kernel、com.sgcc.uap.core.webtlds、com.sgcc.uap.mxframework等模塊的依賴。

35、Import-Packages部分默認(rèn)已經(jīng)添加了對(duì)javax.servlet、 javax.servlet.http、mons.beanutils、mons.lang.builder等包的依賴?！咀ⅲ翰荒芡ㄟ^Required Plug-ins添加對(duì)javax.servlet和javax.servlet.jsp模塊的依賴，只能在Import-Packages中添加對(duì)javax.servlet相關(guān)Package的依賴?！縍untime選項(xiàng)，配置運(yùn)行時(shí)的Classpath。在模型項(xiàng)目的根目錄下創(chuàng)建一個(gè)lib目錄，把要依賴的jar文件放到lib目

36、錄下。在Runtime選項(xiàng)卡的Classpath部分，點(diǎn)擊Add按鈕，把lib目錄下的所有jar文件都添加進(jìn)來。點(diǎn)擊MANIFEST.MF選項(xiàng)卡，顯示的是MANIFEST.MF文件的具體內(nèi)容，其中包括在模塊項(xiàng)目新建向?qū)е信渲玫乃袃?nèi)容。 配置deploy.xml打開模塊項(xiàng)目的deploy.xml文件，默認(rèn)內(nèi)容如下：bundle-context-path：指定的是當(dāng)前模塊的上下文路徑，默認(rèn)值為模塊項(xiàng)目的名稱，每個(gè)模塊的上下文路徑必須是唯一的。use-platform-component：配置當(dāng)前模塊是否需要使用UAP開發(fā)平臺(tái)提供的默認(rèn)展現(xiàn)和邏輯構(gòu)件。3.2.3 開發(fā)模塊項(xiàng)目3.2.

37、3.1 添加依賴關(guān)系如果某個(gè)模塊要引用其他模塊的類，需要打開META-INFMANIFEST.MF文件，在Dependencies選項(xiàng)卡里添加依賴關(guān)系。模塊添加依賴有兩種粒度，一種是Required Plug-ins表示依賴整個(gè)模塊，Import-Packages表示依賴某個(gè)包。 發(fā)布引用服務(wù)模塊與模塊之間的交互除了上述Java代碼之間的依賴之外，還可以通過服務(wù)的發(fā)布與引用來交互。 發(fā)布服務(wù)先將本模塊的某個(gè)功能定義成Spring Bean，再通過module:service把這個(gè)功能發(fā)布為OSGi服務(wù)供其他模塊調(diào)用。 引用服務(wù)將其他模塊聲明的OSGi服務(wù)引入到本模塊中來，引用的服

38、務(wù)可以當(dāng)作本模塊的Spring Bean一樣使用。 自定義servlet、filter、listener在模塊化環(huán)境下， servlet、filter、listener在各個(gè)模塊中單獨(dú)定義。定義方式如下所示。 module:servletfilter標(biāo)簽，功能同web.xml中的filter標(biāo)簽。BspAuthenticationFilterorg.uap.bsp.permit.pep.util.FilterToBeanProxy/j_bsp_security_check/*targetBeanauthFilter module:servlet標(biāo)簽，功能同web.xml中的ser

39、vlet標(biāo)簽。BspSessionServletorg.uap.bsp.permit.pep.util.ServletToProxy/j_bsp_security_check/*targetBeansessionServlet module:servletlistener標(biāo)簽，功能同web.xml中的listener標(biāo)簽。org.uap.bsp.permit.audit.online.listener.SessionListener 添加對(duì)第三方Jar包的依賴如果某個(gè)模塊需要依賴第三方的Jar包，可以在模塊內(nèi)添加對(duì)Jar包的依賴。但是如果有多個(gè)模塊都要依賴某些Jar包，可以考慮把

40、這些Jar包包裝成一個(gè)公共的模塊。在模型項(xiàng)目的根目錄下創(chuàng)建一個(gè)lib目錄，把要依賴的jar文件放到lib目錄下雙擊打開META-INFMANIFEST.MF文件，打開Runtime選項(xiàng)卡，在Classpath部分，點(diǎn)擊Add按鈕，把lib目錄下的所有jar文件都添加進(jìn)來。3.2.4 部署模塊項(xiàng)目雙擊META-INFMANIFEST.MF，打開模塊配置文件編輯器，其中Runtime選項(xiàng)卡的Export-Packages是與Dependencies選項(xiàng)卡的Import-Packages想對(duì)應(yīng)的，表示當(dāng)前模塊要對(duì)外暴露的包，點(diǎn)擊Add可以選擇本模塊要對(duì)外暴露的包，只有對(duì)外暴露的包才能被其他模塊訪問點(diǎn)

41、擊模塊配置文件編輯器的Build選項(xiàng)卡，其中Binary Build中配置的是把模塊打成Jar包時(shí)要包括的內(nèi)容，勾選需要包括在Jar包中的文件模塊項(xiàng)目的部署有兩種方式，一種是配置文件可視化方式，一種是jar包的方式。開發(fā)階段建議采用配置文件可視化方式部署；集成測(cè)試階段建議采用jar包方式部署。 配置文件可視化方式部署配置文件可視化方式部署的過程，詳見.3配置policy.xml。 Jar包方式部署1、選擇模塊項(xiàng)目，右鍵選擇“UAP-發(fā)布模塊項(xiàng)目”2、在打開的模塊項(xiàng)目對(duì)話框中，將列出所有的UAP項(xiàng)目，選擇要把模塊項(xiàng)目部署到哪個(gè)UAP項(xiàng)目中，點(diǎn)擊“OK”按

42、鈕確定。3、如果之前已經(jīng)發(fā)布過該模塊項(xiàng)目，將彈出對(duì)話框詢問是否刪除舊的版本，點(diǎn)擊“是”按鈕進(jìn)行確認(rèn)(如果UAP項(xiàng)目處于啟動(dòng)狀態(tài)則舊版本不能刪除)。4、隨后將彈出發(fā)布模塊項(xiàng)目的進(jìn)度條。5、模塊部署目錄：WebContentWEB-INFrepositoryapplicationplugins。3.2.5 調(diào)試模塊項(xiàng)目1、雙擊“Server視圖”中的“Tomcat 6 at localhost”，將會(huì)打開Tomcat Server編輯器，顯示的是“Overview”選項(xiàng)卡。2、找到“General Information”部分，點(diǎn)擊“Open launch configuration”將打開Tom

43、cat運(yùn)行配置屬性對(duì)話框。3、點(diǎn)擊“Source”選項(xiàng)卡，點(diǎn)擊“Add”按鈕4、在彈出的“Add Source”對(duì)話框中，選擇“Java Project”，點(diǎn)擊“OK”按鈕。5、在彈出的“Project Selection”對(duì)話框中，選擇需要調(diào)試的模塊項(xiàng)目，點(diǎn)擊“OK”按鈕。6、回到Tomcat運(yùn)行配置屬性對(duì)話框，點(diǎn)擊“Apply”按鈕保持設(shè)置，點(diǎn)擊“OK”按鈕關(guān)閉對(duì)話框。7、設(shè)置完Tomcat運(yùn)行配置屬性后，回到Tomcat Server編輯器，找到“Publish”，勾選“Automatically publish when resource change”。8、點(diǎn)擊Tomcat Serv

44、er編輯器的“Modules”選項(xiàng)卡，點(diǎn)擊“Edit”按鈕9、在彈出的對(duì)話框中勾選“Auto reloading enabled”，點(diǎn)擊“OK”按鈕關(guān)閉對(duì)話框。10、此時(shí)Tomcat Server編輯器上方會(huì)顯示一個(gè)“*”表示被修改過需要保存，點(diǎn)擊工具欄上的保存按鈕保存設(shè)置。11、選擇“Servers”視圖右上方的Debug按鈕，以調(diào)試模式啟動(dòng)應(yīng)用。12、在模塊項(xiàng)目的Java代碼中設(shè)置斷點(diǎn)，訪問應(yīng)用時(shí)就會(huì)打開調(diào)試透視圖，可以在此透視圖中進(jìn)行調(diào)試。在調(diào)試過程中，修改Java代碼中類的某個(gè)方法能立即生效。但是，在模塊項(xiàng)目中新增類或者在類中新增方法，是無法立即生效的，需要使用updm命令才能生效。通

45、過Studio提供的編輯器修改工作空間中模塊項(xiàng)目的頁面資源文件（包括jsp、js、css、html、tld等），可以立即生效，刷新瀏覽器就能看到效果。但是，新增、刪除、覆蓋文件，或者通過Studio之外的編輯器修改這些文件，例如：通過Windows的畫圖工具或者Photoshop修改圖片文件，上述這些修改不能直接生效，需要使用updm命令才能生效。3.3 擴(kuò)展模塊項(xiàng)目3.3.1 新建擴(kuò)展模塊打開新建項(xiàng)目向?qū)c(diǎn)擊工具欄上的New按鈕，選擇“擴(kuò)展模塊項(xiàng)目”，也可以選擇菜單欄中的“File-New-擴(kuò)展模塊項(xiàng)目”。輸入擴(kuò)展模塊的名稱，“Target Platform”的“an OSGi framew

46、ork”選項(xiàng)的默認(rèn)值為“Equinox”。點(diǎn)擊“Next”，進(jìn)入下一步。點(diǎn)擊“Next”，進(jìn)入下一步。點(diǎn)擊“Host Plug-in”中“Plug-in ID”輸入框后面的“Browser”按鈕，選擇一個(gè)主模塊，主模塊就是被擴(kuò)展的模塊。每個(gè)主模塊只能有一個(gè)擴(kuò)展模塊，啟動(dòng)應(yīng)用后在控制臺(tái)輸入ss命令可以查看主模塊有幾個(gè)擴(kuò)展模塊。請(qǐng)確保一個(gè)主模塊只有一個(gè)擴(kuò)展模塊，否則如果兩個(gè)擴(kuò)展模塊都擴(kuò)展了主模塊的同一個(gè)文件，那么系統(tǒng)只能隨機(jī)的加載一個(gè)擴(kuò)展模塊中的文件，另一個(gè)擴(kuò)展模塊中的文件將不會(huì)生效。選擇完主模塊之后，點(diǎn)擊“OK”按鈕。點(diǎn)擊“Finish”按鈕，完成擴(kuò)展模塊的創(chuàng)建。3.3.2 配置擴(kuò)展模塊打開擴(kuò)展

47、模塊的META-INFMANIFEST.MF文件，可以對(duì)擴(kuò)展模塊進(jìn)行配置。擴(kuò)展模塊如果需要修改主模塊deploy.xml，可以添加deploy.xml文件進(jìn)行修改。3.3.3 開發(fā)擴(kuò)展模塊把主模塊中的文件按照原有目錄結(jié)構(gòu)放置在擴(kuò)展模塊中。例如，如果我們要對(duì)擴(kuò)展模塊FraProject中的logig.jsp文件和登錄頁面上的圖片進(jìn)行修改，首先要知道jsp和圖片在擴(kuò)展模塊FraProject中的路徑facejsplogin.jsp 和facejspimageslogin_b.jpg。然后就按照facejsplogin.jsp 和facejspimageslogin_b.jpg的路徑放置修改過的lo

48、gig.jsp和login_b.jpg文件。3.3.4 部署擴(kuò)展模塊在擴(kuò)展模塊的配置文件中，選擇Build選項(xiàng)卡，在Binary Build中勾選需要打入jar包中的目錄和文件。擴(kuò)展模塊項(xiàng)目和模塊項(xiàng)目一樣，有兩種部署方式，一種是通過policy.xml配置文件來部署，另一種是把模塊項(xiàng)目直接發(fā)布到“WebContentWEB-INFrepositoryapplicationplugins”目錄下。4 模型驅(qū)動(dòng)4.1 模型驅(qū)動(dòng)概述在UAP中，模型驅(qū)動(dòng)主要實(shí)現(xiàn)業(yè)務(wù)模型的可視化管理以及基于模型生成代碼等功能。具體包含如下功能：1、 創(chuàng)建、編輯及刪除業(yè)務(wù)實(shí)體、枚舉、業(yè)務(wù)實(shí)體之間的關(guān)聯(lián)關(guān)系2、 在大綱視圖中展示和編輯模型3、 跨模塊（OM）引用業(yè)務(wù)實(shí)體4、 在屬性視圖中展示盒編輯業(yè)務(wù)對(duì)象的屬性5、 從數(shù)據(jù)庫中反向?qū)肽Ｐ?、 代碼生成7、 模型查詢8、 模型校驗(yàn)4.2 模型驅(qū)動(dòng)界面介紹4.2.1 設(shè)計(jì)器界面設(shè)計(jì)器界面包括工具箱、工具條和工作區(qū)，如下圖。 工具箱工具箱分類提供業(yè)務(wù)對(duì)象建模所需的對(duì)象，以拖拽的方式在工作區(qū)中新建對(duì)應(yīng)對(duì)象，包括業(yè)務(wù)實(shí)體、枚舉、注釋、1對(duì)1、1對(duì)多、多對(duì)1、多對(duì)多、連線，新建對(duì)象時(shí)可從工具箱拖動(dòng)對(duì)象到工作區(qū)；新建關(guān)系時(shí)點(diǎn)擊一個(gè)關(guān)系，依次單擊關(guān)系的兩端創(chuàng)建關(guān)系。 工具條工具條提供Undo、Redo、刪除、復(fù)制、