4.1.9 函数之元位指令

史, 昂 • 2024年5月23日 am8:55 • Oinone 7天入门到精通 • 1301 views

元位指令系统是通过给请求上下文的指令位字段作按位与标记来对函数处理下发对应指令的系统。

一、元位指令介绍

元位指令系统是通过给请求上下文的指令位字段作按位与标记来对函数处理下发对应指令的系统。

元位指令系统分为请求上下文指令和数据指令两种。

数据指令

数据指令基本都是系统内核指令。业务开发时用不到这里就不介绍了。前20位都是系统内核预留

请求上下文指令

请求上下文指令：使用session上下文中非持久化META_BIT属性设置指令。

位	指令	指令名	前端默认值	后端默认值	描述
20	builtAction	内建动作	否	否	是否是平台内置定义的服务器动作对应操作：PamirsSession.directive().disableBuiltAction(); PamirsSession.directive().enableBuiltAction();
21	unlock	失效乐观锁	否	否	系统对带有乐观锁模型默认使用乐观锁对应操作：PamirsSession.directive().enableOptimisticLocker(); PamirsSession.directive().disableOptimisticLocker();
22	check	数据校验	是	否	系统后端操作默认不进行数据校验，标记后生效数据校验对应操作：PamirsSession.directive().enableCheck(); PamirsSession.directive().disableCheck();
23	defaultValue	默认值计算	是	否	是否自动填充默认值对应操作：PamirsSession.directive().enableDefaultValue(); PamirsSession.directive().disableDefaultValue();
24	extPoint	执行扩展点	是	否	前端请求默认执行扩展点，可以标记忽略扩展点。后端编程式调用数据管理器默认不执行扩展点对应操作：PamirsSession.directive().enableExtPoint(); PamirsSession.directive().disableExtPoint();
25	hook	拦截	是	否	是否进行函数调用拦截对应操作：PamirsSession.directive().enableHook(); PamirsSession.directive().disableHook();
26	authenticate	鉴权	是	否	系统默认进行权限校验与过滤，标记后使用权限校验对应操作：PamirsSession.directive().sudo(); PamirsSession.directive().disableSudo();
27	ormColumn	ORM字段别名	否	否	系统指令，请勿设置
28	usePkStrategy	使用PK策略	是	否	使用PK是否空作为采用新增还是更新的持久化策略对应操作：PamirsSession.directive().enableUsePkStrategy(); PamirsSession.directive().disableUsePkStrategy();
29	fromClient	是否客户端调用	是	否	是否客户端（前端）调用对应操作：PamirsSession.directive().enableFromClient(); PamirsSession.directive().disableFromClient();
30	sync	同步执行函数	否	否	异步执行函数强制使用同步方式执行（仅对Spring Bean有效）
31	ignoreFunManagement	忽略函数管理	否	否	忽略函数管理器处理，防止Spring调用重复拦截对应操作：PamirsSession.directive().enableIgnoreFunManagement(); PamirsSession.directive().disableIgnoreFunManagement();

表4-1-9-1 请求上下文指令

二、使用指令

普通模式

PamirsSession.directive().disableOptimisticLocker();
try{
    更新逻辑
} finally {
    PamirsSession.directive().enableOptimisticLocker();
}

图4-1-9-1 普通模式代码示意

批量设置模式

Models.directive().run(() -> {此处添加逻辑}, SystemDirectiveEnum.AUTHENTICATE)

图4-1-9-2 批量设置模式代码示意

三、使用举例

我们在4.1.5【模型之持久层配置】一文中提到过失效乐观锁，我们在这里就尝试下吧。

Step1 修改PetItemInventroyAction

手动失效乐观锁

package pro.shushi.pamirs.demo.core.action;

import org.springframework.stereotype.Component;
import pro.shushi.pamirs.demo.api.model.PetItemInventroy;
import pro.shushi.pamirs.meta.annotation.Function;
import pro.shushi.pamirs.meta.annotation.Model;
import pro.shushi.pamirs.meta.api.session.PamirsSession;
import pro.shushi.pamirs.meta.constant.FunctionConstants;
import pro.shushi.pamirs.meta.enmu.FunctionOpenEnum;
import pro.shushi.pamirs.meta.enmu.FunctionTypeEnum;

import java.util.ArrayList;
import java.util.List;

@Model.model(PetItemInventroy.MODEL_MODEL)
@Component
public class PetItemInventroyAction {

