sg-uap v3.00使用手冊分冊9集成開發(fā)工具微服務(wù)

SG-UAPSG-UAP手引 概 0 SG-UAPIDE安 SG-UAPIDE的運(yùn) 開發(fā)指 微服務(wù)MXWeb端開 創(chuàng)建微服務(wù)MVVMWeb項(xiàng) 通過SG-UAPIDE向?qū)Т? 配 SG-UAPSG-UAP手第第0頁90引概本文以案例代碼貫穿全文通過第二章第三章內(nèi)容達(dá)到快速了解SG-UAP平過程，該章節(jié)針對平臺的微服務(wù)項(xiàng)目創(chuàng)建、微服務(wù)網(wǎng)關(guān)項(xiàng)目創(chuàng)建、微服務(wù)Web項(xiàng)API適用范名說SG-國家電網(wǎng)統(tǒng)一應(yīng)用平臺StateGridUnifiedApplicationSG-UAPSG-UAP（SG-UAPDevelopmentSG-UAPSG-UAP手第第PAGE1090微服務(wù)Web項(xiàng)目WebMicroserviceObjectModelWebuiMOM依賴于統(tǒng)一應(yīng)用平臺服務(wù)端標(biāo)準(zhǔn)的空的Java1-3-1開發(fā)環(huán)境部平臺獲業(yè)務(wù)項(xiàng)目組按照《平臺管理辦法實(shí)施細(xì)則》規(guī)定，按照平臺使用申請 SG-UAPIDEUAPStudio-3.0.exenextSG-UAPIDE。SG-UAPIDE運(yùn)在SG-UAPIDE中，找elipse 下的UAPStudio.exe文件，選擇合適的工作空間，即可運(yùn)行SG-UAPIDE，進(jìn)入后界面如圖2-1所示：2-1SG-UAPIDE庫的相關(guān)資料安裝并啟動數(shù)據(jù)庫，以數(shù)據(jù)庫管理員的登陸數(shù)據(jù)庫，為微服務(wù)應(yīng)用項(xiàng)目創(chuàng)建用戶信息，并執(zhí)行初始化建庫。開發(fā)指環(huán)境配jdk環(huán)jdk1.8gradle環(huán)安裝在Gradle官網(wǎng)上gradle安裝包，解壓到本地，并配置其環(huán)境變量配置UAP的gradle步驟在UAP的Window->Preferences-Gradle(STS)中配置gradle的安 3-1-1UAP步驟2：在UAP的Window->Preferences-Gradle(EnIDE)gradle的安裝目3-1-2UAP微應(yīng)用開發(fā)流如圖3-2-3所示，微應(yīng)用開發(fā)的流程大致為：首先根據(jù)業(yè)務(wù)需求開發(fā)MOM模MOM模型分別開發(fā)微服務(wù)前端和后端，并進(jìn)開發(fā)MOM3-2-3MOM開MOMMOM模型項(xiàng)MOM模型項(xiàng)目上，開發(fā)人員通過平臺提供的向?qū)А拔⒎?wù)業(yè)務(wù)對象建?！焙汀拔⒎?wù)數(shù)據(jù)庫反向建?！眲?chuàng)建MOM模型，并設(shè)計(jì)。創(chuàng)建MOM點(diǎn)擊上的New按鈕，選擇“微應(yīng)用->MOM模型項(xiàng)目”，也可以選擇菜單欄中的“File>New>Other->微應(yīng)用->MOM3-3-13-3-1OM“Next“FinishMOM3-3-2MOMMOM模型項(xiàng) 結(jié)構(gòu)如圖3-3-3所示 MOM模型項(xiàng)目 結(jié)3-3-1MOM文件/文件作數(shù)據(jù)源，可以多個數(shù)據(jù)MOM3-3-1MOM模型項(xiàng)目中各個文件/創(chuàng)建MOM模MOMMOM模型有兩種方式：微服務(wù)業(yè)務(wù)對象建模和微微服務(wù)業(yè)務(wù)對象建點(diǎn)擊上的New按鈕，選擇菜單欄中的“File->New->Other->微應(yīng)“Next3-3-4點(diǎn)擊“瀏覽…”選擇一個MOMMOM3-53-3-53-3-63-3-6MOMFinish3-3-73-3-7MOMMOMMOM模型（MOMOM模型微服務(wù)數(shù)據(jù)庫反向建點(diǎn)擊上的New按鈕，選擇菜單欄中的“File->New->Other->微應(yīng)3-3-83-3-8選擇MOM項(xiàng)目。點(diǎn)擊“瀏覽..”按鈕，選擇MOM3-3-93-3-9MOM4。3-3-10輸入數(shù)據(jù)源參數(shù)，包括數(shù)據(jù)源名稱、數(shù)據(jù)庫類型、數(shù)據(jù)庫ID（數(shù)據(jù)庫名稱、服務(wù)器地址（ip或主機(jī)名稱、端口、用戶名和，如圖3-3-11所3-3-11OK3-123-3-123-3-133-3-13Next3-3-14Next3-3-15如圖3-3-16所示如果要MOM文件新建mom轉(zhuǎn)到6；mom3-3-16“Next圖3-3-17設(shè)置新建mom名空間、模型名稱、顯示名模型，點(diǎn)擊“Next3-3-18MOM3-3-19Next”3-3-193-3-203-3-203-3-213-3-21Finish3-3-22MOMMOM3-3-233-3-23MOM設(shè)計(jì)MOM模MOMOMOM服務(wù)業(yè)務(wù)模型設(shè)計(jì)器上的“代碼生成”按鈕，生成所需的業(yè)務(wù)代碼，必要創(chuàng)建微服務(wù)主項(xiàng)點(diǎn)擊上的New按鈕選擇“微應(yīng)用->微服務(wù)主項(xiàng)目”，點(diǎn)“Next，也可以選擇菜單欄中的“File->New3-4-13-4-13-4-23-4-2點(diǎn)擊Finish按鈕，生成項(xiàng)目 結(jié)構(gòu)，如圖3-4-3所示圖3-4-3微服務(wù)主項(xiàng) 3-4-1文件/文件作uapjarpublibjarpubbuild.gradlejaruapjar3-4-1微服務(wù)主項(xiàng)目中的各個文件/創(chuàng)建微服務(wù)項(xiàng)“Next3-4-43-4-43-4-53-4-53-4-63-4-6Next3-4-7Next3-4-8Finish，3-4-93-4-9點(diǎn)擊“AddDataSource”按鈕，打開新建數(shù)據(jù)庫連接框，選擇對應(yīng)的數(shù)據(jù)庫類型（當(dāng)前示例選擇“Mysql）3-4-103-4-10 打開數(shù)據(jù)庫驅(qū)選擇驅(qū)動.示例中選中“MySQLJDBCDriverMySQL5.1“OK”按鈕，3-4-123-4-12在框中輸入數(shù)據(jù)庫ID、主機(jī)名、端、用戶名、，并勾選“Savepassword（3-4-13點(diǎn)擊“TestConnection”對數(shù)據(jù)庫連接進(jìn)試，如果測試成功，會彈出提 框，如圖3-4-14所示：3-4-14數(shù)據(jù)庫連接 結(jié)構(gòu)，如圖3-4-15所示：圖3-4-15新建微服務(wù)項(xiàng)目 結(jié)3-4-2文件/文件作據(jù)3-4-2微服務(wù)項(xiàng)目中的各個文件/生成微服務(wù)場景代通過“微服務(wù)場景代碼”向?qū)纱?-4-163-4-16MOM（MOM3.33-4-173-4-17微服務(wù)場景代碼-選擇MOM設(shè)置包括生成代碼存放位置（根、包路徑和數(shù)據(jù)庫相關(guān)內(nèi)容等，如圖3-4-3-4-18微服務(wù)場景代碼-3-4-193-4-19微服務(wù)場景代碼-點(diǎn)擊“Finish”3-4-203-4-20微服務(wù)場景代碼-3-4-3文作當(dāng)前場景（product）實(shí)體類POVO數(shù)據(jù)接場景（product）ddl3-4-3通過“微服務(wù)業(yè)務(wù)模型設(shè)計(jì)器”上的“代碼生成”按鈕生成代 上的“代碼生成”按鈕，如圖3-4-21所示：5-5-21選擇微服務(wù)項(xiàng)目在彈出的框上選擇生成代碼的目標(biāo)微服務(wù)項(xiàng)目，3-4-225-5-22置包括生成代碼存放位置（根3-4-233-4-233-4-243-4-24Finish3-4-253-4-25對微服務(wù)進(jìn)行必要的配置。本小結(jié)只介紹必要的配置，需要修改的文件有Aperties。配置Application.javaApplication.java3-4-26 2，scanBasePackages.3-4-27 3-4-283-4-28applicationWebUAPIDE提供了兩種微服務(wù)的Web項(xiàng)目：MXWeb項(xiàng)目和MVVMWeb項(xiàng)目。下面分別介紹如何創(chuàng)建微服務(wù)MXWeb項(xiàng)目和創(chuàng)建微服務(wù)MVVMWeb項(xiàng)目其中UAPIDEMXWebMXWeb開創(chuàng)建MXWeb目過點(diǎn)擊上的New按鈕，選擇“微應(yīng)用->MXWeb項(xiàng)目”，也可以選擇菜單欄中的“File>New->Other->微應(yīng)用->MXWeb“Next”按3-5-13-5-1WebMXWeb點(diǎn)擊“Finish”,MXWeb3-5-23-5-3MXWeb設(shè)置編譯java應(yīng)用后生成的文件輸出 如圖3-5-4所示：3-5-4設(shè)置MXWeb項(xiàng)目上下文根 “Finish，成MXWeb項(xiàng)目的創(chuàng)建。如圖3-5-5所示：3-5-5MXWebMXWeb項(xiàng)目 結(jié)構(gòu)如圖3-5-6所示 MXWeb項(xiàng)目 結(jié)3-5-1MXWeb文件/文件作3-5-1MXWeb項(xiàng)目各個文件/生成微服務(wù)前端mui及前端MX代UAPMXWebmuimuiMX代碼，用戶可以通MXUAPIDE提供的，各種場景（單表、主從表、樹）界面模板，生成mui模型及前端MX代碼。全新創(chuàng)建空白界面MXWeb“File-->Other->微應(yīng)用->微服務(wù)界面模型（*.mui）”,3-5-73-5-7“Finish3-5-83-5-8mui3-5-93-5-9mui根據(jù)場景模板創(chuàng)單表場選中當(dāng)前工作空間的一個MXWeb項(xiàng)目，選擇菜單欄中的“File-->Other->微應(yīng)用->微服務(wù)界面模型（*.mui）”,3-5-103-5-10選擇MOM項(xiàng)目。點(diǎn)擊“選擇”按鈕，選擇一個MOM模型項(xiàng)目（如果當(dāng)前工作空間沒有MOM模型項(xiàng)目則需要MOM模型并在MOM項(xiàng)目下MOM3.4，點(diǎn)擊“OK3-5-11MOMNext3-5-12 mui模型向?qū)?mui模型信息設(shè) 框）和表格+表單，，，“Next3-5-13Next3-5-143-5-143-5-153-5-15編輯表格數(shù)據(jù)源-過濾列選擇，即設(shè)置表格上的查詢條件，默認(rèn)沒有過濾的列，可以通過右側(cè)3-5-163-5-16編輯表格數(shù)據(jù)源-過濾列選擇NextGroupBox3-5-173-5-17“Finish

