3.1.2 环境准备（windows版）

史, 昂 • 2024年5月23日 am9:57 • Oinone 7天入门到精通 • 阅读 2354

一、后端基础环境准备

安装JDK1.8 ，高于1.8_221以上（下载地址见书籍【附件一】）

打开Windows环境变量配置页

此电脑 => 右键属性 => 系统高级设置 => 环境变量
配置环境变量

在用户环境变量中新建变量为JAVA_HOME的项,值为JDK安装之后的路径

图3-1-27 新建环境变量JAVA_HOM

编辑变量为Path的项添加一个值%JAVA_HOME%\bin

图3-1-28 添加一个环境变量值%JAVA_HOME%\\bin

PowerShell或者CMD中验证，输出类似信息为安装配置成功

图3-1-29 验证JAVA是否安装成功

安装 Apache Maven 3.8+ （下载地址见书籍【附件一】）

删除Maven安装目录下的conf/settings.xml
配置mvn的settings，下载附件settings-open.xml，并重命名为settings.xml,建议直接放在【C:\Users\你的用户名.m2】下面。下载地址见oinone开源社区群公告，也可以联系oinone合作伙伴或服务人员
配置环境变量在用户环境变量中新建变量为M2_HOME的项,值为Maven安装路径

图3-1-30 新建变量M2_HOME

编辑变量为Path的项添加一个值%M2_HOME%\bin

图3-1-31 添加一个值%M2_HOME%\\bin

验证

图3-1-32 验证Maven是否安装成功

安装 Jetbrains IDEA （下载地址见书籍【附件一】）

插件安装下载地址密码: mdji
如果IDEA安装了Lombok插件,请禁用Lombok插件
点击菜单项File => Settings => Plugins

图3-1-33 插件管理页面操作示意

下载插件包 (联系Oinone官方客服)

图3-1-35 操作指引

图3-1-36 操作指引

安装MySQL 8 （下载地址见书籍【附件一】）

解压下载的ZIP安装包, 复制到自定义安装目录
设置环境变量 MYSQL_BASE_DIR

提换成MySQL安装目录路径

把 %MYSQL_BASE_DIR%\bin 加入到系统环境变量中

在PowerShell中可以使用 Get-Command mysqld 命令验证环境变量是否配置成功，执行成功输出mysqld的所在路径

初始化

在命令行中执行 mysqld --initialize-insecure --user=mysql

安装

mysqld -install
启动MySQL服务

mysqld -install
设置root用户密码

alter user \'root\'@\'localhost\' identified with mysql_native_password by \'oinone\'; flush privileges;

安装DB GUI工具

Datagrip、MySQLWorkbench、DBEaver 选其一 ### 安装Git （下载地址见书籍【附件一】）

安装GraphQL测试工具Insomnia（下载地址见书籍【附件一】）

安装RocketMQ（下载地址见书籍【附件一】）

修改安装目录下bin中对应文件的默认配置

a. runserver.cmd文件内容 -Xms2g -Xmx2g为 -Xms1g -Xmx1g

b. runbroker.cmd文件内容 -Xms2g -Xmx2g为 -Xms1g -Xmx1g，以及-XX:G1HeapRegionSize=1m
启动RocketMQ NameServer命令 RocketMQ安装目录\bin\mqnamesrv.cmd start
启动RocketMQ Broker命令 RocketMQ安装目录\bin\mqbroker.cmd -n localhost:9876
停止 RocketMQ命令 mqshutdown.cmd broker mqshutdown.cmd namesrv

安装ElasticSearch 版本 8.4.1（下载地址见书籍【附件一】）（非必须）

ES运行时需要JDK18及以上版本JDK运行环境, ES安装包中包含了一个JDK18版本

set JAVA_HOME=ES安装路径\jdk

启动

ES安装路径\bin\elasticsearch.bat

停止 ctrl+c 或者关闭cmd、PowerShell的窗口

安装Redis （下载地址见书籍【附件一】）

解压安装包到安装目录
在PowerShell进入到Redis安装目录
在PowerShell中执行.\redis-server.exe，输出图中类似信息（如下图3-35所示）：

图3-1-37 验证redis是否安装成功

新开PowerShell窗口, 进入到Redis安装目录, 执行 .\redis-cli.exe回车，输入 ping 回车输出 PONG即表示Redis安装成功

图3-1-38 验证redis是否安装成功

Zookeeper安装（下载地址见书籍【附件一】）

解压安装, 在 PowerShell中执行 tar zxvf 安装包路径(tar.gz包) -C Zk安装目录
进入 Zk安装目录\conf\ 复制 zoo_sample.cfg文件为 zoo.cfg
修改zoo.cfg文件的内容（其中dataDir需要自己设定）

