3.1.1 环境准备（Mac版）

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

工欲善其事，必先利其器。

在进行学习前，大家务必先检查环境。为了降低大家环境准备难度，基础环境全程用安装包无脑模式进行环境配置，安装请从附件下载（提供mac版本安装包，其他操作系统请自行网上下载与安装）。

后端相关

基础环境准备

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

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

安装mysql，并配置环境变量详见本文中的【环境变量设置】部分
如果mysql启动失败则，在命令行加执行以下命令

Shell
mysqld --initalize-insecure
sudo chmod -R a+rwx /usr/local/mysql/data/

图3-1-1 mysql启动失败需执行的命令

安装 idea社区版（官方下载链接见书籍【附件一】）

根据不同版本下载不同的idea插件 (联系Oinone官方客服)

b. 点击Preferences菜单（快捷键 comand+,）

c. 选择Plugins，进入插件管理页面，接下来按图操作就可以了

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

e. 选择.zip文件，不需要解压

如果安装了Lombok，请禁用
idea的Java Complier，不然java反射获取方法入参名会变成arg*，导致元数据默认取值出错。或者pom中加入Complier插件，此方法为正解，不然上线也会有问题，我们学习的工程都会选用mvn插件方式

图3-1-4 界面操作示意图

图3-1-5 界面操作示意图

图3-1-6 界面操作示意图

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <compilerArgument>-parameters</compilerArgument>
        <source>${maven.compiler.source}</source>
        <target>${maven.compiler.source}</target>
        <encoding>${project.build.sourceEncoding}</encoding>
    </configuration>
</plugin>

图3-1-7 pom文件代码

安装 dataGrip 最新版本的

过期就去删“ ~/Library/Application\ Support/JetBrains/DataGrip202xxxx”相关的目录，无限期试用，或者安装其他mysql GUI 工具

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

安装 GraphQL的客户端工具 Insomnia

第一次使用可以参考3.2.1【构建第一个Module】一文中在模块启动后如何用该工具验证后端启动成功，更多使用技巧自行百度，Insomnia.Core-2022.4.2.dmg.txt(186.9 MB)（下载地址见书籍【附件一】）,下载文件后修改文件名去除.txt后缀

安装 maven ，并配置环境变量（下载地址见书籍【附件一】）

配置mvn的settings，下载附件settings-open.xml，并重命名为settings.xml,建议直接放在~/.m2/下面。下载地址见oinone开源社区群公告，也可以联系oinone合作伙伴或服务人员
把settings.xml拷贝一份到maven安装目录conf目录下

环境变量设置 vi ~/.bash_profile ，并执行 source ～/.bash_profile

##按实际情况设置
export PATH=$PATH:/usr/local/mysql/bin
export PATH=$PATH:/usr/local/mysql/support-files
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_0221.jdk/Contents/Home
##替换掉${mavenHome}，为你的实际maven的安装路径
export M2_HOME=${mavenHome}
export PATH=$PATH:$M2_HOME/bin

图3-1-8 环境变量设置

查看主机名

#查看主机名
echo $HOSTNAME

图3-1-9 查看主机名

根据主机名，配置/etc/hosts文件。此步如果没有配置，可能导致mac机器在启动模块时出现dubbo超时,从而导致系统启动巨慢，记得把oinonedeMacBook-Pro.local换成自己的主机名

#oinonedeMacBook-Pro.local 需要换成自己对应的主机名，自己的主机名用 echo $HOSMNAME
127.0.0.1 oinonedeMacBook-Pro.local
::1 oinonedeMacBook-Pro.local

图3-1-10 配置/etc/hosts文件

必备中间件安装脚本（rocketmq、zk、redis）

zk 下载并解压（下载地址见书籍【附件一】）

vi ～/.bash_profile ，追加以下两行，并执行 source ～/.bash_profile

#### 替换掉${basePath}，为你的实际安装路径
export ZOOKEEPER_HOME=${basePath}/apache-zookeeper-3.5.8-bin
export PATH=$PATH:$ZOOKEEPER_HOME/bin

图3-1-11 配置zk环境变量

启动zk

##启动
zkServer.sh start
##停止
zkServer.sh stop

图3-1-12 启停zk

rocketmq （下载地址见书籍【附件一】）

vi ～/.bash_profile ，追加以下两行，并执行 source ～/.bash_profile

#### 替换掉${basePath}，为你的实际安装路径
export ROECET_MQ_HOME=${basePath}/rocketmq-all-4.7.1-bin-release
export PATH=$PATH:$ROECET_MQ_HOME:$ROECET_MQ_HOME/bin

