sg-uap v3.00使用手册分册9集成开发工具微服务

SG-UAPSG-UAP手引 概 0 SG-UAPIDE安 SG-UAPIDE的运 开发指 微服务MXWeb端开 创建微服务MVVMWeb项 通过SG-UAPIDE向导打 配 SG-UAPSG-UAP手第第0页90引概本文以案例代码贯穿全文通过第二章第三章内容达到快速了解SG-UAP平过程，该章节针对平台的微服务项目创建、微服务网关项目创建、微服务Web项API适用范名说SG-国家电网统一应用平台StateGridUnifiedApplicationSG-UAPSG-UAP（SG-UAPDevelopmentSG-UAPSG-UAP手第第PAGE1090微服务Web项目WebMicroserviceObjectModelWebuiMOM依赖于统一应用平台服务端标准的空的Java1-3-1开发环境部平台获业务项目组按照《平台管理办法实施细则》规定，按照平台使用申请 SG-UAPIDEUAPStudio-3.0.exenextSG-UAPIDE。SG-UAPIDE运在SG-UAPIDE中，找elipse 下的UAPStudio.exe文件，选择合适的工作空间，即可运行SG-UAPIDE，进入后界面如图2-1所示：2-1SG-UAPIDE库的相关资料安装并启动数据库，以数据库管理员的登陆数据库，为微服务应用项目创建用户信息，并执行初始化建库。开发指环境配jdk环jdk1.8gradle环安装在Gradle官网上gradle安装包，解压到本地，并配置其环境变量配置UAP的gradle步骤在UAP的Window->Preferences-Gradle(STS)中配置gradle的安 3-1-1UAP步骤2：在UAP的Window->Preferences-Gradle(EnIDE)gradle的安装目3-1-2UAP微应用开发流如图3-2-3所示，微应用开发的流程大致为：首先根据业务需求开发MOM模MOM模型分别开发微服务前端和后端，并进开发MOM3-2-3MOM开MOMMOM模型项MOM模型项目上，开发人员通过平台提供的向导“微服务业务对象建模”和“微服务数据库反向建模”创建MOM模型，并设计。创建MOM点击上的New按钮，选择“微应用->MOM模型项目”，也可以选择菜单栏中的“File>New>Other->微应用->MOM3-3-13-3-1OM“Next“FinishMOM3-3-2MOMMOM模型项 结构如图3-3-3所示 MOM模型项目 结3-3-1MOM文件/文件作数据源，可以多个数据MOM3-3-1MOM模型项目中各个文件/创建MOM模MOMMOM模型有两种方式：微服务业务对象建模和微微服务业务对象建点击上的New按钮，选择菜单栏中的“File->New->Other->微应“Next3-3-4点击“浏览…”选择一个MOMMOM3-53-3-53-3-63-3-6MOMFinish3-3-73-3-7MOMMOMMOM模型（MOMOM模型微服务数据库反向建点击上的New按钮，选择菜单栏中的“File->New->Other->微应3-3-83-3-8选择MOM项目。点击“浏览..”按钮，选择MOM3-3-93-3-9MOM4。3-3-10输入数据源参数，包括数据源名称、数据库类型、数据库ID（数据库名称、服务器地址（ip或主机名称、端口、用户名和，如图3-3-11所3-3-11OK3-123-3-123-3-133-3-13Next3-3-14Next3-3-15如图3-3-16所示如果要MOM文件新建mom转到6；mom3-3-16“Next图3-3-17设置新建mom名空间、模型名称、显示名模型，点击“Next3-3-18MOM3-3-19Next”3-3-193-3-203-3-203-3-213-3-21Finish3-3-22MOMMOM3-3-233-3-23MOM设计MOM模MOMOMOM服务业务模型设计器上的“代码生成”按钮，生成所需的业务代码，必要创建微服务主项点击上的New按钮选择“微应用->微服务主项目”，点“Next，也可以选择菜单栏中的“File->New3-4-13-4-13-4-23-4-2点击Finish按钮，生成项目 结构，如图3-4-3所示图3-4-3微服务主项 3-4-1文件/文件作uapjarpublibjarpubbuild.gradlejaruapjar3-4-1微服务主项目中的各个文件/创建微服务项“Next3-4-43-4-43-4-53-4-53-4-63-4-6Next3-4-7Next3-4-8Finish，3-4-93-4-9点击“AddDataSource”按钮，打开新建数据库连接框，选择对应的数据库类型（当前示例选择“Mysql）3-4-103-4-10 打开数据库驱选择驱动.示例中选中“MySQLJDBCDriverMySQL5.1“OK”按钮，3-4-123-4-12在框中输入数据库ID、主机名、端、用户名、，并勾选“Savepassword（3-4-13点击“TestConnection”对数据库连接进试，如果测试成功，会弹出提 框，如图3-4-14所示：3-4-14数据库连接 结构，如图3-4-15所示：图3-4-15新建微服务项目 结3-4-2文件/文件作据3-4-2微服务项目中的各个文件/生成微服务场景代通过“微服务场景代码”向导生成代3-4-163-4-16MOM（MOM3.33-4-173-4-17微服务场景代码-选择MOM设置包括生成代码存放位置（根、包路径和数据库相关内容等，如图3-4-3-4-18微服务场景代码-3-4-193-4-19微服务场景代码-点击“Finish”3-4-203-4-20微服务场景代码-3-4-3文作当前场景（product）实体类POVO数据接场景（product）ddl3-4-3通过“微服务业务模型设计器”上的“代码生成”按钮生成代 上的“代码生成”按钮，如图3-4-21所示：5-5-21选择微服务项目在弹出的框上选择生成代码的目标微服务项目，3-4-225-5-22置包括生成代码存放位置（根3-4-233-4-233-4-243-4-24Finish3-4-253-4-25对微服务进行必要的配置。本小结只介绍必要的配置，需要修改的文件有Aperties。配置Application.javaApplication.java3-4-26 2，scanBasePackages.3-4-27 3-4-283-4-28applicationWebUAPIDE提供了两种微服务的Web项目：MXWeb项目和MVVMWeb项目。下面分别介绍如何创建微服务MXWeb项目和创建微服务MVVMWeb项目其中UAPIDEMXWebMXWeb开创建MXWeb目过点击上的New按钮，选择“微应用->MXWeb项目”，也可以选择菜单栏中的“File>New->Other->微应用->MXWeb“Next”按3-5-13-5-1WebMXWeb点击“Finish”,MXWeb3-5-23-5-3MXWeb设置编译java应用后生成的文件输出 如图3-5-4所示：3-5-4设置MXWeb项目上下文根 “Finish，成MXWeb项目的创建。如图3-5-5所示：3-5-5MXWebMXWeb项目 结构如图3-5-6所示 MXWeb项目 结3-5-1MXWeb文件/文件作3-5-1MXWeb项目各个文件/生成微服务前端mui及前端MX代UAPMXWebmuimuiMX代码，用户可以通MXUAPIDE提供的，各种场景（单表、主从表、树）界面模板，生成mui模型及前端MX代码。全新创建空白界面MXWeb“File-->Other->微应用->微服务界面模型（*.mui）”,3-5-73-5-7“Finish3-5-83-5-8mui3-5-93-5-9mui根据场景模板创单表场选中当前工作空间的一个MXWeb项目，选择菜单栏中的“File-->Other->微应用->微服务界面模型（*.mui）”,3-5-103-5-10选择MOM项目。点击“选择”按钮，选择一个MOM模型项目（如果当前工作空间没有MOM模型项目则需要MOM模型并在MOM项目下MOM3.4，点击“OK3-5-11MOMNext3-5-12 mui模型向导-mui模型信息设 框）和表格+表单，，，“Next3-5-13Next3-5-143-5-143-5-153-5-15编辑表格数据源-过滤列选择，即设置表格上的查询条件，默认没有过滤的列，可以通过右侧3-5-163-5-16编辑表格数据源-过滤列选择NextGroupBox3-5-173-5-17“Finish