tickTime=2000
initLimit=10
syncLimit=5
clientPort=2181
dataDir=需要设置路径用来保存zk数据
maxClientCnxns=120
autopurge.snapRetainCount=3
autopurge.purgeInterval=1
admin.enableServer=false

图3-1-39 配置zk参数

进入 Zk安装目录\bin\执行 zkServer.cmd 5新开PowerShell窗口, 进入到Zk安装目录, 执行 zkCli.cmd，连接成功后输入 ls /输出类似信息即安装成功

图3-1-40 验证zk是否安装成功

二、前端环境准备

安装nodejs 版本12.12.0 （下载地址见书籍【附件一】）

a.下载zip包之后解压到安装目录

b. 配置环境变量

ⅰ. 添加NODE_HOME环境变量

图3-1-41 添加NODE_HOME环境变量

ⅱ. 编辑PATH环境变量

图3-1-42 编辑PATH环境变量

c. 打开PowerShell输入

node --version
npm --version

图3-1-43 验证node和npm是否安装成功

输出类似信息，即为成功安装node与npm

图3-1-44 验证node和npm是否安装成功

安装vue-cli

npm install @vue/cli@4.5.17 -g

图3-1-45 安装vue-cli

安装完成之后执行vue --version，输出类似信息，即为成功安装vue-cli

图3-1-46 验证vue-cli是否安装成功

配置NPM源

npm config set registry http://nexus.shushi.pro/repository/kunlun/

图3-1-47 配置NPM源

登录NPM源账

npm login --registry "http://nexus.shushi.pro/repository/kunlun/"
# username、password、email 请见oinone开源社区群公告，也可以联系oinone合作伙伴或服务人员
npm info underscore

图3-1-48 登入NPM源的账号指令

图3-1-49 登入NPM源是否成功

图3-1-50 登入NPM源是否成功

安装cnpm （参见https://www.npmjs.com/package/cnpm）

npm install cnpm -g --registry=https://registry.npmmirror.com
cnpm.cmd --version

图3-1-51 安装cnpm

图3-1-51 验证cnpm安装是否成功

Oinone社区作者：史, 昂原创文章，如若转载，请注明出处：https://doc.oinone.top/oio4/9226.html

访问Oinone官网:https://www.oinone.top获取数式Oinone低代码应用平台体验

Oinone 7天从入门到精通

史, 昂数式管理员

0 0

3.2 Oinone以模块为组织

上一篇 2024年5月23日

3.1.1 环境准备（Mac版）

下一篇 2024年5月23日

Oinone 7天入门到精通

7.2 实战训练（积分发放）