    @Function.Advanced(type= FunctionTypeEnum.UPDATE)
    @Function.fun(FunctionConstants.update)
    @Function(openLevel = {FunctionOpenEnum.API})
    public PetItemInventroy update(PetItemInventroy data){
        List<PetItemInventroy> inventroys = new ArrayList<>();
        inventroys.add(data);
        PamirsSession.directive().disableOptimisticLocker();
        try{
            //批量更新会，自动抛错
            int i = data.updateBatch(inventroys);
            //单记录更新，不自动抛售需要自行判断
//        int i = data.updateById();
//        if(i!=1){
//            throw PamirsException.construct(DemoExpEnumerate.PET_ITEM_INVENTROY_UPDATE_VERSION_ERROR).errThrow();
//        }
        } finally {
            PamirsSession.directive().enableOptimisticLocker();
        }
        return data;
    }

}

图4-1-9-3 修改PetItemInventroyAction

Step2 重启看效果

体验一：页面上修改记录，数据库字段中的opt_version不再自动加一

体验二：同时打两个页面，依次点击，您会发现两次都成功。数据库字段中的opt_version不再自动加一

图4-1-9-4 编辑宠物商品库存

图4-1-9-5 编辑宠物商品库存

图4-1-9-6 宠物商品库存的数据库记录变化

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

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

Oinone 7天从入门到精通

Like (0)

史, 昂数式管理员

0 0

4.1.10 函数之触发与定时（改）

Previous 2024年5月23日 am8:54

4.1.8 函数之事务管理

Next 2024年5月23日 am8:56

梅丛银

认识陈鹏程及数式核心团队同学已经有一段时间了，在我们多次的交流讨论中时常会谈及：未来中国哪家软件企业能在互联网云原生时代走出来超越传统软件企业？史昂说这是他的梦想，也是他们团队这么多年坚持技术和产品研发与应用优先思考之路。史昂及数式核心团队面向企业应用市场历经三年的潜心研发和实战交付，推出Oinone产品及配套的低代码平台工具：对比国内外应用软件平台在开放生态和云原生均有它的继承性和独特性，特别是将技术平台赋予企业各种业务领域属性，便于企业客户和开发伙伴的二次开发并能快速搭建各类企业核心应用场景是Oinone的最大亮点。Oinone的内在特点之一是参考了全球最大开源ERP Odoo的元数据模型设计，同时基于业务中台架构和云原生技术，形成了自己一套国际化的快速开发平台、建模规范和应用产品，通过自己进场落地很多品牌企业的应用中台化不断迭代升级，走出了一条具有显著特色的新应用软件之路。史昂及团队特点谦卑、善于思考，善于吸收他山之精华，这是创业团队难能可贵之点，由此能善于与生态伙伴合作也是能够走的更远更长的基础基因。最后希望和祝愿Oinone能为中国企业在云时代数字化实践做出更多的贡献，为软件产业构建强大的应用生态和开发社区，真正树立起Oinone自己的软件品牌形象。资深IT咨询专家&浩鲸云智能专家学院院长：梅丛银

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

用户中心

1. 创建用户进入用户中心应用，在用户列表中点击创建。填写表单中的必填信息。若未设置昵称，则右上角头像右侧展示名称。若设置了昵称，则右上角头像右侧展示昵称。是否激活账号选择是，选择否时用户登录会显示“未找到首页”。角色分组中，选择创建的用户的角色，默认选择了超级管理员（包含所有权限）。点击确定，用户创建完成。用户登录时可用登录账号/邮箱/手机号登录。 2. 用户相关操作表格页中包含常规的搜索、批量删除功能。冻结：当将“是否有效”状态为“是”时展示，将用户“是否有效”修改为“否”。解冻：当将“是否有效”状态为“否”时展示，将用户“是否有效”修改为“是”。修改：进入用户信息修改页面，“编码、登录账号、注册时间”只读。重置密码：点击后在弹窗“账号确认”中输入账号，点击重置密码后，展示新密码。

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

组件属性