3-5-18mui選中當(dāng)前工作空間的一個MXWeb項(xiàng)目，選擇菜單欄中的“File-->Other->微應(yīng)用->微服務(wù)界面模型（*.mui）”,3-5-193-5-19選擇MOM項(xiàng)目。點(diǎn)擊“選擇”按鈕，選擇一個MOM模型項(xiàng)目（如果當(dāng)前工作空間沒有MOM模型項(xiàng)目則需要MOM模型并在MOM項(xiàng)目下MOM3.4，點(diǎn)擊“OK3-5-20MOMNext3-5-21 mui模型向?qū)?mui模型信息設(shè)“Next3-5-223-5-233-5-23選擇場景數(shù)據(jù)源-，點(diǎn)擊“Next243-5-24選擇場景數(shù)據(jù)源-3-5-253-5-25編輯表格數(shù)據(jù)源-3-5-263-5-26編輯表格數(shù)據(jù)源-過濾列選擇NextGroupBox3-5-273-5-27“Finish3-5-28mui配置MXWeb根據(jù)“界面模型”向?qū)?，?chuàng)建mui模型及前端代碼后，為了MXWeb項(xiàng)目能夠正常運(yùn)行，還需要在conf/config.js文件中配置一下網(wǎng)關(guān)地址，如圖3-5-29所3-5-29MXWebMVVMWeb點(diǎn)擊上的New按鈕，選擇“微應(yīng)用->MVVMWeb項(xiàng)目”，也可以選擇MVVMWeb3-5-303-5-30MVVMWebMVVMWeb 新建MVVMWeb項(xiàng)點(diǎn)擊“Finish”,MVVMWeb3-5-32MVVMWeb微服務(wù)項(xiàng)目打包提供兩種方式：通過SG-UAPIDE使用向?qū)У男问竭M(jìn)行批 下，使用相應(yīng)令進(jìn)行批量、單獨(dú)打通過SG-UAPIDE批量打SG-UAPIDERunasGradle（STS）Build…”,3-6-1：3-6-1“build3-6-2ArgumentsJRE，3-6-3-6-3Run”按鈕，每個微服務(wù)將打包后的jar文件放置到相應(yīng)的 單獨(dú)打SG-UAPIDERun然后點(diǎn)擊向?qū)А癎radle（STS）Build…”,3-6-4：3-6-4“build3-6-5ArgumentsJRE，3-6-3-6-6通過命令打批量打gradlebuildjarbuild/libs下。單獨(dú)打 ，打開命令行，執(zhí)行g(shù)radlebuild命令，jar文件將放到build/libs 開發(fā)示product表的創(chuàng)建表的sql語句createcreatetablePRODUCTIDvarchar(192)notnullcomment'id',PRODUCT_MODELtextcomment'product_model',PRODUCT_NAMEtextcomment'product_name',PART_DRAWING_NUMBERtextcomment'part_drawing_number',PART_NAMEtextcomment'part_name',MATERIAL_TRADEMARKtextcomment'material_trademark',MATERIAL_TYPEtextcomment'material_type',MATERIAL_SPECtextcomment'material_spec',SINGLE_NUMBERdoubleprecisioncomment'single_number',BLANK_DIMENSIONfloatcomment'blank_dimension',SUIT_NUMBERdoubleprecisioncomment'suit_number',BLE_NUMBERdoubleprecisioncomment primarykey)創(chuàng)建項(xiàng)目及模按照3.2的微應(yīng)用開發(fā)流程3.3.1創(chuàng)建MOM模型項(xiàng)目，參照創(chuàng)建與product表相對應(yīng)的MOM模型com.sgcc.uap.test23.4.1創(chuàng)建微服務(wù)主建MXWebMOMMOM3-7-13-7-.33-7-2所3-7-3-7-33-7-3配微服務(wù)microservice1配3.4.4對microservice1Aperties3-7-53-7-5CorsConfig.java@Configuration3-7-6所MxWebTest項(xiàng)目配對MxWebTest3-7-7部署啟啟動微服務(wù)右鍵，再點(diǎn)擊run/debug->JavaApplication3-7-8所示：3-7-8部署并啟動MxWebTest項(xiàng)和普通JavaWebMxWebTest項(xiàng)目部署到UAPIDE3-7-9聯(lián)調(diào)測在瀏覽器中輸 3-7-10圖3-7-10結(jié)ApplicationUAP上的啟動按鈕，或者右鍵選擇rundebug3-8-1所示：3-8-1如何部署、啟動MXWeb項(xiàng)目、MVVMMXWeb項(xiàng)目和MVVM項(xiàng)目實(shí)際上都是JavaWeb項(xiàng)目，部署、啟動的方法和普通JavaWeb項(xiàng)目相同。開發(fā)測試階段，如何簡單地實(shí)現(xiàn)微服務(wù)和WebCorsConfig.java中@Configuration注解前的注釋去掉，并MXWebconf/config.jsgatewayURL配置為待測試微服3-8-2所示：3-8-2最后，將MXWeb項(xiàng)目部署到tomcat新建一張自關(guān)聯(lián)的表，其sql如下alteraltertableforeignkeydroptableifexistscreatetableTESTTREEIDbigintnotnullcomment'id',parent_idbigint,NAMEvarchar(255)commentprimarykey)alteraltertableaddindexFK_Testtree_Testtree_parentidaddconstraintforeignkeyreferencesTESTTREESG-UAPIDE