3-5-18mui选中当前工作空间的一个MXWeb项目，选择菜单栏中的“File-->Other->微应用->微服务界面模型（*.mui）”,3-5-193-5-19选择MOM项目。点击“选择”按钮，选择一个MOM模型项目（如果当前工作空间没有MOM模型项目则需要MOM模型并在MOM项目下MOM3.4，点击“OK3-5-20MOMNext3-5-21 mui模型向导-mui模型信息设“Next3-5-223-5-233-5-23选择场景数据源-，点击“Next243-5-24选择场景数据源-3-5-253-5-25编辑表格数据源-3-5-263-5-26编辑表格数据源-过滤列选择NextGroupBox3-5-273-5-27“Finish3-5-28mui配置MXWeb根据“界面模型”向导，创建mui模型及前端代码后，为了MXWeb项目能够正常运行，还需要在conf/config.js文件中配置一下网关地址，如图3-5-29所3-5-29MXWebMVVMWeb点击上的New按钮，选择“微应用->MVVMWeb项目”，也可以选择MVVMWeb3-5-303-5-30MVVMWebMVVMWeb 新建MVVMWeb项点击“Finish”,MVVMWeb3-5-32MVVMWeb微服务项目打包提供两种方式：通过SG-UAPIDE使用向导的形式进行批 下，使用相应令进行批量、单独打通过SG-UAPIDE批量打SG-UAPIDERunasGradle（STS）Build…”,3-6-1：3-6-1“build3-6-2ArgumentsJRE，3-6-3-6-3Run”按钮，每个微服务将打包后的jar文件放置到相应的 单独打SG-UAPIDERun然后点击向导“Gradle（STS）Build…”,3-6-4：3-6-4“build3-6-5ArgumentsJRE，3-6-3-6-6通过命令打批量打gradlebuildjarbuild/libs下。单独打 ，打开命令行，执行gradlebuild命令，jar文件将放到build/libs 开发示product表的创建表的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)创建项目及模按照3.2的微应用开发流程3.3.1创建MOM模型项目，参照创建与product表相对应的MOM模型com.sgcc.uap.test23.4.1创建微服务主建MXWebMOMMOM3-7-13-7-.33-7-2所3-7-3-7-33-7-3配微服务microservice1配3.4.4对microservice1Aperties3-7-53-7-5CorsConfig.java@Configuration3-7-6所MxWebTest项目配对MxWebTest3-7-7部署启启动微服务右键，再点击run/debug->JavaApplication3-7-8所示：3-7-8部署并启动MxWebTest项和普通JavaWebMxWebTest项目部署到UAPIDE3-7-9联调测在浏览器中输 3-7-10图3-7-10结ApplicationUAP上的启动按钮，或者右键选择rundebug3-8-1所示：3-8-1如何部署、启动MXWeb项目、MVVMMXWeb项目和MVVM项目实际上都是JavaWeb项目，部署、启动的方法和普通JavaWeb项目相同。开发测试阶段，如何简单地实现微服务和WebCorsConfig.java中@Configuration注解前的注释去掉，并MXWebconf/config.jsgatewayURL配置为待测试微服3-8-2所示：3-8-2最后，将MXWeb项目部署到tomcat新建一张自关联的表，其sql如下alteraltertableforeignkeydroptableifexistscreatetableTESTTREEIDbigintnotnullcomment'id',parent_idbigint,NAMEvarchar(255)commentprimarykey)alteraltertableaddindexFK_Testtree_Testtree_parentidaddconstraintforeignkeyreferencesTESTTREESG-UAPIDE