模型定义在数据库中的映射

yexiu • 2024年8月16日 pm5:01 • 代码实践 • 阅读 1219

模型定义在数据库中的映射

Oinone中通过定义模型来建立数据表，使用注解的方式来使多张表之间的关联。

数据库字段与模型定义字段映射

模型定义在数据库中的映射

package pro.shushi.pamirs.top.api.model;

import pro.shushi.pamirs.core.common.enmu.DataStatusEnum;
import pro.shushi.pamirs.meta.annotation.Field;
import pro.shushi.pamirs.meta.annotation.Model;
import pro.shushi.pamirs.meta.base.IdModel;
import pro.shushi.pamirs.meta.enmu.DateFormatEnum;
import pro.shushi.pamirs.meta.enmu.DateTypeEnum;
import pro.shushi.pamirs.meta.enmu.MimeTypeEnum;

import java.math.BigDecimal;
import java.util.Date;

@Model.model(PamirsDemo.MODEL_MODEL)
@Model(displayName = "PamirsDemo")
public class PamirsDemo extends IdModel {

   public static final String MODEL_MODEL = "top.PamirsDemo";

   @Field.Binary(mime = MimeTypeEnum.html)
   @Field(displayName = "二进制类型")
   private Byte[] byteType;

   @Field.Integer
   @Field(displayName = "整数")
   private Long longType;

   @Field.Float
   @Field(displayName = "浮点数")
   private BigDecimal floatType;

   @Field.Boolean
   @Field(displayName = "布尔类型")
   private Boolean booleanType;

   @Field.Enum
   @Field(displayName = "枚举")
   private DataStatusEnum enumType;

   @Field.String
   @Field(displayName = "字符串")
   private String stringType;

   @Field.Text
   @Field(displayName = "多行文本")
   private String textType;

   @Field.Html
   @Field(displayName = "富文本")
   private String richText;

   @Field.Date(type = DateTypeEnum.DATE, format = DateFormatEnum.DATE)
   @Field(displayName = "日期类型")
   private Date dataType;

   @Field.Date(type = DateTypeEnum.DATETIME, format = DateFormatEnum.DATETIME)
   @Field(displayName = "日期时间类型")
   private Date dataTimeType;

   @Field.Money
   @Field(displayName = "金额")
   private BigDecimal amount;
}

更多字段基础请参考文档字段基础与复合

多对一的关系映射

例：设计一张教师表，一张科目表，教师表对科目表属于多对一的关系，在教师表中使用科目id管理关联关系。

教师表teacher

模型定义在数据库中的映射

科目表professional

模型定义在数据库中的映射

那么在Oinone的模型定义中，这两张表定义是这样的;

教师模型

package pro.shushi.pamirs.top.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(Teacher.MODEL_MODEL)
@Model(displayName = "教师", summary = "教师")
public class Teacher extends IdModel {

   public static final String MODEL_MODEL = "top.Teacher";

   @Field.String
   @Field(displayName = "教师名字")
   private String teacherName;

   @Field.Integer
   @Field(displayName = "科目id")
   private Long professionalId;

   @Field(displayName = "关联科目")
   @Field.many2one
   @Field.Relation(relationFields = {"professionalId"},referenceFields = {"id"})
   private Professional professional;
}

该模型创建的数据库如下：

模型定义在数据库中的映射

科目模型

package pro.shushi.pamirs.top.api.model;

import pro.shushi.pamirs.meta.annotation.Field;
import pro.shushi.pamirs.meta.annotation.Model;
import pro.shushi.pamirs.meta.base.IdModel;

import java.util.List;

@Model.model(Professional.MODEL_MODEL)
@Model(displayName = "科目", summary = "科目")
public class Professional extends IdModel {

   public static final String MODEL_MODEL = "top.Professional";

   @Field.String
   @Field(displayName = "科目名称")
   private String professionalName;

}

该模型创建的数据库如下：

模型定义在数据库中的映射

使用@Field.many2one注解管理教师与科目的多对一关系，在表操作时会自动维护关联关系。如果业务上是一对一的关系，在模型定义中建议使用多对一进行关联。