图3-1-13 配置rocketmq环境变量

到bin目录下修改配置文件 runserver.sh 和 runbroker.sh

##注释掉下面一行
##choose_gc_log_directory
##修改java启动所需内存，按自己实际情况改，1g或者512m
JAVA_OPT = "${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn1g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

图3-1-14 bin目录下修改配置文件

启停rocketmq

##启动 nameserver
nohup mqnamesrv &
##启动 broker
nohup mqbroker -n localhost:9876 &

##停止
mqshutdown broker
mqshutdown namesrv

图3-1-15 启停rocketmq

redis

CPU差异	下载地址
默认	redis-5.0.2 下载地址
m系列的cpu 5.x版本不支持	redis-6.2.8 下载地址

表3-1-2 redis下载地址

安装

## 替换掉${redisHome}，为你的实际安装路径
cd ${redisHome}
make
make install PREFIX=${redisHome}

图3-1-16 安装redis

vi ～/.bash_profile ，追加以下两行，并执行 source ～/.bash_profile

##替换掉${redisHome}，为你的实际安装路径
export REDIS_HOME=${redisHome}
export PATH=$PATH:$REDIS_HOME/bin

图3-1-17 配置redis环境变量

启停

##启动
nohup redis-server &
##停止
redis-cli shutdown

图3-1-18 启停redis

晋级中间件安装脚本（canal，es）

canal、es相关的安装与使用，我们放到后续教程中TBD再介绍，它们是非必须的，只有用到异步事件、增强模型等高级特性时，才需要安装。

前端环境准备

安装nvm，便于node的版本管理 http://nvm.sh

curl -o- https://pamirs.oss-cn-hangzhou.aliyuncs.com/pamirs/software/install.sh | bash

图3-1-19 安装nvm

vi ～/.bash_profile ，在文件后面追加以下内容（如图3-1-20所示），并执行 source ～/.bash_profile

export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm

图3-1-20 配置nvm环境变量

用nvm 安装nodejs 版本12.12.0

#看nvm是否安装成功
nvm -v
nvm install 12.12.0

图3-1-21 安装nodejs

vi ～/.bash_profile ，追加以下一行，并执行 source ～/.bash_profile

nvm use 12.12.00

图3-1-22 配置nodejs的环境变量

安装vue-cli

#@vue/cli需要固定，安装成功后可vue -V查看
sudo npm install @vue/cli@4.5.17 -g

图3-1-23 安装vue-cli

配置npm 源

#通过config命令，其他方式自行百度
npm config set registry http://nexus.shushi.pro/repository/kunlun/

图3-1-24 配置npm源

登录npm账号

npm login --registry "http://nexus.shushi.pro/repository/kunlun/"
npm info underscore #（如果上面配置正确这个命令会有字符串response）

图3-1-25 登陆npm源

username、password、email 请见oinone开源社区群公告，也可以联系oinone合作伙伴或服务人员

安装cnpm参考 https://www.npmjs.com/package/cnpm
```
sudo npm install cnpm -g --registry=https://registry.npmmirror.com
```
图3-1-26 安装cnpm

至此所有环境准备好了，我们就正式要进入学习如何使用oinone进行业务开发了

其他说明

解决一些新版mac系统默认是zsh而不是bash，“每次都需source ～/.bash_profile”的问题，vi ~/.zshrc新建.zshrc文件，添加内容为source ～/.bash_profile，保存退出后执行 source ~/.zshrc 命令。或者把.bash_profile的内容复制到.zshrc文件去

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

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

Oinone 7天从入门到精通

史, 昂数式管理员

0 0

3.1.2 环境准备（windows版）

上一篇 2024年5月23日 am9:57

3.1 环境搭建

下一篇 2024年5月23日

Oinone 7天入门到精通

应用审计