1. 通用属性介绍组件和其属性之前，先介绍一些大部分组件通用支持的一些基础属性。 1.2 标题标题是字段在当前页面的展示名称，标题默认为字段名称，可以修改。 1.2 占位提示在未填写内容时，输入框或选择框内的浅色提示文字，仅用于提示，不会影响字段的值。 1.3 描述说明一个字段的描述信息，通常用于说明当前字段的范围、注意事项等。描述说明大部分在组件的下方显示，特殊的是，分组的描述说明在标题的左侧。 1.4 默认值创建数据时，有些字段大概率都是相同值，可设置默认值，减少添加人员的操作步骤，提高录入数据效率。 1.5 只读设为只读时，字段可见，但不可编辑。除了只读和非只读的对立选项，也可以设置条件只读，在设置的条件下才只读，条件不符合则非只读。 1.6 禁用设为禁用时，字段可见，但不可编辑。除了禁用和非禁用的对立选项，也可以设置条件禁用，在设置的条件下才禁用，条件不符合则非禁用。 1.7 隐藏设为隐藏时，字段不可见，也不可编辑。但是在页面设计时，隐藏的组件也会展示，效果如下图。除了隐藏和非隐藏的对立选项，也可以设置条件隐藏，在设置的条件下才隐藏，条件不符合则非隐藏。 1.8 必填控制字段在当前页面是否必填，若设置为必填则在标题前会有红色的*作为标识。除了必填和非必填的对立选项，也可以设置条件必填，在设置的条件下才必填，条件不符合则非必填。 1.9 标题排列方式字段的标题可以自定义横向排列还是纵向排列。每个字段组件都支持设置，设置后之间互不影响。除了组件支持自定义，表单、分组、选项卡也可以设置排列方式，对于这种布局容器类组件，设置后会将其容器内的所有组件的标题排列方式都改为所设置的值。 1.10 宽度定义在页面中的宽度：占整行的比例，一般可选项有1/4、1/3、1/2、2/3、3/4、1。其中1/2表示占当前行的一半；1表示占当前行一整行；以此类推。部分组件特殊，如富文本仅支持宽度为1，即占一整行。 2. 分组分组是一个布局类组件，类似一个容器，可以把业务含义相近的内容放在这个分组容器内。 2.1 属性 2.1.1 标题分组可以定义一个标题名称，标题显示在分组左上角，可以不设置标题。 2.1.2 描述说明分组的描述说明显示在分组标题右侧。 2.1.3 标题排列方式分组中的标题排列方式属性并不是控制分组的标题，而是控制分组内组件的标题。设置后对分组内的所有组件生效。 3. 选项卡选项卡是一个布局类组件，类似一个容器，每个选项卡可以添加多个选项页，可以把业务含义相近的内容放在选项卡的选项页容器内。 3.1 选项卡属性 3.1.1 选项页排列方式选中选项卡，可选择选项卡中的选项页排列方式：水平排列、竖直排列。默认是水平排列，效果如下图。 3.1.2 标题排列方式选项卡中的标题排列方式控制选项卡内组件的标题。设置后对选项卡内的所有组件生效。 3.2 选项页属性 3.2.1 标题选中选项页，显示选项页的属性设置，选项卡中的每个选项页支持设置标题。 3.2.2 标题排列方式选项页中的标题排列方式控制选项页内组件的标题。设置后对选项页内的所有组件生效。同一个选项卡，不同选项页之间的标题排列方式可以不同。 4. 单行文本单行文本输入框，常用于记录名称、身份证号或其他普通的文字内容。 4.1 创建字段单行文本仅支持创建「文本」业务类型的字段，填写规则、内容和模型设计器端创建字段一致。 4.2 表单属性 4.2.1 通用属性在表单中，单行文本可以设置一些通用的属性：标题、占位提示、描述说明、默认值、只读、隐藏、禁用、必填、标题排列方式、宽度。 4.2.2 文本类型文本类型选项为文本或密码。若设置为文本，输入时内容是可见的；若设置为密码，输入时是不可见的密码形态，如下图： 4.2.3 最小/大长度设置输入框输入内容的长度，输入框会根据设置的值进行校验。最大长度默认为创建字段时填写的长度，且设置的最大长度不可以大于字段的长度最小长度默认为空，为空则为不限制最小长度 4.2.4 输入格式设置输入格式为网址或者身份证时，会进行格式的校验无：默认为无，不会校验内容网址：进行网址校验身份证：进行身份证号校验，设置后，需要输入正确的身份证号 4.2.5 显示计数器当需要用户关注输入内容长度时，可以开启显示计数器，在输入时会实时显示当前内容的长度。 4.2.6 显示清除按钮若开启了清除按钮，则在输入框有内容时，点击清除按钮一键清除已有内容 5. 多行文本多行文本输入框，常用于记录字数较多的文字，如意见、复杂备注等。 5.1 创建字段多行文本仅支持创建「多行文本」业务类型的字段，填写规则、内容和模型设计器端创建字段一致。 5.2 表单属性 5.2.1 通用属性在表单中，单行文本可以设置一些通用的属性：标题、占位提示、描述说明、默认值、只读、隐藏、禁用、必填、标题排列方式、宽度。 5.2.2 最小/大长度设置输入框输入内容的长度，输入框会根据设置的值进行校验。 -最大长度默认为创建字段时填写的长度，且设置的最大长度不可以大于字段的长度 -最小长度默认为空，为空则为不限制最小长度 5.2.3 显示计数器当需要用户关注输入内容长度时，可以开启显示计数器，在输入时会实时显示当前内容的长度。 5.2.5 显示清除按钮若开启了清除按钮，则在输入框有内容时，点击清除按钮一键清除已有内容 6. 整数整数输入框，常用于输入整数的天数、数量等，如果会出现小数，请使用小数组件。 6.1 创建字段整数仅支持创建「整数」业务类型的字段，填写规则、内容和模型设计器端创建字段一致。 6.2 表单属性 6.2.1 通用属性在表单中，整数可以设置一些通用的属性：标题、占位提示、描述说明、默认值、只读、隐藏、禁用、必填、标题排列方式、宽度。 6.2.2 最小/大值设置整数输入框输入内容的最值，输入框会根据设置的最值进行校验。最大值可设置的范围根据字段填写的长度转换，如设置长度为3，则最大值最大不可以超过999 截图 6.2.3 显示千分位数字过长时，不便于查看，可开启显示千分位。 7. 小数小数输入框，常用于输入金额、单价等，会出现小数的数值。 7.1 创建字段小数仅支持创建「浮点型」业务类型的字段，填写规则、内容和模型设计器端创建字段一致。 7.2 表单属性 7.2.1 通用属性在表单中，小数可以设置一些通用的属性：标题、占位提示、描述说明、默认值、只读、隐藏、禁用、必填、标题排列方式、宽度。 7.2.2 最小/大值设置小数输入框输入内容的最值，输入框会根据设置的最值进行校验。最大值可设置的范围根据字段填写的长度转换，如设置长度为3，则最大值最大不可以超过999 7.2.3 保留小数位数支持设置小数的保留位数，设置后在页面中输入内容时，将进行校验可设置的保留小数位数不可大于该字段的精度，如字段精度为2，则组件属性中的小数位数最大只能为2； 7.2.4 显示千分位数字过长时，不便于查看，可开启显示千分位。 8. 下拉单选从多个选项中下拉选择一个数据，作为数据值。选项可以是关联模型的数据，也可以是数据字典或布尔型开关。 8.1 创建字段下拉单选支持创建三种业务类型的字段，分别是：多对一、布尔型、数据字典。多对一：创建字段时需要选择关联的模型，关联模型的数据将作为下拉选项；布尔型：下拉选项默认只有是、否；数据字典：创建字段时需要选择数据字典，其数据字典项将作为下拉选项 8.2 表单属性 8.2.1 通用属性在表单中，下拉单选可以设置一些通用的属性：标题、占位提示、描述说明、只读、隐藏、禁用、必填、标题排列方式、宽度。 8.2.2 选项类型…

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