一对多的关系映射

例：设计一张学生表，一张科目表，学生表对科目表属于一对多的关系，在科目表里使用学生ID与学生表进行关联。

学生表student

科目表professional
模型定义在数据库中的映射

那么在Oinone的模型定义中，这两张表定义是这样的;
学生模型

package pro.shushi.pamirs.top.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(Student.MODEL_MODEL)
@Model(displayName = "学生", summary = "学生")
public class Student extends IdModel {

    public static final String MODEL_MODEL = "top.Student";

    @Field(displayName = "学生名字")
    @Field.String
    private String studentName;

    @Field(displayName = "学生ID")
    @Field.Integer
    private Long studentId;
}

该模型创建的数据库如下：
模型定义在数据库中的映射

科目模型

 package pro.shushi.pamirs.top.api.model;

 import pro.shushi.pamirs.meta.annotation.Field;
 import pro.shushi.pamirs.meta.annotation.Model;
 import pro.shushi.pamirs.meta.base.IdModel;

 import java.util.List;

 @Model.model(Professional.MODEL_MODEL)
 @Model(displayName = "科目", summary = "科目")
 public class Professional extends IdModel {

 public static final String MODEL_MODEL = "top.Professional";

     @Field.String
    @Field(displayName = "科目名称")
    private String professionalName;

    @Field(displayName = "关联学生")
    @Field.one2many
    @Field.Relation(relationFields = {"id"},referenceFields = {"studentId"})
    private List<Student> studentList;
}

在科目模型中建立@Field.one2many来管理学生和科目的关联关系。该模型创建的数据库如下：
模型定义在数据库中的映射

多对多关系的关系映射

例：设计一张教师表，一张学生表，教师表对学生表属于多对多的关系，使用中间表管理教师和学生的关联关系。

教师表teacher

模型定义在数据库中的映射

学生表student

模型定义在数据库中的映射

教师学生中间表teacher_rel_student

模型定义在数据库中的映射

那么在Oinone的模型定义中，多对多关系是这样定义的;

教师模型

package pro.shushi.pamirs.top.api.model;

import pro.shushi.pamirs.meta.annotation.Field;
import pro.shushi.pamirs.meta.annotation.Model;
import pro.shushi.pamirs.meta.base.IdModel;

import java.util.List;

@Model.model(Teacher.MODEL_MODEL)
@Model(displayName = "教师", summary = "教师")
public class Teacher extends IdModel {

   public static final String MODEL_MODEL = "top.Teacher";

   @Field.String
   @Field(displayName = "教师名字")
   private String teacherName;

   @Field(displayName = "教师关联学生")
   @Field.many2many(through = TeacherRelStudent.MODEL_MODEL, relationFields = {"teacherId"}, referenceFields = {"studentId"})
   @Field.Relation(relationFields = {"id"}, referenceFields = {"id"})
   private List<Student> studentList;
}

该模型创建的数据库如下：

模型定义在数据库中的映射

学生模型

package pro.shushi.pamirs.top.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(Student.MODEL_MODEL)
@Model(displayName = "学生", summary = "学生")
public class Student extends IdModel {

   public static final String MODEL_MODEL = "top.Student";

   @Field(displayName = "学生名字")
   @Field.String
   private String studentName;
}

该模型创建的数据库如下：

模型定义在数据库中的映射

教师学生关系模型

package pro.shushi.pamirs.top.api.model;

import pro.shushi.pamirs.meta.annotation.Field;
import pro.shushi.pamirs.meta.annotation.Model;
import pro.shushi.pamirs.meta.base.BaseRelation;

@Model.model(TeacherRelStudent.MODEL_MODEL)
@Model(displayName = "教师学生关系表", summary = "教师学生关系表")
public class TeacherRelStudent extends BaseRelation {

   public static final String MODEL_MODEL = "top.TeacherRelStudent";

   @Field.Integer
   @Field(displayName = "教师ID")
   private Long teacherId;