前言当我们碰到一个全新的场景，除了写代码以外也可以通过设计器来完成，大致步骤如下：分析业务场景，规划对应的模型并通过模型设计器进行配置通过界面设计器，设计出必要管理页面通过流程设计器，设计对应业务流程通过数据可视化，设计相应的数据看板场景说明本节通过例子完成一个积分成本分摊的业务场景积分支出：谁受益谁支出原则+导购手动确认原则，通过门店应用的积分规则，来实现自动化+手动积分形式实现案例背景某家具企业经营多种家具类型，不同系列不同品类分事业部经营。注：独立门店：只能售卖本事业部下的商品；融合门店：可以售卖多事业部下的商品；需求：需要建立一套积分规则，遵循谁受益谁支出原则+导购手动确认原则；通过门店应用的积分规则，来实现自动化+手动积分。场景一导购a邀请老客户c通过裂变分享新客户x在独立门店1下单。系统根据独立门店1的积分规则，自动发放积分给老客户c和新客户x，积分由国一事业部承担。场景二融合门店1导购b邀请老客户d裂变分享新客户y在融合门店下单。该订单可能涉及多个事业部，由导购b手动选择最大量值的积分规则进行发放场景三独立门店1的导购a邀请老客户c裂变分享新客户z在独立门店2下单。系统根据独立门店2的积分规则，来计算积分值，自动发放老客户c和新客户z的积分，积分由国二事业部实战训练 Step1 分析业务场景规划对应模型本场景下涉及基础对象模型包括：事业部、门店、导购、会员等事业部：它是积分成本的载体门店：类型分为独立门店和融合门店，独立门店必须隶属于一个事业部，同时配置默认积分发放规则，融合门店可能属于多个事业部当发生积分发放时，需要店员手工选择成本事业部和积分发放规则导购员：导购员必须隶属于一个门店等会员：消费者需要记录它隶属导购员，以及是由哪个会员推荐过来的等涉及业务对象模型包括：积分发放规则，积分发放记录，邀请下单记录积分发放规则：会员积分发放规则，对应邀请老客的积分发放规则等积分发放记录：本次发放积分、本次发放积分规则、发放对象(会员)、成本事业部、关联门店、关联导购、关联老客（可空）、关联下单记录编码等邀请下单记录：导购、下单会员、下单门店、商品信息、下单金额等对应模型如下：模型设计器呈现自定义字段列表关系字段说明说明事业部事业部负责人(文本) 门店列表(o2m) 与门店建立o2m绑定关系,绑定时选择双向绑定，双向绑定意思是在事业部这边建立o2m到门店的关系字段，在门店那边建立m2o的关系字段关系字段需要在有对方模型的情况下再建，比如事业部中的门店列表则是再后面追加新增的门店导购列表(o2m) 事业部(m2o) 默认积分发规则(m2o) 门店类型(枚举) 分别与事业部、导购、积分发放规则建立m2o、o2m、m2o关系门店类型：需要先建对应的数据字典导购绑定用户(m2o) 门店(m2o) 是否离职(布尔型) 与门店建立m2o关系 1. 绑定用户，用于后续业务流程设计中的填写规则 2. 打马赛克的忽略，其他场景测试用会员会员累计积分(浮点数) 推荐客户(m2o) 所属于导购员(m2o) 是否为新客(布尔型) 与导购、会员建立m2o关系 1. 会员m2o的字段是自关联用于存储推荐会员 2. 打马赛克的忽略，其他场景测试用积分发放规则推荐客户发放比例(浮点数) 发放倍数(整数) 积分发放记录最终发放积分(浮点数) 关联积分规则(m2o) 事件编码(文本) 推荐导购员(m2o) 推荐会员(m2o) 关系门店(m2o) 成本事业部(m2o) 会员(m2o) 成本事业部名称（文本）会员名称（文本）与积分发放规则、导购员、会员、门店、事业部建立m2o关系 1. 会员有两个m2o，分别用户记录发放会员和发放会员的推荐会员也就是老客 2. 事件编码用户维护触发本次积分发放记录产生的源头单据编码如：邀请下单记录的编码邀请下单记录成本事业部(m2o) 选择积分发放规则(m2o) 下单门店(m2o) 购买商品(文本) 下单金额(整数) 会员(m2o) 导购(m2o) 与成本事业部、积分发放规则、下单门店、会员、导购等建立m2o的关系 1. 会员、下单门店、导购属于必要信息 2. 成本事业部、积分发放规则是业务流程中自动计算回填的数据 Step3 利用界面设计器，设计出必要的管理页面以事业部为例，构建管理页面。其他模型依次按例子建立管理页面进入界面设计器，应用选择全员营销，模型选择事业部，点击添加页面下的直接创建设置页面标题、模型（自动带上可切换）、业务类型（运营管理后续会扩展其他类型）、视图类型（表单）后点击确认按钮进入事业部表单设计页面进入页面设计器，对事业部表单页面进行设计（更多细节介绍，请参考界面设计产品使用手册） a. 左侧为物料区：分为组件、模型。 ⅰ. 【组件】选项卡下为通用物料区，我们可以为页面增加对应布局、字段（如同在模型设计器增加字段）、动作、数据、多媒体等等 ⅱ. 【模型】选项卡下为页面对应模型的自定义字段、系统字段、以及模型已有动作 b. 中间是设计区域 c. 右侧为属性面板，在设计区域选择中组件会显示对应组件的可配置参数在左侧【组件】选项卡下，拖入布局组件【分组】，并设置组件【标题属性】为基础信息在左侧【组件】选项卡下，再次拖入布局组件【分组】，并设置组件【标题属性】为门店列表在左侧【模型】选项卡下，分别把自定义字段中的【事业部负责人】和系统字段中的【名称】拖入【基础信息】分组，把自定义字段中的【门店列表】字段拖入门店列表分组在设计区域切换【门店列表】展示组件为【表格】此时【门店列表】展示形式变成了表格形式，选中【门店列表】组件，会发现左侧【模型】选项卡下的当前模型切换成了【门店】，同时我们在右属性面板区置空其【标题属性】设计区选中【门店列表】的表格组件，分别把自定义字段中的【默认积分发规则】、【门店类型】、【导购列表】和系统字段中的【名称】拖入【门店列表】表格组件的表格字段设计区设计区选中【门店列表】的表格组件的【创建】按钮，点击【打开弹窗】设计关系字段【门店】的新增页面 11.分别把自定义字段中的【默认积分发规则】、【门店类型】和系统字段中的【名称】拖入门店的新增页面设计区选中弹出框中【取消】取消按钮，设置其【按钮样式】属性为【次要按钮】关闭弹出框，回到主设计区设计区选中【门店列表】的表格组件的【删除】按钮，设置其【按钮样式】属性为【次要按钮】，【二次确认】属性打开设计区选中【门店列表】的表格组件中操作列的【编辑】按钮，点击【打开弹窗】设计关系字段【门店】的编辑页面， a. 分别把自定义字段中的【默认积分发规则】、【门店类型】和系统字段中的【名称】拖入门店的新增页面设计区。 b. 选中弹出框中【取消】取消按钮，设置其【按钮样式】属性为【次要按钮】 c. 把门店类型展示组件切换为【单选框】 d. 关闭弹出框设计区选择非【门店列表】组件如基础信息，模型切换为主模型【事业部】，在左侧【模型】选项卡下，把动作分类下的提交类型【创建】动作拖入中间设计区的动作区选择中展示名为【确定】的创建动作按钮，在右侧属性面板中设置：是否隐藏属性为【条件隐藏】，隐藏条件为【id非空】在左侧【模型】选项卡下，把动作分类下的提交类型【更新】动作拖入中间设计区的动作区选择中展示名为【确定】的更新动作按钮，在右侧属性面板中设置：是否隐藏属性为【条件隐藏】，隐藏条件为【id为空】。之所以同时拖入【创建】和【更新】动作并都命名为确认，是期望这个页面同时可以做为新增页面也可以做为编辑页面，只不过要通过条件隐藏来设置按钮的出现规则在左侧【组件】选项卡下，把动作分类下的【客户端动作】拖入中间设计区的动作区选择设计区【客户端动作】，在右侧属性面板中设置：动作名称为【返回】，客户端行为为【返回上一个页面】并点击保存选择设计区【返回】动作，在右侧属性面板中设置：按钮样式为【返回】，【二次确认】属性打开并设置提示文字为【返回页面操作将不被保存】，可以点击预览二次确认看效果点击【发布】按钮，页面成功发布，每发布一次会有一个例子版本，可以通过历史版本进行恢复点击右上角历史版本图标，进入历史版本查看页面在历史版本页面可以选择对应历史版本记录，并通过【恢复此版本】来完成页面的历史版本切换接下来我们为事业部模型创建表格管理页面，入口同编辑页面。设置页面标题、模型（自动带上可切换）、业务类型（运营管理后续会扩展其他类型）、视图类型（表格）后点击确认按钮进入事业部表格设计页面进入页面设计器，对事业部表格页面进行设计（更多细节介绍，请参考界面设计产品使用手册）在左侧【模型】选项卡下，分别把自定义字段中的【事业部负责人】和系统字段中的【名称】拖入表格组件的表格字段设计区在左侧【组件】选项卡下，把动作分类下的【跳转动作】拖入中间设计区的动作区，并在右侧属性面板中设置动作名称为【新增】，数据控制类型为【不进行数据处理】，打开方式为【当前窗口打开】，动作跳转页面为【事业部编辑】页面，并点击保存在左侧【组件】选项卡下，把动作分类下的【跳转动作】拖入中间设计区的行内动作区，并在右侧属性面板中设置动作名称为【编辑】，数据控制类型为【处理单条数据】，打开方式为【当前窗口打开】，动作跳转页面为【事业部编辑】页面，并点击保存在左侧【模型】选项卡下，把动作分类下的【删除】拖入中间设计区的动作区，并在右侧属性面板中设置动作名称为【删除】，按钮样式为【次要按钮】，【二次确认】属性打开点击右上角【显示母版】进入页面最终展示形式，点击添加菜单项，并在输入框中输入【事业部管理】点击菜单右侧设置图标，选择【绑定已有页面】，进行菜单与页面的绑定操作在绑定页面中，模型选择【事业部】，视图选择【事业部管理】，点击确认按钮提交拖动【事业部管理】菜单到【积分管理】父菜单下最后别忘了点击右上角【发布】按钮对【事业部管理】表格页面进行发布，回到界面设计器首页查看刚刚建好的两个页面以事业部为例分别对门店、导购、会员、积分发放规则、积分发放记录、邀请下单记录等模型进行页面设计，这里不再累赘，请按照自身学习需要，尝试进行界面设计 Step4 通过流程设计器，设计对应业务流程我们先来整理下核心流程即：邀请下单流程 Step4.1 创建导购邀请下单记录触发流程进入流程设计器，点击【创建】按钮注意：流程中需要获取关系类型的字段（如：O2O、O2M、M2O或M2M），这种类型都是复杂的对象字段，除关联字段(一般为ID)以外的字段，需要通过【数据获取】节点单独获取【关系字段】的对象数据。所以在流程设计中经常会用到【数据获取】节点左上角编辑流程名称为【导购邀请下单触发流程】，点击第一个【触发】节点，触发方式选择模型触发，模型选择【导购邀请下单】，触发场景选择【新增数据时】，点击该节点的【保存】按钮点击流程图节点间的【+】图标选择增加【获取数据】节点，或者拖动左侧物料区【获取数据】到特定的【+】图标点击【获取数据】，在右侧属性面板中设置【获取数据条数】为单条，选择模型为【导购】，点击【筛选条件】的【{X}】图标，进行数据获取的条件设置选择条件字段为【ID】条件操作符为【等于】，条件为变量的导购字段的ID。当上下文只有一个变量时默认不需要选择，这里默认的是【触发[导购邀请下单记录]】，设置好以后点击确认，回到属性面板设置【未获取到数据时执行方式】为【终止流程】，并点击节点【保持】按钮再增加一个【获取数据】节点，在右侧属性面板中设置 a. 【获取数据条数】为单条，选择模型为【会员】 b. 点击【筛选条件】的【{X}】图标，进行数据获取的条件设置，选择条件字段为【ID】条件操作符为【等于】，条件为变量【导购邀请下单记录】的会员关系字段的ID字段。因为上下文中存在多个变量时需要选择对应变量，跟获取导购数据有点区别，在获取导购数据时，上下文中只有此次【导购邀请下单记录】所以不需要选择对应变量，设置好以后点击【确认】按钮 c. 回到属性面板设置【未获取到数据时执行方式】为【终止流程】 d. 最后点击节点【保持】按钮。…