1. 整体介绍应用审计是基于模型字段记录用户操作留痕记录，通过定义审计规则，平台基于审计规则订阅的字段记录形成日志。平台名词概念：应用日志：针对已订阅的审计规则记录用户操作信息，是用户在各应用中操作行为留痕记录。审计规则：业务审计中，数据变化订阅记录的规则。操作入口：应用中心——业务审计应用。 2. 审计规则审计规则是指定义审计过程订阅数据变化的信息，根据模型、订阅到具体字段内容变化形成应用日志。如订阅销售订单的备注，销售订单S20231001888，订单备注【尽快发货】，备注修改为【需易碎品包装】，审计规则为：销售订单模型，订阅【备注】。操作包括：新增、编辑、删除。 2.1. 新增新增时，定义审计规则名称，选择需要审计的模型，指定需要订阅的字段信息，同时可以指定关联关系的字段。需要注意：每个模型仅限定义单条审计规则。 2.2. 编辑编辑同新增操作，不做赘述。 2.3. 删除删除规则后，平台将不再监听对应数据的变更日志，请慎重删除。 3. 应用日志应用日志是针对已订阅的审计规则记录用户操作信息。记录操作用户、IP、登录设备、位置、订阅的字段变化内容。应用日志详情 4. 业务表达 4.1. 展示效果表格-行操作—日志记录详情—日志记录 4.2. 操作步骤 Step1：在应用中心，需要维护业务应用依赖业务审计应用；操作入口：应用中心，找到业务应用——编辑，依赖模块选择业务审计。 Step2：配置审计规则；操作入口：业务审计应用——审计规则——新增规则。 Step2：界面设计器配置日志记录；操作入口：界面设计器，找到需要配置的页面——模型组件，将动作区的日志记录拖动到页面中。

史, 昂
2024年1月20日
1.2K000
4.1.4 模块之元数据详解