   @Field.Integer
   @Field(displayName = "学生ID")
   private Long studentId;
}

该模型创建的数据库如下：

模型定义在数据库中的映射

使用@Field.many2many注解以及中间管理关联关系，在表操作时自动维护关联关系。

关联字段的使用详见O2M、M2O、M2M关系字段

Oinone社区作者：yexiu原创文章，如若转载，请注明出处：https://doc.oinone.top/dai-ma-shi-jian/16109.html

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

yexiu数式员工

0 0

如何自定义指定页面的样式

上一篇 2024年8月16日 pm4:24

树型表格全量加载数据如何处理

下一篇 2024年8月17日 pm3:50

代码实践

系统图标使用自定义CDN地址(内网部署)

在实际项目中，客户网络环境不能访问外网即纯内网部署。此时需要将所有的静态资源都放在客户内部的CDN上，该篇详细说明实现步骤。实现步骤 1、把图片等静态资源上传到本地CDN上（如MINIO、Nginx等），图片等静态资源找数式支持人员提供；【注意】：MINIO情况，放置图片等静态资源的桶权限需设置为公共读； 2、项目中YAML的OSS配置，使用本地CDN、并指定使用的本地CDN图标的标识appLogoUseCdn: true, OSS配置参考如下：本地CDN使用MINIO（仅示例需根据实际情况修改） cdn: oss: name: MINIO type: MINIO # MINIO的配置根据实际情况修改 bucket: pamirs(您的bucket) # 上传和下载地址根据实际情况修改 uploadUrl: http://39.103.145.77:9000 downloadUrl: http://39.103.145.77:9000 accessKeyId: 您的accessKeyId accessKeySecret: 您的accessKeySecret # mainDir对用CDN的图片目录，根据项目情况自行修改 mainDir: upload/demo/ validTime: 3600000 timeout: 600000 active: true referer: # 使用客户自己的CDN的图片，否则系统默认的从数式的CDN中获取 appLogoUseCdn: true 或本地CDN使用Nginx（仅示例需根据实际情况修改） cdn: oss: name: 本地文件NG系统 type: LOCAL bucket: # uploadUrl 这个是Oinone后端服务地址和端口 uploadUrl: http://192.168.0.129:8099 # downloadUrl前端地址，即直接映射在nginx的静态资源的路径和端口 downloadUrl: http://192.168.0.129:9999 validTime: 3600000 timeout: 600000 active: true referer: # 本地Nginx静态资源目录 localFolderUrl: /opt/pamirs/static # 使用客户自己的CDN的图片，否则系统默认的从数式的CDN中获取 appLogoUseCdn: true 3、前端工程3.1 前端源码工程，在.evn中把 STATIC_IMG地址进行修改；http(https)、IP和端口改成与CDN对应的配置，URL中/oinone/static/images是固定的；例如：本地CDN使用MINIO（仅示例需根据实际情况修改） STATIC_IMG: 'http://39.103.145.77:9000/pamirs(这里替换为OSS中的bucket)/oinone/static/images' 或本地CDN使用Nginx（仅示例需根据实际情况修改） STATIC_IMG: 'http://192.168.0.129:9999/static/oinone/static/images' 3.2 对于已经打包好的前端资源对于已打包好的前端资源即无法修改.evn的情况；需在前端资源的根目录，新建config/manifest.js. 如果已存在则不需要新建，同时原来的内容也不需要删除（追加即可），需增加的配置：本地CDN使用MINIO（仅示例需根据实际情况修改） runtimeConfigResolve({ STATIC_IMG: 'http://39.103.145.77:9000/pamirs(这里替换为OSS中的bucket)/oinone/static/images', plugins: { usingRemote: true } }) 或本地CDN使用Nginx（仅示例需根据实际情况修改） runtimeConfigResolve({ STATIC_IMG: 'http://192.168.0.129:9999/static/oinone/static/images', plugins: { usingRemote: true } })

望闲
2025年2月8日
1.2K000
代码实践

集成设计器数据流程、流程设计器可以暴露接口触发