史, 昂
2024年5月23日
1.4K000
Oinone 7天入门到精通

3.5.2.1 整体介绍

虽然我们有小眼睛可以让用户自定义展示字段和排序喜好，以及通过权限控制行、列展示，但在我们日常业务开发中还是会对页面进行调整，以满足业务方的对交互友好和便捷性的要求。本节会在如何自定义之前我们先介绍页面结构与逻辑，再带小伙伴一起完成自定义view的Template和Layout，以及整个母版的Template和Layout 页面的构成讲解页面交互拓扑图页面交互拓扑图图3-5-2-1 页面交互拓扑图注：页面逻辑交互拓扑图说明模块作为主切换入口模块决定菜单列表菜单切换触发点击action 前端根据Mask、View进行渲染， a. Mask是母版是确定了主题、非主内容分发区域所使用组件和主内容分发区域联动方式的页面模板。全局、应用、视图动作、视图都可以通过mask属性指定母版 bMask和View都是有layout定义和template定义合并而成，系统会提供默认母版，以及为每种视图提供默认layout c. layout与template通过插槽进行匹配 Action根据不同类型做出不同访问后端服务、url跳转、页面路由、发起客户端动作等 Aciton路由可以指定Mask、视图组件的layout、template a. 当layout没有指定的时候则用系统默认的 b. 当template没有指定的时候，且视图组件相同类型有多条记录时，根据优先级选取 Mask和视图组件的layout优先级（视图组件>视图动作 > 应用 > 全局）默认母版以及各类视图组件母版布局默认母版基础布局base-layout <mask layout="default"> <header slot="header"/> <container slot="main" name="main"> <sidebar slot="sidebar"/> <container slot="content"/> </container> <footer slot="footer"/> </mask> 图3-5-2-2 默认母版基础布局base-layout 母版template <mask layout="default"> <mask name="defaultMask"> <template slot="header"> <container name="appBar"> <element widget="logo"/> <element widget="appFinder"/> </container> <container name="operationBar"> <element widget="notification"/> <element widget="dividerVertical"/> <element widget="languages"/> </container> <element widget="userProfile"/> </template> <template slot="sidebar"> <element widget="navMenu"/> </template> <template slot="content"> <element widget="breadcrumb"/> <element widget="mainView"/> </template> </mask> 图3-5-2-3 母版template 注：上例中因为名称为main的插槽不需要设置更多的属性，所以在template中缺省了main插槽的template标签。最终可执行视图 <mask name="defaultMask"> <header> <container name="appBar"> <element widget="logo"/> <element widget="appFinder"/> </container> <container name="operationBar"> <element widget="notification"/> <element widget="dividerVertical"/> <element widget="languages"/> </container> <element widget="userProfile"/> </header> <container name="main"> <sidebar name="sidebar"> <element widget="navMenu"/> </sidebar> <container name="content"> <element widget="breadcrumb"/> <element widget="mainView"/> </container> </container> <footer/> </mask> 图3-5-2-4 最终可执行视图表格视图布局默认表格视图基础布局base-layout <view type="table"> <view type="search"> <element widget="search" slot="search"> <xslot name="fields" slotSupport="field" /> </element> </view> <pack widget="fieldset"> <element widget="actionBar" slot="actions" slotSupport="action" /> <element widget="table" slot="table"> <xslot name="fields" slotSupport="field" /> <element widget="actionsColumn" slot="actionsColumn"> <xslot name="rowActions" slotSupport="action" /> </element> </element> </pack> </view> 图3-5-2-5 默认表格视图基础布局base-layout 注：table标签的子标签为column组件，如果field填充到元数据插槽fields没有column组件将自动包裹column组件。表格视图template <view type="table" model="xxx" name="tableViewExample">…

