SG-UAP_V3 0 0_使用手册_分册9 集成开发工具微服务

SG-UAP集成开发工具使用手册国家电网公司应用系统统一开发平台（SG-UAP V3.0.0）集成开发工具使用手册国家电网公司统一应用平台项目组2017年1月修订记录版本号修订说明修订人修订时间审核人2.9.2UAP微服务项目、微服务网关项目、微服务Web项目开发指南翟德会2017年1月18日2.9.3修改开发指南结构顺序，新增3.1前置条件、3.3开发流程、3.4 OM模型开发、3.6.3 生成微服务场景代码、3.6.4 配置微服务，修改3.7微服务Web端开发，新增生成微服务Web端ui模型及代码， 配置MX Web项目 ，新增3.8示例，新增3.9 FAQ孟庆丰2017年5月22日3.0.0修改开发指南结构顺序，删除3.1前置条件，修改3.2开发流程，修改3.3MOM模型开发，修改3.4微服务网关项目开发，修改3.5微服务服务端开发，修改3.6微服务Web端开发，修改3.8开发示例，修改3.9FAQ 新增3.8微服务项目打包孟庆丰2017年9月27日目录1 引言11.1 概述11.2 适用范围11.3 名词解释12 开发环境部署22.1 平台获取22.2 平台的安装22.2.1 SG-UAP IDE安装22.2.2 SG-UAP IDE的运行22.3 数据库的安装33 开发指南33.1 环境配置33.1.1 安装并配置jdk环境33.1.2 安装并配置gradle环境43.2 微应用开发流程53.3 MOM模型开发63.3.1 创建MOM模型项目63.3.2 创建MOM模型93.3.3 设计MOM模型273.4 微服务服务端开发273.4.1 创建微服务主项目273.4.2 创建微服务项目293.4.3 生成微服务场景代码373.4.4 配置微服务453.5 微服务Web端开发473.5.1 微服务MX Web端开发473.5.2 创建微服务MVVM Web项目693.6 微服务项目打包713.6.1 通过SG-UAP IDE向导打包713.6.2 通过命令打包743.7 开发示例753.7.1 创建项目及模型753.7.2 生成场景代码763.7.3 配置783.7.4 部署启动793.7.5 联调测试803.8 FAQ811 引言1.1 概述本文以案例代码贯穿全文，通过第二章、第三章内容达到快速了解SG-UAP平台开发环境运行环境、快速制作出直接运行示例的目的。第三章作为本文的重点，按照平台的开发步骤引导读者理解基于平台的开发过程，该章节针对平台的微服务项目创建、微服务网关项目创建、微服务Web项目等部分展开介绍了常用的设计、向导、方法，但不做深入介绍。对平台操作功能的深入介绍请参见用户开发手册。同时，本文也不会对组件、函数、属性展开介绍，这些部分的详细内容请参见API文档。1.2 适用范围本指南适合于在统一应用平台下进行软件开发的开发人员阅读和学习，是在用户手册基础之上的进阶资料，具有一定的参考价值。1.3 名词解释名称说明SG-UAP国家电网统一应用平台State Grid Unified Application Platform，英文缩写“SG-UAP”。国家电网公司新一代应用开发与运维平台，提供一套技术统一、架构柔性、性能高效、安全可靠的企业级信息系统基础框架和公共套件集，支撑业务系统的设计、开发、测试、发布、运行的全过程。（中文简称“统一应用平台”，英文简称“UAP”）SG-UAP IDESG-UAP集成开发工具（SG-UAP Development Environment）微服务项目依赖于统一应用平台服务端标准的空的微应用。微服务依赖于统一应用平台服务端标准的空的微服务网关应用。微服务Web项目依赖于统一应用平台服务端标准的空的Web应用。MOM即Micro service Object Model，微服务对象模型，是用于微服务的对象模型mui是用于微服务Web端开发的ui模型MOM模型项目依赖于统一应用平台服务端标准的空的Java项目，用于开发MOM模型表1-3-1 名词解释2 开发环境部署2.1 平台获取业务项目组按照国网平台管理办法实施细则规定，按照平台使用申请流程，获得平台使用版权。2.2 平台的安装2.2.1 SG-UAP IDE安装双击UAP Studio-3.0.exe可执行文件，根据界面提示默认next下一步操作即可安装成功，成功后即可使用SG-UAP IDE。2.2.2 SG-UAP IDE的运行在SG-UAP IDE中，找elipse目录，双击目录下的UAP Studio.exe文件，选择合适的工作空间，即可运行SG-UAP IDE，进入后界面如图2-1所示：图2-1 运行SG-UAP IDE界面2.3 数据库的安装启动数据库，前提是您已经正确安装了数据库，如果没有安装请参考数据库的相关资料安装并启动数据库，以数据库管理员的身份登陆数据库，为微服务应用项目创建用户信息，并执行初始化建库脚本。3 开发指南本章将在介绍开发环境配置的基础上，简要介绍基于平台开发微服务应用的过程，包括MOM模型开发、微服务网关项目开发、微服务开发、微服务Web端开发等。除此之外，本章还会给出开发示例和常见问题及解决方案。3.1 环境配置3.1.1 安装并配置jdk环境要求jdk的版本是在1.8以上。配置过程略。3.1.2 安装并配置gradle环境（1） 安装gradle在Gradle官网上下载gradle安装包，解压到本地，并配置其环境变量。（2） 配置UAP的gradle环境步骤1：在UAP的Window-Preferences-Gradle(STS)中配置gradle的安装目录。图3-1-1 配置UAP Gradle（STS）步骤2：在UAP的Window-Preferences-Gradle(EnIDE)中配置gradle的安装目录。图3-1-2 配置UAP Gradle（EnIDE）3.2 微应用开发流程如图3-2-3所示，微应用开发的流程大致为：首先根据业务需求开发MOM模型；然后，开发人员根据设计好的MOM模型分别开发微服务前端和后端，并进行必要的配置；最后，在各自单元测试后，进行联调测试。开发微服务前端配置微服务前端结束开始开发MOM模型开发微服务后端配置微服务后端联调测试图3-2-3 微服务开发流程图3.3 MOM模型开发MOM模型开发是开发微服务代码的第一个步骤，首先需要创建MOM模型项目，然后在MOM模型项目上，开发人员通过平台提供的向导“微服务业务对象建模”和“微服务数据库反向建模”创建MOM模型，并设计。3.3.1 创建MOM模型项目1. 点击工具栏上的New按钮，选择“ 微应用-MOM模型项目”，也可以选择菜单栏中的“File -New -Other-微应用-MOM模型项目”,如图3-3-1所示：图3-3-1 新建OM模型项目导航选择“MOM模型项目”，点击“Next”，进入“新建MOM模型项目”向导。2. 在打开的“新建MOM模型项目”向导中输入项目名称，点击“Finish”，完成MOM模型项目的创建。图3-3-2 新建MOM模型项目向导3. MOM模型项目目录结构如图3-3-3所示：图3-3-3 MOM模型项目的目录结构表3-3-1简要介绍了MOM模型项目中各个文件/文件夹的作用：文件/文件夹作用datasource.xml存储数据源，可以存储多个数据源mom放置MOM模型表3-3-1 MOM模型项目中各个文件/文件夹的作用3.3.2 创建MOM模型在MOM模型项目中创建MOM模型有两种方式：微服务业务对象建模和微服务数据库反向建模。 微服务业务对象建模1. 点击工具栏上的New按钮，选择菜单栏中的“File -New -Other-微应用-微服务业务对象建模”，点击“Next”，结果如图3-3-4所示：图3-3-4 创建微服务业务对象模型2. 点击“浏览”选择一个MOM模型项目作为MOM模型的存放路径，如图3-3-5所示：图3-3-5 设置文件存放路径3. 填写命名空间、模型名称和显示名称，如图3-3-6所示：图3-3-6 设置新建MOM模型所需的参数4. 点击“Finish”，完成模型文件的创建，创建完成的文件及微服务业务模型设计器如图3-3-7所示：图3-3-7 新创建的MOM模型与设计器展示5. 在MOM模型设计器上，设计MOM模型（MOM模型的设计方式和OM模型相同）。设计完成后保存即可。 微服务数据库反向建模1. 点击工具栏上的New按钮，选择菜单栏中的“File -New -Other-微应用-微服务数据库反向建模”，结果如图3-3-8所示：图3-3-8 微服务数据库反向建模向导首页2. 选择MOM项目。点击“浏览.”按钮，选择MOM项目，如图3-3-9所示：图3-3-9 选择MOM项目注：如果没有历史数据源，需要新增数据源，转到步骤3；如果有历史数据源，转到步骤4。3. 新建数据源。点击右侧的“新增”按钮，弹出数据源设置界面，如图3-3-10所示：图3-3-10 新建数据源输入数据源参数，包括数据源名称、数据库类型、数据库ID（数据库名称）、服务器地址（ip或主机名称）、端口、用户名和密码，如图3-3-11所示：图3-3-11 设置数据源参数点击“测试连接”，测试连接成功后，点击“OK”，完成新增数据源。如图3-3-12所示：图3-3-12 完成新建数据源生成的数据源，如图3-3-13所示：图3-3-13 新建数据源完成4. 选择一个数据源，点击“Next”，如图3-3-14所示：图3-3-14 选择数据源5. 选择需要转换的表，点击“Next”，图3-3-15所示：图3-3-15 选择需要转换的表6. 如图3-3-16所示，如果要新建MOM文件，则选择“新建mom”，转到步骤6；如果要在已经存在的mom中添加业务对象，则选择“选择已有”，转到步骤7。图3-3-16 新建或选择选择已存在的MOM7. 如图3-3-17所示，输入命名空间名称、模型名称和显示名称，点击“Next”。图3-3-17 设置新建mom的命名空间、模型名称、显示名称8. 如图3-3-18所示，选择一个MOM模型，点击“Next”。图3-3-18 选在已经存在的MOM模型9. 表转换业务实体，如图3-3-19所示，点击“Next”即可。图3-3-19 表转换为业务实体可以在此页面设置转换策略和业务实体各属性的显示名称，如图3-3-20所示：图3-3-20 设置属性显示名称和转换策略10. 选中右侧的一个包，双击左侧业务实体，或选中业务实体，点击中间的分配按钮选择业务包，将业务实体分配到对应的包下面，如图3-3-21所示：图3-3-21 选择业务实体结果如图3-3-22所示，点击“Finish”，完成MOM模型的创建或更改。图3-3-22 完成MOM模型的创建或更改11. 创建完成的MOM模型文件及视图如图3-3-23所示：图3-3-23 新建的MOM模型文件及设计器3.3.3 设计MOM模型MOM模型的设计方法与OM模型一样，可依照OM的设计方式设计。3.4 微服务服务端开发微服务主项目与微服务项目之间为主从关系，微服务主项目作为微服务的主体，微服务项目对其进行依赖，一个微服务主项目可以对应多个微服务项目。开发微服务的服务端，首先需要创建“微服务主项目”，其次在微服务主项目基础上，创建“微服务项目”，最后通过“微服务场景代码”向导或在微服务业务模型设计器上的“代码生成”按钮，生成所需的业务代码，如有必要再修改代码则修改，然后对微服务进行配置。3.4.1 创建微服务主项目1. 点击工具栏上的New按钮，选择“ 微应用-微服务主项目”，点击“Next”，也可以选择菜单栏中的“File -New -微服务主项目”，如图3-4-1所示：图3-4-1 微服务主项目向导2. 在打开的“新建微服务主项目”向导中输入主项目名称，其他选项保持默认值，如图3-4-2所示：图3-4-2 微服务主项目信息配置3. 点击Finish按钮，生成项目及目录结构，如图3-4-3所示：图3-4-3 微服务主项目目录结构微服务主项目中的各个文件/文件夹的作用如表3-4-1所示：文件/文件夹作用build放置项目编译后的所有文件publib放置uap所需基础的jar包(默认无需修改)build.gradle微服务主项目的构建项目文件(通过此文件进行项目打包，微服务主项目与各微服务项目将同时打包)pubbuild.gradle对publib文件夹中jar包进行构建管理(如需添加jar包，刷新项目即可生成pubbuild.gradle中jar包的依赖关系)setting.gradle微服务主项目与微服务项目依赖管理uapbuild.gradle对uap所需基础的jar包的构建管理表3-4-1 微服务主项目中的各个文件/文件夹的作用3.4.2 创建微服务项目1. 点击工具栏上的New按钮，选择“微应用-微服务项目”，点击“Next”。如图3-4-4所示：图3-4-4 微服务项目向导2. 或者在Package Explorer视图上，点击鼠标右键，点击“New-微服务项目”，如图3-4-5所示：图3-4-5 微服务场景向导23. 在打开的“新建微服务项目”向导页中选择微服务主项目，如图3-4-6所示：图3-4-6 选择微服务主项目4. 输入项目名称，点击“Next”，如图3-4-7所示：图3-4-7 输入微服务项目名称提示：在SG-UAP IDE中除了指明可以输入中文，一律要求输入英文。5. 输入基础包名，点击“Next”，如图3-4-8所示：图3-4-8 输入包名称6. 配置数据源。点击下拉框，选择一个数据源，点击Finish，完成微服务项目的创建，如图3-4-9所示：图3-4-9 配置微服务项目数据源1如果下拉框中没有数据源选项或者需要添加新的数据源，请按照接下来的步骤操作。6.点击“Add DataSource”按钮，打开新建数据库连接对话框，选择对应的数据库类型（当前示例选择“Mysql”）并设置连接名称，如图3-4-10所示：图3-4-10 选择数据库类型7.点击“Next”按钮，如图3-4-11，点击红色箭头指向的按钮，配置数据库的驱动，其他默认即可。图3-4-11 打开数据库驱动向导8.选择驱动.示例中选中“MySQL JDBC Driver MySQL 5.1”，点击“OK”按钮，如图3-4-12所示：图3-4-12 选择数据库驱动9.在对话框中输入数据库ID、主机名、端口号、用户名、密码，并勾选“Save password”（这样下次连接数据库时可以不用再次输入密码），如图3-4-13所示：图3-4-13 数据库连接信息10.点击“Test Connection”对数据库连接进行测试，如果测试成功，会弹出提示对话框，点击“OK”按钮关闭对话框，如图3-4-14所示：图3-4-14 数据库连接测试结果9.点击“Finish”完成数据库连接配置，返回微服务项目新建向导，点击“Finish”按钮完成新建向导的配置，生成微服务项目目录结构，如图3-4-15所示：图3-4-15 新建微服务项目后目录结构微服务项目中的各个文件/文件夹的作用如图3-4-2所示：文件/文件夹作用Application.java微服务项目的启动类CorsConfig.java跨域配置类文件perties存储枚举类型的数据字典（用于页面展示下拉框的数据）perties微服务项目的配置文件pertiesbuild放置项目编译后的所有文件build.gradle 微服务项目的构建项目文件表3-4-2 微服务项目中的各个文件/文件夹的作用3.4.3 生成微服务场景代码生成场景代码有两种方式：一种是通过“微服务场景代码”向导生成，第二种是通过“微服务业务模型设计器”上的“代码生成”按钮生成。1.通过“微服务场景代码”向导生成代码（1）选中微服务项目，选择菜单栏上的“File -New -Other-微应用-微服务场景代码”，如图3-4-16所示：图3-4-16 新建微服务场景代码向导（2）选择一个MOM模型（如果当前工作空间没有MOM模型项目，则需要新建MOM模型项目，并在MOM项目下新建MOM模型，详见3.3）；然后，点击“Next”按钮。如图3-4-17所示：图3-4-17 微服务场景代码-选择MOM模型（3）设置生成代码的相关参数。在当前向导页上的“参数设置”选项卡中设置包括生成代码存放位置（根目录）、包路径和数据库相关内容等，如图3-4-18所示：图3-4-18 微服务场景代码-参数设置（4）选择对象。在当前向导页上的“对象选择”选项卡中选择包括实体、枚举、关联关系和继承关系等对象。如图3-4-19所示：图3-4-19 微服务场景代码-对象选择（5）点击“Finish”生成场景代码。如图3-4-20所示：图3-4-20 微服务场景代码-生成代码表3-4-3简要介绍了微服务场景代码生成的各个代码文件的作用：文件作用ProductController.java当前场景（本示例为product）的控制层Product.java实体类，POProductVo.javaVOProductTransferPO与VO的转换类IProductService.java服务接口ProductService.java服务接口实现类ProductRepository.java数据访问接口duct_MYSQL.DDL存储场景（本示例为product）的ddl语句表3-4-3 微服务场景代码生成的代码文件说明2. 通过“微服务业务模型设计器”上的“代码生成”按钮生成代码（1） 在MOM模型项目中，双击打开一个MOM模型，在对应的微服务业务模型设计器上，点击工具栏上的“代码生成”按钮，如图3-4-21所示：图5-5-21 点击“代码生成”（2） 选择微服务项目。在弹出的对话框上，选择生成代码的目标微服务项目，如图3-4-22所示：图5-5-22 选择微服务项目（3） 设置生成代码的相关参数。在当前向导页上的“参数设置”选项卡中设置包括生成代码存放位置（根目录）、包路径和数据库相关内容等，如图3-4-23所示：图3-4-23 参数设置（4） 选择对象。在当前向导页上的“对象选择”选项卡中选择包括实体、枚举、关联关系和继承关系等对象。如图3-4-24所示：图3-4-24 对象选择（5） 点击Finish生成代码。生成的代码如图3-4-25所示：图3-4-25 生成的代码文件3.4.4 配置微服务通过微服务场景代码向导生成场景代码后，为了使微服务能正常运行，需要对微服务进行必要的配置。本小结只介绍必要的配置，需要修改的文件有Application.java和perties。1. 配置Application.java。Application.java文件内容，如图3-4-26所示：图3-4-26 Application类配置信息（修改前）按照注释中的步骤2，删除JpaRepositoriesAutoConfiguration.class,HibernateJpaAutoConfiguration.class,修改scanBasePackages配置为：“scanBasePackages=com.demo,com.sgcc.uap.rest.annotation”，如图3-4-27所示：图3-4-27 Application类配置信息（修改后）2. 配置perties必须的配置如图3-4-28所示：图3-4-28 application配置信息3.5 微服务Web端开发UAP IDE提供了两种微服务的Web项目：MX Web项目和MVVM Web项目。下面分别介绍如何创建微服务MX Web项目和创建微服务MVVM Web项目。其中UAP IDE专门为MX Web项目提供了场景代码创建向导。3.5.1 微服务MX Web端开发 创建MX Web项目过程1. 点击工具栏上的New按钮，选择“ 微应用-MX Web项目”，也可以选择菜单栏中的“File -New -Other-微应用-MX Web项目”,点击“Next”按钮，如图3-5-1所示：图3-5-1 新建微服务Web项目导航2. 在打开的“新建MX Web项目”向导中输入项目名称，其他选项保持默认值；点击“Finish”, 完成微服务MX Web项目创建。如图3-5-2所示：图3-5-3 新建MX Web项目提示：在SG-UAP IDE中除了指明可以输入中文，一律要求输入英文。3. 设置编译java应用后生成的文件输出目录，默认即可；点击“Next”按钮。如图3-5-4所示：图3-5-4 配置编译后文件输出目录4. 设置MX Web项目上下文根目录和内容目录，默认即可；点击“Finish”，完成MX Web项目的创建。如图3-5-5所示：图3-5-5 完成MX Web项目的创建5. MX Web项目的目录结构如图3-5-6所示：图3-5-6 MX Web项目的目录结构表3-5-1介绍了MX Web项目中各个文件/文件夹的作用：文件/文件夹作用build放置项目编译后的所有文件config.js配置微服务网关地址表3-5-1 MX Web项目各个文件/文件夹的作用 生成微服务前端mui模型及前端MX代码UAP提供了“微服务界面模型”向导，方便用户在MX Web项目中创建mui模型，生成前端MX代码。界面模型向导提供两种创建mui模型的方式：全新创建空白界面和根据场景模板创建。全新创建空白界面，即创建空白的mui模型，不生成MX代码，用户可以通过界面设计器来设计界面，然后通过设计器上的“生成代码”按钮生成前端MX代码；根据场景模板创建，即根据UAP IDE提供的，各种场景（单表、主从表、树）界面模板，生成mui模型及前端MX代码。1.全新创建空白界面：（1） 选中当前工作空间的一个MX Web项目，选择菜单栏中的“File -New -Other-微应用-微服务界面模型（*.mui）”,如图3-5-7所示：图3-5-7 微服务界面模型导航（2） 输入模型名称，选择选择创建方式为“全新创建空白界面”；然后点击“Finish”。如图3-5-8所示：图3-5-8 选择全新创建空白界面（3） 生成的mui模型如图3-5-9所示：图3-5-9 全新创建空白界面mui模型用户可以在界面模型设计视图上设计界面。2.根据场景模板创建（1）单表场景1) 选中当前工作空间的一个MX Web项目，选择菜单栏中的“File -New -Other-微应用-微服务界面模型（*.mui）”,如图3-5-10所示：图3-5-10 界面模型导航2) 选择MOM项目。点击“选择”按钮，选择一个MOM模型项目（如果当前工作空间没有MOM模型项目，则需要新建MOM模型项目，并在MOM项目下新建MOM模型，详见3.4），点击“OK”，如图3-5-11所示：图3-5-11 选择MOM项目3) 填写模型名称；选择创建方式为“根据场景模板创建”；然后点击“Next”。如图3-5-12所示：图3-5-12 mui模型向导-mui模型信息设置4) 选择一个场景模板（表格（可编辑）、表格+表单（对话框）和表格+表单，三选一），选择“表格+表单（对话框）”，点击“Next”。如图3-5-13所示：图3-5-13 选择场景模板5) 选择场景数据源。选择业务对象模型；选择业务实体；然后点击“Next”。如图3-5-14所示：图3-5-14 选择场景数据源6) 编辑表格数据源。显示列选择，即设置实体哪些属性在界面表格上显示，默认显示实体的所有属性，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的显示顺序，如图3-5-15所示：图3-5-15 编辑表格数据源-显示列选择过滤列选择，即设置表格上的查询条件，默认没有过滤的列，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的显示顺序。如图3-5-16所示：图3-5-16 编辑表格数据源-过滤列选择编辑表格数据源后，点击“Next”，进入下一个向导页。7) 编辑表单数据源。表单列设置，即设置实体哪些属性在界面表单上显示，默认显示实体的所有属性，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的显示顺序；可以设置表单布局，包括设置列数，是否使用Group Box分组，是否支持自动折叠等。如图3-5-17所示：图3-5-17 编辑表单数据源8) 点击“Finish”，完成mui模型向导，生成mui模型及前端代码。如图3-5-18所示：图3-5-18 生成的mui模型及前端代码（2） 树场景1) 选中当前工作空间的一个MX Web项目，选择菜单栏中的“File -New -Other-微应用-微服务界面模型（*.mui）”,如图3-5-19所示：图3-5-19 界面模型导航2) 选择MOM项目。点击“选择”按钮，选择一个MOM模型项目（如果当前工作空间没有MOM模型项目，则需要新建MOM模型项目，并在MOM项目下新建MOM模型，详见3.4），点击“OK”，如图3-5-20所示：图3-5-20 选择MOM项目3) 填写模型名称；选择创建方式为“根据场景模板创建”；然后点击“Next”。如图3-5-21所示：图3-5-21 mui模型向导-mui模型信息设置4) 选择一个场景模板（树表场景、数卡场景和树表卡场景，三选一），以树表场景为例，点击“Next”。如图3-5-22所示：图3-5-22 选择场景模板5) 选择场景数据源。选择树数据源（树数据源对应的表必须是自关联的表），如图3-5-23所示：图3-5-23 选择场景数据源-选择树数据源选择表数据源（表数据源对应的表应是树数据源对应的字表），点击“Next”，如图3-5-24所示：图3-5-24 选择场景数据源-选择表数据源6) 编辑表格数据源。显示列选择，即设置实体哪些属性在界面表格上显示，默认显示实体的所有属性，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的显示顺序，如图3-5-25所示：图3-5-25 编辑表格数据源-显示列选择过滤列选择，即设置表格上的查询条件，默认没有过滤的列，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的顺序。如图3-5-26所示：图3-5-26 编辑表格数据源-过滤列选择编辑表格数据源后，点击“Next”，进入下一个向导页。7) 编辑表单数据源。表单列设置，即设置实体哪些属性在界面表单上显示，默认显示实体的所有属性，可以通过右侧表格上方的按钮来增删属性，修改属性显示名称，还可以调整属性间的顺序；可以设置表单布局，包括设置列数，是否使用Group Box分组，是否支持自动折叠等。如图3-5-27所示：图3-5-27 编辑表单数据源8) 点击“Finish”，完成mui模型向导，生成mui模型及前端代码。如图3-5-28所示：图3-5-28 生成的mui模型及前端代码 配置MX Web项目根据“界面模型”向导，创建mui模型及前端代码后，为了MX Web项目能够正常运行，还需要在conf/config.js文件中配置一下网关地址，如图3-5-29所示：图3-5-29 MX Web配置3.5.2 创建微服务MVVM Web项目1. 点击工具栏上的New按钮，选择“ 微应用-MVVM Web项目”，也可以选择菜单栏中的“File -New -Other-微应用-MVVM Web项目”，点击“Next”按钮，打开创建MVVM Web项目向导,如图3-5-30所示：图3-5-30 新建MVVM Web项目导航2. 在打开的“新建MVVM Web项目”向导中输入项目名称，其他选项保持默认值。图3-5-31 新建MVVM Web项目提示：在SG-UAP IDE中除了指明可以输入中文，一律要求输入英文。3. 点击“Finish”,完成微服务MVVM Web项目创建。图3-5-32 新创建的MVVM Web项目3.6 微服务项目打包微服务项目打包提供两种方式：通过SG-UAP IDE使用向导的形式进行批量、单独打包；在微服务项目所在目录下，使用相应的命令进行批量、单独打包。3.6.1 通过SG-UAP IDE向导打包 批量打包1.在SG-UAP IDE中找到相应的微服务主项目，点击鼠标右键，点击向导“Run as”，然后点击向导“Gradle（STS） Build”,如图3-6-1：图3-6-1 向导打包2.在显示的Gradle Tasks面板空白区域填写“build”，如图3-6-2 图3-6-2向导打包3. 在显示的Arguments面板选择相应的JRE，如图3-6-3 图3-6-3 打包向导4. 最后点击“Run”按钮，每个微服务将打包后的jar文件放置到相应的build/libs目录下。 单独打包1.在SG-UAP IDE中找到某个微服务项目，点击鼠标右键，点击向导“Run as”，然后点击向导“Gradle（STS） Build”,如图3-6-4：图3-6-4 向导打包2.在显示的Gradle Tasks面板空白区域填写“build”，如图3-6-5 图3-6-5向导打包5. 在显示的Arguments面板选择相应的JRE，如图3-6-6 图3-6-6向导打包6. 最后点击“Run”按钮，微服务将打包后的jar文件放置到相应的build/libs目录下。3.6.2 通过命令打包 批量打包在相应磁盘上找到微服务主项目目录，打开命令行，执行gradle build命令，如果执行正常，命令行将显示相关日志信息及打包完成提示，最后，每个微服务生成的jar文件将放到本服务的build/libs目录下。 单独打包在相应磁盘上找到微服务项目目录，打开命令行，执行gradle build命令，如果执行正常，命令行将显示相关日志信息及打包完成提示，最后，生成的jar文件将放到build/libs目录下。3.7 开发示例本小结将给出针对开发微服务场景的示例。下面是基本信息：工作空间F:Usersmqfdyworkspace927数据库micspring数据库类型Mysql数据库表productproduct表的创建表的sql语句: create table PRODUCT ( ID varchar(192) not null comment id, PRODUCT_MODEL text comment product_model, PRODUCT_NAME text comment product_name, PART_DRAWING_NUMBER text comment part_drawing_number, PART_NAME text comment part_name, MATERIAL_TRADEMARK text comment material_trademark, MATERIAL_TYPE text comment material_type, MATERIAL_SPEC text comment material_spec, SINGLE_NUMBER double precision comment single_number, BLANK_DIMENSION float comment blank_dimension, SUIT_NUMBER double precision comment suit_number, MACHINABLE_NUMBER double precision comment machinable_number, primary key (ID) ) comment=Product;3.7.1 创建项目及模型按照3.2的微应用开发流程，参照3.3.1创建MOM模型项目，参照创建与product表相对应的MOM模型com.sgcc.uap.test2；参照3.4.1创建微服务主项目microservice-main，参照3.4.2创建微服务项目microservice1；参照3.5.1创建MX Web项目MxWebTest：微服务主项目microservice-main微服务项目Microservice1MX Web项目MxWebTestMOM项目MOMMOM模型com.sgcc.uap.test2.mom如图3-7-1所示：图3-7-1 开发所需项目及模型3.7.2 生成场景代码基于3.5.1创建的项目及模型，参照3.4.3生成微服务场景代码，如图3-7-2所示：图3-7-2 微服务后端场景代码参照生成微服务前端代码，如图3-7-3所示：图3-7-3 生成的微服务前端代码3.7.3 配置 微服务microservice1配置参照3.4.4对microservice1进行配置，配置结果如下。（1） Application.java文件配置，如图3-7-4所示：图3-7-4 Application.java配置（2） perties文件配置如图3-7-5所示：图3-7-5 perties（3） CorsConfig.java文件配置，去掉Configuration前的注释，如图3-7-6所示：图3-7-6 CorsConfig.java配置 MxWebTest项目配置参照对Mx WebTest项目进行配置，配置结果如图3-7-7所示：图3-7-7 MxWebTest项目配置3.7.4 部署启动 启动微服务microservice1Application为微服务的启动类，启动微服务只需，选中Application.java，点击右键，再点击run/debug-Java Application，如图3-7-8所示：图3-7-8 启动微服务microservice 部署并启动MxWebTest项目和普通Java Web项目一样，将MxWebTest项目部署到UAP IDE自带的tomcat下，然后启动，启动结果如图3-7-9所示：图3-7-9 MxWebTest启动3.7.5 联调测试在浏览器中输入网址：http:/localhost:8080/MxWebTest/newMUI/index.jsp显示结果如图3-7-10所示：图3-7-10 访问结果3.8 FAQ1. 如何启动微服务？微服务的启动类为Application，选中这个类文件点击UAP上的启动按钮，或者右键选择run或debug启动即可，如图3-8-1所示：图3-8-1 启动微服务2. 如何部署、启动MX Web项目、MVVM项目？MX Web项目和MVVM项目实际上都是Java Web项目，部署、启动的方法和普通Java Web项目相同。3. 开发测试阶段，如何简单地实现微服务和Web端联调？首先，将类文件CorsConfig.java中Configuration注解前的注释去掉，并保存。其次，将MX Web项目下conf/config.js中的gatewayURL配置为待测试微服务的地址，如图3-8-2所示：图3-8-2 联调时配置gatewayURL最后，将MX Web项目部署到tomcat下并启动，再启动微服务，即可进行联调。4. 新建一张自关联的表，其sql脚本如下：alter table TESTTREE drop foreign key FK_Testtree_Testtree_parentid; drop table if exists TESTTREE; create table TESTTREE ( ID bigint not null comment id, parent_id bigin