集成设计器数据流程暴露接口触发需求：在集成设计器配置的连接器、数据流程链接到外部接口，需要可以有一个管理页面，统一管理这些集成配置。比如对接多个医院的挂号系统，希望可以配置好数据流程之后，能够在已经实现的开放接口上，动态的调用集成平台配置的数据流程。连接器暴露接口触发设计连接器资源配置模型。使用业务ID+接口唯一标识+连接器实现连接器资源和业务唯一。 @Model.model(EipConnectorResourceSetting.MODEL_MODEL) @Model(displayName = "连接器资源配置", summary = "连接器资源配置") @Model.Advanced(unique = {"hospitalId, interfaceUnique"}) public class EipConnectorResourceSetting extends IdModel { public static final String MODEL_MODEL = "hr.simple.EipConnectorResourceSetting"; @UxTableSearch.FieldWidget(@UxWidget()) @Field(displayName = "医院", required = true) @Field.Relation(relationFields = {"hospitalId"}, referenceFields = {"id"}) private Hospital hospital; @Field.Integer @Field(displayName = "医院ID", invisible = true) private Long hospitalId; @UxTableSearch.FieldWidget(@UxWidget()) @Field.String @Field(displayName = "接口唯一标识", required = true) private String interfaceUnique; @UxTableSearch.FieldWidget(@UxWidget()) @Field.many2one @Field(displayName = "连接器", required = true) @Field.Relation(relationFields = {"connectorId"}, referenceFields = {"id"}) private EipConnector connector; @Field.Integer @Field(displayName = "连接器ID", invisible = true) private Long connectorId; @UxTableSearch.FieldWidget(@UxWidget()) @Field.many2one @Field(displayName = "连接器接口", required = true) @Field.Relation(relationFields = {"integrationInterfaceId"}, referenceFields = {"id"}, domain = "connectorId==${activeRecord.connector.id}") private EipConnectorResource connectorResource; @Field.Integer @Field(displayName = "连接器接口ID", invisible = true) private Long connectorResourceId; } 开放接口定义，文档参考：https://doc.oinone.top/oio4/9326.html外部平台调用开放接口，实现动态调用连接器资源 @Model.model(HospitalSection.MODEL_MODEL) @Model(displayName = "医院科室", summary = "医院科室") public class HospitalSection extends IdModel { public static final String MODEL_MODEL = "net.example.HospitalSection"; @Field(displayName = "科室Code", required = true) private String deptCode; @Field(displayName = "科室名称", required = true) private String deptName; @Field(displayName = "科室描述") private String deptDesc; } @Slf4j @Fun @Component public class TestOpenService { @Resource private TestCommonService testCommonService;…

yexiu
2025年4月21日
595000
代码实践

如何扩展行为权限