登录日志

1. 登录日志登录日志：记录企业成员/用户登录平台的历史明细，包括登录时间、位置、IP、登录设备、登录平台等信息，登录平台包括：PC Web、小程序、H5、APP。登录日志不需要通过审计规则订阅，平台会记录每位用户的登录日志。操作支持导出、查看详情。

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

3.5.7.7 自定义主题

主题是什么 Oinone框架提供了强大的主题定制功能，使得平台可以轻松适应和遵循公司的品牌和UI规范。通过自定义主题，你可以调整颜色、间距、圆角等视觉元素，从而使Oinone更好地融入到特定行业的需求和公司标准中。以下是关于如何定制主题的关键点和步骤：关键点使用CSS变量： Oinone使用CSS变量 (Css Var) 来实现主题定制。 CSS变量提供了一种高效且灵活的方式来定义和使用样式。全面定制：可以定制的范围广泛，包括颜色、字体、间距、边框、圆角等。通过调整这些元素，可以确保UI符合公司的视觉标准。定制步骤了解CSS变量：首先，了解如何在CSS中使用变量。查看Oinone现有的CSS变量列表，以了解哪些样式可以被定制。定义公司的UI规范：根据公司的品牌指南，定义一套UI规范。包括颜色方案、字体样式、元素尺寸等。应用自定义样式：在Oinone的样式表中，使用定义的CSS变量来覆盖默认样式。确保在适当的地方应用这些自定义样式。作用场景 Oinone平台提供了灵活的主题定制选项，包括内置的六套主题样式，涵盖深色和浅色模式以及不同的尺寸选项（大、中、小）。这些主题可以适应不同的业务需求和项目特性，同时提供了定制工具，方便用户根据公司的UI规范进行调整。下面是主题作用场景的详细说明：主题选项内置主题：六套主题：包括深色和浅色模式，以及大、中、小尺寸。用户可以通过系统设置功能轻松切换不同的主题。可定制性：提供CSS变量的JSON文件，方便用户下载和修改。允许用户根据具体需求定制颜色、字体、间距等样式变量。应用场景公司UI规范对齐：首先根据公司的UI规范调整一份基础主题。这有助于确保平台的外观与公司品牌一致。项目和业务适应性：在不同项目或业务场景中，可以基于公司UI规范进行微调。这提供了项目特定的灵活性，同时保持整体的品牌一致性。实施建议初始设置：初始时，选择一个接近公司标准的内置主题作为起点。通过系统设置功能体验不同的主题效果。定制和微调：下载并修改CSS变量的JSON文件，以符合公司的UI标准。对于特定项目或业务场景，根据需要进行进一步的微调。自定义主题自定义主题功能允许在Oinone平台上创建和应用独特的视觉风格，以适应特定的业务需求和品牌标准。以下是自定义主题的步骤和示例，用于指导如何在Oinone平台上实现这一功能。示例工程目录以下是需关注的工程目录示例，main.ts更新导入./theme：图3-5-7-24 自定义主题目录示例步骤 1: 创建主题定义主题变量：创建一个包含主题样式变量的JavaScript文件。例如，可以定义一个名为OinoneTheme的新主题，并设置相应的CSS变量。图3-5-7-24 自定义主题代码示例注册主题：使用registerTheme函数注册自定义主题。这个函数将新主题添加到可用主题列表中。步骤 2: 应用主题在主入口文件中引用：在main.ts文件中引入自定义主题，并在VueOioProvider配置中指定。图3-5-7-24 自定义主题应用配置示例效果图3-5-7-24 自定义黑色主题效果示例主题叠加： Oinone支持多个主题变量同时存在，后导入的主题变量会覆盖前面导入的。内置主题 Oinone平台内置了以下六个主题变量，你可以在自定义主题时参考或扩展它们： ‘default – large’ ‘default – medium’ ‘default – small’ ‘dark – large’ ‘dark – medium’ ‘dark – small’ 扩展变量在定义主题变量时，根据业务需求可以添加不存在的变量，作为变量的扩展。示例 { "custom-color": "#新的辅助颜色", "button-padding": "10px 20px", // …其他自定义变量 } 图3 – 5 – 7 – 24 扩展主题变量查找主题变量在Oinone平台上，通过DOM调试器查找主题变量是一种有效的方式，允许用户定位并获取相应组件的主题变量。以下是执行这一步骤的详细说明：步骤：使用DOM调试器：在浏览器中打开Oinone平台，进入需要查找主题变量的页面。使用浏览器的开发者工具或DOM调试器（通常可通过右键点击页面元素并选择“检查”打开）。选择目标组件：在DOM调试器中，通过选择器工具或直接点击页面上的组件，选中你想要查找主题变量的目标组件。查看样式和主题变量：在选中的组件上，浏览开发者工具中的“样式”或“计算”选项卡。可以通过查看样式表中的相关样式规则，找到组件所使用的主题变量。 4标识主题变量：主题变量通常以 –oio 为前缀。标识出你感兴趣的主题变量，记录下变量名和当前的取值。示例：假设你想查找某个按钮组件的主题变量，可以通过以下步骤：在DOM调试器中选中按钮组件。在“样式”或“计算”选项卡中查看相关样式规则。找到以 –oio 为前缀的主题变量，如 –oio-button-pirmary-background。记录该主题变量的取值，例如 #3498db。图3-5-7-24 DOM调试器查询主题变量

史, 昂
2024年5月23日
1.6K000

Please Login to Comment

4.1.9 函数之元位指令

一、元位指令介绍

数据指令

请求上下文指令

二、使用指令

普通模式

批量设置模式

三、使用举例

Step1 修改PetItemInventroyAction

Step2 重启看效果

体验一：页面上修改记录，数据库字段中的opt_version不再自动加一

体验二：同时打两个页面，依次点击，您会发现两次都成功。数据库字段中的opt_version不再自动加一

相关推荐

梅丛银

用户中心

组件属性

登录日志

3.5.7.7 自定义主题

Leave a Reply