史, 昂
2024年5月23日
1.1K000
Oinone 7天入门到精通

3.5.7.8 自定义菜单栏

在业务中，可能会遇到需要对菜单栏的交互或UI做全新设计的需求，这个时候可以自定义菜单栏组件支持。首先继承平台的CustomMenuWidget 组件，将自己vue文件设置到component处 import { NavMenu, SPI, ViewWidget } from '@kunlun/dependencies'; import Component from './CustomMenu.vue'; @SPI.ClassFactory( ViewWidget.Token({ // 这里的widget跟平台的组件一样，这样才能覆盖平台的组件 widget: 'nav-menu' }) ) export class CustomMenuWidget extends NavMenu { public initialize(props) { super.initialize(props); this.setComponent(Component); return this; } } vue文件中继承平台的props，编写自定义页面代码 export const NavMenuProps = { /** * 当前模块 */ module: { type: Object as PropType<IModule | null> }, /** * 树结构的菜单 */ menus: { type: Array as PropType<IResolvedMenu[]>, default: () => [] }, /** * 菜单类型，现在支持垂直、水平、和内嵌模式三种 */ mode: { type: String as PropType<'vertical' | 'horizontal' | 'inline'>, default: 'inline' }, /** * 菜单栏是否折叠收起 */ collapsed: { type: Boolean, default: false }, /** * 当前展开的 SubMenu 菜单项 key 数组 */ openKeys: { type: Array as PropType<string[]>, default: () => [] }, /** * 当前选中的菜单项 key 数组 */ selectKeys: { type: Array as PropType<string[]>, default: () => [] }, /** * 菜单搜索下拉选中菜单项 */ selectMenuBySearch: { type: Function as PropType<(menuName: String) => void> }, /** * 选中菜单项 */ selectMenu: { type: Function as PropType<(menuName: String) => Promise<void>> }, /** * SubMenu 展开/关闭的回调 */ openChange: { type: Function as PropType<(openKeys: string[]) => void> }, /**…

史, 昂
2024年5月23日
855000
Oinone 7天入门到精通

4.5.1 研发辅助之插件-结构性代码

研发辅助意在消灭研发过程中的重复性工作提升研发效率，如结构性代码提供生产示例性代码，如果根据模型生成导入导出、view自定义配置等经常性开发一、插件安装根据自身Idea版本下载插件并安装：版本插件 2023.1 pamirs-source-maker-1.0.0-2023.1.zip(2.4 MB) 2021.1 pamirs-source-maker-1.0.0-2021.1.zip(2.4 MB) 2021.2 pamirs-source-maker-1.0.0-2021.2.zip(2.4 MB) 2021.3 pamirs-source-maker-1.0.0-2021.3.zip(2.4 MB) 2022.1 pamirs-source-maker-1.0.0-2022.1.zip(2.4 MB) pamirs-source-maker-1.0.0-223-EAP-SNAPSHOT(2.4 MB) 表4-5-1-1 插件列表二、研发辅助之配置式结构性代码生成器我们在开发过程中为了日后代码易于维护和修改，往往会做工程性的职责划分。除去模型外会有代理模型和代理模型Action来负责前端交互以面向接口的形式来定义函数，就会有api和实现类之分如果项目有多端，那么如代理模型和代理模型Action又要为每一个端构建一份在大型项目的初始阶段，我们需要手工重复做很多事情，特别麻烦。现在用oinone的研发辅助插件的结构性代码生成器，就可以避免前面的重复工作插件执行的配置文件 <?xml version="1.0" encoding="utf-8" ?> <oinone> <makers> <!– 根据模型生成代理类、代理类的Action、Service、ServiceImpl –> <maker> <!– 选择模型所在位置 –> <modelPath>/Users/oinone/Documents/oinone/demo/pamirs-second/pamirs-second-api/src/main/java/pro/shushi/pamirs/second/api/model</modelPath> <!– 代理模型、代理模型Action生成相关配置信息 –> <proxyModules> <module> <!– 代理模型和代理模型Action的生成位置信息 –> <generatePath>/Users/oinone/Documents/oinone/demo/pamirs-second/pamirs-second-api/src/main/java/pro/shushi/pamirs/second/api</generatePath> <!– 代理模型和代理模型Action的模块前缀 –> <modulePrefix>second</modulePrefix> <!– 代理模型和代理模型Action的模块名，代理模型和代理模型Action类名为moduleName+模型名+"Proxy"+"Action" –> <moduleName>second</moduleName> <!– 代理模型和代理模型Action的包名,实际包名为 packageName+".proxy"或packageName+".action"–> <packageName>pro.shushi.pamirs.second.api</packageName> </module> </proxyModules> <!– 根据模型生成api，包括service（写方法）和queryService（读方法） –> <apiModule> <!– service和queryService的生成位置信息 –> <generatePath>/Users/oinone/Documents/oinone/demo/pamirs-second/pamirs-second-api/src/main/java/pro/shushi/pamirs/second/api</generatePath> <!– service和queryService的模块前缀 –> <modulePrefix>second</modulePrefix> <!– service和queryService的模块名 –> <moduleName>second</moduleName> <!– service和queryService的包名,实际包名为 packageName+".service" –> <packageName>pro.shushi.pamirs.second.api</packageName> </apiModule> <!– 根据模型生成api实现类，包括serviceImpl（写方法）和queryServiceImpl（读方法） –> <coreModule> <!– serviceImpl和queryServiceImpl的生成位置信息 –> <generatePath>/Users/oinone/Documents/oinone/demo/pamirs-second/pamirs-second-core/src/main/java/pro/shushi/pamirs/second/core</generatePath> <!– serviceImpl和queryServiceImpl的模块前缀 –> <modulePrefix>second</modulePrefix> <!– serviceImpl和queryServiceImpl的模块名 –> <moduleName>second</moduleName> <!– serviceImpl和queryServiceImpl的包名,实际包名为 packageName+".service" –> <packageName>pro.shushi.pamirs.second.core</packageName> </coreModule> </maker> </makers> </oinone> 图4-5-1-1 插件执行的配置文件三、研发辅助之多模型结构性代码生成器是配置式结构性代码生成器的补充，应对开发后期维护中新增模型的场景。它的不同点在于只要选择模型文件就可以，不需要专门编写xml文件。生成的文件默认就在模型所在路径下 Step1 菜单栏上找到oinone，并点击子菜单【多模型结构性代码生成器】图4-5-1-2 多模型结构性代码生成操作步骤一 Step2 设置必要的信息模型前缀模型的所属模块代理模型的模块这三个信息分别用于构建代理模型的MODEL_MODEL = 模型前缀.代理模型的模块.代理模型类名服务的FUN_NAMESPACE = 模型前缀.代理模型的模块.服务类名图4-5-1-3 多模型结构性代码生成操作步骤二 Step3 选择为哪些模型生成对应的结构性代码图4-5-1-4 多模型结构性代码生成操作步骤三 Step4 代码在模型所在目录生成的文件默认就在模型所在路径下，您可以手动拖动到对应的包路径当中去图4-5-1-5 多模型结构性代码生成操作步骤四

史, 昂
2024年5月23日
943000
Oinone 7天入门到精通

6.2 集成平台（改）

企业在数字化转型过程中内外部集成是一个必然需求、也是趋势集成的诉求主要来自两个方面：1.企业的数字化改造是由外而内逐步进行的（内部异构集成）、2.企业数字化方向是朝越来越开放的方向发展（外部平台、工具集成）。总的来说企业在数字化转型过程中内外部集成是一个必然需求、也是趋势。所以我们不能简单地去理解做个API对接就结束了，而是要统一规划构建成企业的集成门户对API定义，安全、控制、记录等做全方位管理。oinone在下个版本规则中也纳入了基于集成平台之上做产品化配置的需求概述 pamirs-eip为平台提供企业集成门户的相关功能，如请求外部接口使用的【集成接口】和对外开放被其他系统请求调用的【开放接口】功能。在请求外部接口时，还支持了多个接口调用（路由定义）、分页控制（paging）、增量控制（incremental）等功能。准备工作 Step1 POM与模块依赖 pamirs-demo-api 和 pamirs-second-api 的pom文件中引入pamirs-eip2-api包依赖 <dependency> <groupId>pro.shushi.pamirs.core</groupId> <artifactId>pamirs-eip2-api</artifactId> </dependency> DemoModule和SecondModule 增加对EipModule的依赖 @Module(dependencies = {EipModule.MODULE_MODULE}) pamirs-demo-boot和pamirs-second-boot工程的pom文件中引入pamirs-eip2-core包依赖 <dependency> <groupId>pro.shushi.pamirs.core</groupId> <artifactId>pamirs-eip2-core</artifactId> </dependency> Step2 yaml配置文件参考 pamirs-demo-boot和pamirs-second-boot工程的application-dev.yml文件中增加配置pamirs.boot.modules增加eip，即在启动模块中增加eip模块 pamirs: boot: modules: – eip pamirs-demo-boot和pamirs-second-boot工程的application-dev.yml文件中增加eip模块的数据源与路由配置 pamirs: framework: data: ds-map: eip: eip datasource: eip: driverClassName: com.mysql.cj.jdbc.Driver type: com.alibaba.druid.pool.DruidDataSource url: jdbc:mysql://127.0.0.1:3306/eip_v3?useSSL=false&allowPublicKeyRetrieval=true&useServerPrepStmts=true&cachePrepStmts=true&useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&autoReconnect=true&allowMultiQueries=true username: root password: oinone initialSize: 5 maxActive: 200 minIdle: 5 maxWait: 60000 timeBetweenEvictionRunsMillis: 60000 testWhileIdle: true testOnBorrow: false testOnReturn: false poolPreparedStatements: true asyncInit: true pamirs-demo-boot工程的application-dev.yml文件中修改eip的配置 pamirs: eip: open-api: enabled: false pamirs-second-boot工程的application-dev.yml文件中修改eip的配置 pamirs: eip: enabled: true open-api: enabled: true route: host: 127.0.0.1 port: 8094 aes-key: Nj5Thnxz4rV8Yy1FLGA2hUym3RepB8MKgafEaYC4GKo= 注： hosts配置在远程调用时不能使用127.0.0.1，可配置为0.0.0.0进行自动识别。若自动识别仍无法访问，请准确配置其他已知的可访问IP地址。 aes-key：用下面代码生成附录：AES Key生成 pro.shushi.pamirs.core.common.EncryptHelper加解密帮助类，默认支持AES、RSA类型的数据加解密方法，也可自定义其他类型的加解密方法。 System.out.println(EncryptHelper.getKey(EncryptHelper.getAESKey())); Step3 在pamirs-second-api新建一个SessionTenantApi实现类只要在我们公共的jar包中构建类似DemoSessionTenant类就可以了，之所以要构建SessionTenantApi实现类是因为EIP是以租户信息做路由的。所以这里我们写死返回一个“pamirs”租户就好了。记得要重新mvn install second工程，再刷新demo工程 package pro.shushi.pamirs.second.api.tenant; import org.springframework.core.annotation.Order; import org.springframework.stereotype.Component; import pro.shushi.pamirs.framework.session.tenant.api.SessionTenantApi; import pro.shushi.pamirs.meta.api.core.session.SessionClearApi; import pro.shushi.pamirs.meta.common.spi.SPI; @Order(99) @Component @SPI.Service public class DemoSessionTenant implements SessionTenantApi, SessionClearApi { public String getTenant() { return "pamirs"; } public void setTenant(String tenant) { } public void clear() { } } 开放接口（举例） Step1 用于演示的模型定义 package pro.shushi.pamirs.second.api.model; import pro.shushi.pamirs.meta.annotation.Field; import pro.shushi.pamirs.meta.annotation.Model; import pro.shushi.pamirs.meta.base.IdModel; @Model.model(TestOpenApiModel.MODEL_MODEL) @Model(displayName = "演示开放接口模型") public class TestOpenApiModel extends IdModel { public static final String MODEL_MODEL = "demo.second.TestOpenApiModel"; @Field.String @Field(displayName = "名称") private…

史, 昂
2024年5月23日
1.3K000

登录后才能评论

3.1.2 环境准备（windows版）

一、后端基础环境准备

安装JDK1.8 ，高于1.8_221以上（下载地址见书籍【附件一】）

安装 Apache Maven 3.8+ （下载地址见书籍【附件一】）

安装 Jetbrains IDEA （下载地址见书籍【附件一】）

安装MySQL 8 （下载地址见书籍【附件一】）

安装DB GUI工具

安装GraphQL测试工具Insomnia（下载地址见书籍【附件一】）

安装RocketMQ（下载地址见书籍【附件一】）

安装ElasticSearch 版本 8.4.1（下载地址见书籍【附件一】） （非必须）

安装Redis （下载地址见书籍【附件一】）

Zookeeper安装（下载地址见书籍【附件一】）

二、前端环境准备

相关推荐

7.2 实战训练（积分发放）

3.5.2.1 整体介绍

3.5.7.8 自定义菜单栏

4.5.1 研发辅助之插件-结构性代码

6.2 集成平台（改）

Leave a Reply

安装ElasticSearch 版本 8.4.1（下载地址见书籍【附件一】）（非必须）