注意：5.2.8 以上版本适用需求我们的权限控制需要在页面上有交互才可以在管理中心控制该动作权限，在没有页面交互的动作是不能进行授权操作的。所以本文章将介绍如何将页面上没有交互的动作接入到系统权限中管理。一、扩展系统权限的菜单页面实现步骤：创建授权节点实现权限节点扩展接口：pro.shushi.pamirs.auth.api.extend.load.PermissionNodeLoadExtendApi#buildRootPermissions @Component @Order(88) public class MyTestNodeLoadExtend implements PermissionNodeLoadExtendApi { public static final String MODEL = AuthTest.MODEL_MODEL; public static final String MODULE = TopModule.MODULE_MODULE; public static final String FUN = "dataStatus"; @Override public List<PermissionNode> buildRootPermissions(PermissionLoadContext loadContext, List<PermissionNode> nodes) { //创建授权根节点 PermissionNode root = createMyNode(); List<PermissionNode> newNodes = new ArrayList<>(); //从缓存中读取需要授权的Action Action cacheAction = PamirsSession.getContext().getExtendCache(ActionCacheApi.class).get(MODEL, FUN); if (cacheAction != null) { //将该Action放入权限树 //权限鉴权的path路径是根据【cacheAction.getModel() + cacheAction.getName()】拼接的。和MODULE没有关系，这里MODULE可以自定义。 AuthNodeHelper.addNode(newNodes, root, AuthNodeHelper.createActionNode(MODULE, cacheAction, root)); } nodes.add(0, root); return newNodes; } private PermissionNode createMyNode() { return AuthNodeHelper.createNodeWithTranslate("MyNode", "自定义节点"); } } 在管理中心中我们可以看到代码里创建的授权节点。给角色分配该动作的权限，调用我们配置的AuthTest模型的dataStatus动作看效果。二、扩展菜单下的动作权限实现步骤：创建viewAction用于作为权限菜单"permissionExtension"是自定义的viewAction的name，用于下面拼path路径鉴权。因为这里只需要在系统权限那边利用这个viewAction创建出授权节点。所以”权限扩展form“可以随意定义名字，系统会拿默认视图。 @Model.model(AuthTest.MODEL_MODEL) @Component @UxRouteButton( action = @UxAction(name = "permissionExtension", displayName = "权限扩展", label = "权限扩展", contextType = ActionContextTypeEnum.CONTEXT_FREE), value = @UxRoute(model = AuthTest.MODEL_MODEL, viewName = "权限扩展form", openType = ActionTargetEnum.ROUTER)) public class AuthTestAction { @Action(displayName = "启用", contextType = ActionContextTypeEnum.SINGLE) public AuthTest dataStatus(AuthTest data) { data.setOrgName("给个值"); return data; } } 创建授权节点实现权限节点扩展接口：pro.shushi.pamirs.auth.api.extend.load.PermissionNodeLoadExtendApi#buildRootPermissions @Component @Order(88) public class MyTestNodeLoadExtend implements PermissionNodeLoadExtendApi { //创建授权根节点 @Override public List<PermissionNode> buildRootPermissions(PermissionLoadContext loadContext, List<PermissionNode> nodes) { PermissionNode root = AuthNodeHelper.createNodeWithTranslate("CustomNode", "自定义节点"); List<PermissionNode> newNodes = new ArrayList<>(); newNodes.add(root); ViewAction viewAction = new ViewAction().setModel(AuthTest.MODEL_MODEL).setName("permissionExtension").queryOne(); //将该Action放入权限树 //权限鉴权的path路径是根据【viewAction.getModel(),…

yexiu
2024年11月1日
874000
代码实践

如何选择适合的模型类型？

介绍通过Oinone 7天从入门到精通的模型的类型章节我们可以知道模型有抽象模型、存储模型、代理模型、传输模型这四种。但是在在定义模型的时候我们可能不知道该如何选择类型，下面结合业务场景为大家讲解几种模型的典型使用场景。抽象模型抽象模型往往是提供公共能力和字段的模型，它本身不会直接用于构建协议和基础设施（如表结构等）。场景：猫、鸟都继承自动物这个抽象模型 package pro.shushi.pamirs.demo.api.model; import pro.shushi.pamirs.meta.annotation.Field; import pro.shushi.pamirs.meta.annotation.Model; import pro.shushi.pamirs.meta.annotation.sys.Base; import pro.shushi.pamirs.meta.base.IdModel; import pro.shushi.pamirs.meta.enmu.ModelTypeEnum; @Base @Model.model(AbstractAnimal.MODEL_MODEL) @Model.Advanced(type = ModelTypeEnum.ABSTRACT) @Model(displayName = "动物") public abstract class AbstractAnimal extends IdModel { public static final String MODEL_MODEL = "demo.AbstractAnimal"; @Field.String @Field(displayName = "名称") private String name; @Field.String @Field(displayName = "颜色") private String color; } package pro.shushi.pamirs.demo.api.model; import pro.shushi.pamirs.meta.annotation.Field; import pro.shushi.pamirs.meta.annotation.Model; @Model.model(Cat.MODEL_MODEL) @Model(displayName = "猫") public class Cat extends AbstractAnimal { private static final long serialVersionUID = -5104390780952634397L; public static final String MODEL_MODEL = "demo.Cat"; @Field.Integer @Field(displayName = "尾巴长度") private Integer tailLength; } package pro.shushi.pamirs.demo.api.model; import pro.shushi.pamirs.meta.annotation.Field; import pro.shushi.pamirs.meta.annotation.Model; @Model.model(Bird.MODEL_MODEL) @Model(displayName = "鸟") public class Bird extends AbstractAnimal { private static final long serialVersionUID = -5144390780952634397L; public static final String MODEL_MODEL = "demo.Bird"; @Field.Integer @Field(displayName = "翼展宽度") private Integer wingSpanWidth; } 存储模型存储模型用于定义数据表结构和数据的增删改查（数据管理器）功能，是直接与连接器进行交互的数据容器。场景：存储模型对应传统开发模式中的数据表，上面例子中的Cat和Birdd都属于传输模型，由于模型定义的注解@Model.Advanced(type = ModelTypeEnum.STORE)默认值就是存储模型，所以一般不用手动指定代理模型代理模型是用于代理存储模型的数据管理器能力，同时又可以扩展出非存储数据信息的交互功能的模型。场景一：隔离数据权限场景二：增强列表的搜索项场景三：导入导出的时候增加其他特殊信息场景四：重写下拉组件的查询逻辑做数据过滤传输模型传输模型不会在数据库生成的表，只是作为数据的传输使用，跟传统开发模式中的DTO有一点相似。场景一：批量处理数据场景二：处理一些跟数据表无关的操作，如：清理指定业务的缓存、查看一些系统监控信息，可以根据业务信息建立对应的传输模型，在传输模型上创建action动作场景三：通过传输模型完成复杂页面数据传输