介绍Module相关元数据，以及对应代码注解方式。大家还是可以通读下，以备不时之需如您还不了解Module的定义，可以先看下2.3【oinone独特之源，元数据与设计原则】一文对Module的描述，本节主要带大家了解Module元数据构成，能让小伙伴非常清楚oinone从哪些维度来描述Module，一、元数据说明 ModuleDefinition 元素数据构成含义对应注解备注 displayName 显示名称 @Module( displayName=””, name=””, version=””, category=””, summary=””, dependencies={“”,””}, exclusions={“”,””}, priority=1L ) name 技术名称 latestVersion 安装版本 category 分类编码 summary 描述摘要 moduleDependencies 依赖模块编码列表 moduleExclusions 互斥模块编码列表 priority 排序 module 模块编码 @Module.module(“”) dsKey 逻辑数据源名 @Module.Ds(“”) excludeHooks 排除拦截器列表 @Module.Hook(excludes={“”,””}) website 站点 @Module.Advanced( website=”http://www.oinone.top”, author=”oinone”, description=”oinone”, application=false, demo=false, web=false, toBuy=false, selfBuilt=true, license=SoftwareLicenseEnum.PEEL1, maintainer=”oinone”, contributors=”oinone”, url=”http://git.com” ) author module的作者 description 描述 application 是否应用 demo 是否演示应用 web 是否web应用 toBuy 是否需要跳转到website去购买 selfBuilt 自建应用 license 许可证默认PEEL1 可选范围： GPL2 GPL2ORLATER GPL3 GPL3ORLATER AGPL3 LGPL3 ORTHEROSI PEEL1 PPL1 ORTHERPROPRIETARY maintainer 维护者 contributors 贡献者列表 url 代码库的地址 boot 是否自动安装的引导启动项 @Boot 加上该注解代表：启动时会自动安装，不管yml文件的modules是否配置 moduleClazz 模块定义所在类只有用代码编写的模块才有 packagePrefix 包路径，用于扫描该模块下的其他元数据 dependentPackagePrefix 依赖模块列对应的扫描路径 state 状态系统自动计算，无需配置 metaSource 元数据来源 publishCount 发布总次数 platformVersion 最新平台版本本地与中心平台的版本对应。做远程更新时会用到 publishedVersion 最新发布版本表4-1-4-1 ModuleDefinition UeModule 是对ModuleDefinition的继承，并扩展了跟前端交互相关的元数据元素数据构成含义对应注解备注 homePage Model 跳转模型编码 @UxHomepage(@UxRoute() 对应一个ViewAction，如果UxRoute只配置了模型，则默认到该模型的列表页 homePage Name 视图动作或者链接动作名称 logo 图标 @UxAppLogo(logo=””) 表4-1-4-2 UeModule 二、元数据，代码注解方式 Module Module ├── displayName 显示名称 ├── name 技术名称 ├── version 安装版本 ├── category 分类编码 ├── summary 描述摘要 ├── dependencies 依赖模块编码列表 ├── exclusions 互斥模块编码列表 ├── priority 排序 ├── module 模块编码 │ └── value ├── Ds 逻辑数据源名 │ └── value ├── Hook 排除拦截器列表…

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

4.1.8 函数之事务管理

一、事务管理介绍函数Function支持事务字段为isTransaction（默认为false），事务传播行为propagationBehavior（默认PROPAGATION_SUPPORTS），事务隔离级别isolationLevel（默认使用数据库默认的事务隔离级别），所以不会默认为函数添加事务。另外事务配置提供全局配置。平台事务管理兼容Spring声明式与编程式事务，支持多数据源事务管理。事务管理中多数据源嵌套独立事务，不会造成死锁风险。使用多数据源或分表操作，不会导致脏读。如果需要多数据源分布式事务，请使用PamirsTransational分布式事务管理方案（@PamirsTransational(enableXa=true)）。分布式事务一般用于量小的跨模块配置管理场景使用方式声明式事务，使用@PamirsTransactional注解在需要事务管理的类或方法上标注。在非无代码场景下，与@Transactional注解功能一致。编程式事务，使用PamirsTransactionTemplate即可。在非无代码场景下，与TransactionTemplate功能一致。配置式事务，使用TxConfig模型在模块安装时初始化存储事务配置数据。事务特性原子性（atomicity）:强调事务的不可分割. 一致性（consistency）:事务的执行的前后数据的完整性保持一致. 隔离性（isolation）:一个事务执行的过程中,不应该受到其他事务的干扰持久性（durability） :事务一旦结束,数据就持久到数据库事务隔离级别事务隔离级别指的是一个事务对数据的修改与另一个并行的事务的隔离程度，当多个事务同时访问相同数据时，如果没有采取必要的隔离机制，就可能发生以下问题：问题描述脏读一个事务读到另一个事务未提交的更新数据，所谓脏读，就是指事务A读到了事务B还没有提交的数据，比如银行取钱，事务A开启事务，此时切换到事务B，事务B开启事务–>取走100元，此时切换回事务A，事务A读取的肯定是数据库里面的原始数据，因为事务B取走了100块钱，并没有提交，数据库里面的账务余额肯定还是原始余额，这就是脏读不可重复读在一个事务里面的操作中发现了未被操作的数据比方说在同一个事务中先后执行两条一模一样的select语句，期间在此次事务中没有执行过任何DDL语句，但先后得到的结果不一致，这就是不可重复读幻读是指当事务不是独立执行时发生的一种现象，例如第一个事务对一个表中的数据进行了修改，这种修改涉及到表中的全部数据行。同时，第二个事务也修改这个表中的数据，这种修改是向表中插入一行新数据。那么，以后就会发生操作第一个事务的用户发现表中还有没有修改的数据行，就好象发生了幻觉一样。表4-1-8-1 事务隔离级别 Pamirs（Spring）支持的隔离级别隔离级别描述 DEFAULT 使用数据库本身使用的隔离级别 ORACLE（读已提交） MySQL（可重复读） READ_UNCOMITTED 读未提交（脏读）最低的隔离级别，一切皆有可能。 READ_COMMITED 读已提交，ORACLE默认隔离级别，有不可重复读以及幻读风险。 REPEATABLE_READ 可重复读，解决不可重复读的隔离级别，但还是有幻读风险。 SERLALIZABLE 串行化，最高的事务隔离级别，不管多少事务，挨个运行完一个事务的所有子事务之后才可以执行另外一个事务里面的所有子事务，这样就解决了脏读、不可重复读和幻读的问题了表4-1-8-2 隔离级别与描述隔离级别脏读可能性不可重复读可能性幻读可能性加锁度 READ_UNCOMITTED 是是是否 READ_COMMITED 否是是否 REPEATABLE_READ 否否是否 SERLALIZABLE 否否否是表4-1-8-3 隔离级别说明表事务的传播行为保证同一个事务中 PROPAGATION_REQUIRED 支持当前事务，如果不存在就新建一个(默认) PROPAGATION_SUPPORTS 支持当前事务，如果不存在，就不使用事务 PROPAGATION_MANDATORY 支持当前事务，如果不存在，抛出异常保证没有在同一个事务中 PROPAGATION_REQUIRES_NEW 如果有事务存在，挂起当前事务，创建一个新的事务 PROPAGATION_NOT_SUPPORTED 以非事务方式运行，如果有事务存在，挂起当前事务 PROPAGATION_NEVER 以非事务方式运行，如果有事务存在，抛出异常 PROPAGATION_NESTED 如果当前事务存在，则嵌套事务执行 A中嵌套B事务，嵌套PROPAGATION_REQUIRES_NEW方法勿与A在同类中。异常状态 PROPAGATION_REQUIRES_NEW （两个独立事务） PROPAGATION_NESTED (B的事务嵌套在A的事务中) PROPAGATION_REQUIRED (同一个事务) A抛异常 B正常 A回滚，B正常提交 A与B一起回滚 A与B一起回滚 A正常 B抛异常 1.如果A中捕获B的异常，并没有继续向上抛异常，则B先回滚，A再正常提交； 2.如果A未捕获B的异常，默认则会将B的异常向上抛，则B先回滚，A再回滚 B先回滚，A再正常提交 A与B一起回滚 A抛异常B抛异常 B先回滚，A再回滚 A与B一起回滚 A与B一起回滚 A正常 B正常 B先提交，A再提交 A与B一起提交 A与B一起提交表4-1-8-4 事务传播行为二、声明式事务（举例） Step1 修改PetShopBatchUpdateAction 用@PamirsTransactional或者@Transactional注解来声明事务，PamirsTransactional跟Spring的Transactional区别在于PamirsTransactional支持多库事务，但此多库事务为非严格的分布式多库事务，之所以选择这个方案，原因如下 a. 不损害任何性能。 b. 事务保障率超过4个9 c. 经过阿里的大厂验证，特别是在阿里的结算平台中得到了很好的验证 @PamirsTransactional更多配置项请详见4.1.7【函数之元数据详解】一文，自己多试试。同时@PamirsTransactional百分百兼容@Transactional @Action(displayName = "确定",bindingType = ViewTypeEnum.FORM,contextType = ActionContextTypeEnum.SINGLE) @PamirsTransactional //@Transactional public PetShopBatchUpdate conform(PetShopBatchUpdate data){ if(data.getPetShopList() == null || data.getPetShopList().size()==0){ throw PamirsException.construct(DemoExpEnumerate.PET_SHOP_BATCH_UPDATE_SHOPLIST_IS_NULL).errThrow(); } List<PetShopProxy> proxyList = data.getPetShopList(); for(PetShopProxy petShopProxy:proxyList){ petShopProxy.setDataStatus(data.getDataStatus()); } new PetShopProxy().updateBatch(proxyList); throw PamirsException.construct(DemoExpEnumerate.SYSTEM_ERROR).errThrow(); // return data; } 图4-1-8-1 修改PetShopBatchUpdateAction Step2 重启看效果进入店铺管理列表页，选择记录点击【批量更新数据状态】按钮，修改记录的数据状态为【未启用】，提交看效果。期望效果为：提示系统异常，数据修改失败图4-1-8-2 数据状态显示已启用图4-1-8-3 批量更新数据状态…

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

高级组件

本篇主要结合业务场景介绍高级组件的使用方法。级联选择/树选择级联选择与树选择是同一类业务场景、不同的交互体验，在这里我们一起说明。业务场景行业分类、产品类目/分类等自关联场景，案例以行业分类说明。操作步骤 Step1：搭建模型搭建行业模型，在行业模型中创建多对一字段“上级行业”，指多个子行业对应一个上级行业。如下图： Step2：界面设计创建行业的表格视图，绑定菜单，并且在此视图中增加“跳转动作 – 新增行业”；创建新增行业表单，将“上级行业”拖进画布中，组件切换为“级联选择”，属性面板配置“选项字段、搜索字段、透出字段”，平台低代码为每个模型自动生成了名称、编码字段，如果不使用平台提供的名称、自建名称时，需要配置这三个字段；为“上级行业”设置联动关系，自关联默认选择行业、标题定义为行业名称、自关联的字段为上级行业。配置后发布表格、表单视图，即可获得级联选择效果。表单视图中将“上级行业”切换为“树选择”组件，在发布后，即可获得树选择效果。 Step3：效果展示级联选择树选择

史, 昂
2024年6月20日
1.6K000
高级视图

史, 昂
Oinone 7天入门到精通 2024年6月20日
1.5K000

登录后才能评论

3.1.1 环境准备（Mac版）

后端相关

基础环境准备

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

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

安装 idea社区版 （官方下载链接见书籍【附件一】）

安装 dataGrip 最新版本的

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

安装 GraphQL的客户端工具 Insomnia

安装 maven ，并配置环境变量（下载地址见书籍【附件一】）

环境变量设置 vi ~/.bash_profile ，并执行 source ～/.bash_profile

必备中间件安装脚本（rocketmq、zk、redis）

zk 下载并解压（下载地址见书籍【附件一】）

rocketmq （下载地址见书籍【附件一】）

redis

晋级中间件安装脚本（canal，es）

前端环境准备

其他说明

相关推荐

应用审计

4.1.4 模块之元数据详解

4.1.8 函数之事务管理

高级组件

高级视图

Leave a Reply

安装 idea社区版（官方下载链接见书籍【附件一】）