nation
2024年4月7日
1.4K002
代码实践

如何把平台功能菜单加到项目中？

概述在使用Oinone低代码平台进行项目开发的过程中，会存在把平台默认提供的菜单加到自己的项目中。这篇文章介绍实现方式，以角色管理为例。 1. 低代码情况即项目是通过后端代码初始化菜单的方式。通常在 XXXMenu.java类通过@UxMenu注解的方式，代码片段如下：此种情况与添加项目本地的菜单无区别，具体代码： @UxMenu(value = "账号管理", icon = "icon-yonghuguanli") class AccountManage { @UxMenu("用户管理") @UxRoute(value = CustomerCompanyUserProxy.MODEL_MODEL, title = "用户管理") class CompanyUserManage { } @UxMenu("角色管理") @UxRoute(value = AuthRole.MODEL_MODEL, module = AdminModule.MODULE_MODULE, title = "角色管理") class RoleManage { } @UxMenu("操作日志") @UxRoute(value = OperationLog.MODEL_MODEL, module = AdminModule.MODULE_MODULE/***菜单所挂载的模块**/) class OperateLog { } } 2. 无代码情况在界面设计器中，新建菜单–>选择绑定已有页面，进行发布即可。

望闲
2024年4月19日
1.7K000

登录后才能评论

shao 2024年11月25日

支持其他的国家的语言，需要在资源里面创建，如果有其他的疑问，也可以群内联系我们哈

评论于 6.4 国际化之多语言
xiao3 2024年11月25日

只支持英语吗？如何添加其他语种？

评论于 6.4 国际化之多语言
psyy 2024年8月21日

1.4 Oinone对软件特性的思考，技术原理一段，几余（几->冗） 1.4 Oinone对软件特性的思考，协同演进一段，新特生（生->性）

评论于 1.4 Oinone对软件特性的思考
望闲 2024年6月21日

感谢反馈，已修正

评论于 1.5 Oinone与行业对比
xinf 2024年6月14日

bug反馈：采用无一体设计 -> 采用低无一体设计

评论于 1.5 Oinone与行业对比

模型定义在数据库中的映射

模型定义在数据库中的映射

相关推荐

系统图标使用自定义CDN地址(内网部署)

集成设计器数据流程、流程设计器可以暴露接口触发

如何扩展行为权限

如何选择适合的模型类型？

如何把平台功能菜单加到项目中？

Leave a Reply