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

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

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

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

代码实践

同一行操作跳转到不同的视图（动态表单）

背景实际项目中，存在这样的场景：同一列表中的数据是泛化的数据集合，即数据来源于不同的模型；行操作需要根据来源去向不同的目标页。如下图，「提报」操作需根据「报表类型」去向不同的表单。并支持目标弹窗标题和弹框大小的配置。解决思路每行记录需要跳转到不同的模型不同视图，增加一个配置页面用于维护源模型和目标模型的调整动作关系；返回数据的时候，同时返回自定义的动作。前端自定义实现如上面图例中的「填报」，从返回数据中获取ViewAction并做对应的跳转。具体步骤 [后端] 建立模型和视图的关系设置的模型 1、创建模型和视图的关系设置的模型，用于配置列表模型和各记录即目标模型的视图关系 import pro.shushi.oinone.examples.simple.api.proxy.system.SimpleModel; import pro.shushi.oinone.examples.simple.api.proxy.system.SimpleModule; import pro.shushi.pamirs.boot.base.enmu.ActionTargetEnum; import pro.shushi.pamirs.boot.base.model.View; 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.ViewTypeEnum; /** * 模型和视图的关系设置 * ModelRelViewSetting */ @Model.model(ModelRelViewSetting.MODEL_MODEL) @Model(displayName = "模型和视图的关系设置", summary = "模型和视图的关系设置") @Model.Advanced(unique = {"oModel,model,target,viewType,viewName"}) public class ModelRelViewSetting extends IdModel { public static final String MODEL_MODEL = "examples.custom.ModelRelViewSetting"; @Field.many2one @Field(displayName = "模块") @Field.Relation(relationFields = {"module"}, referenceFields = {"module"}) private SimpleModule moduleDef; @Field.String @Field(displayName = "模块编码", invisible = true) private String module; @Field.many2one @Field(displayName = "源模型") @Field.Relation(relationFields = {"oModel"}, referenceFields = {"model"}) private SimpleModel originModel; @Field.String @Field(displayName = "源模型编码", invisible = true) private String oModel; @Field.many2one @Field(displayName = "目标模型") @Field.Relation(relationFields = {"model"}, referenceFields = {"model"}) private SimpleModel targetModel; @Field.String @Field(displayName = "目标模型编码", invisible = true) private String model; @Field.Enum @Field(displayName = "视图类型") private ViewTypeEnum viewType; @Field.Enum @Field(displayName = "打开方式", required = true) private ActionTargetEnum target; @Field.String @Field(displayName = "动作名称", invisible = true) private String name; @Field.many2one @Field.Relation(relationFields = {"model", "viewName"}, referenceFields = {"model", "name"}, domain = "systemSource=='UI'") @Field(displayName = "绑定页面", summary = "绑定页面") private View view; @Field.String @Field(displayName = "视图/页面", invisible…

yexiu
2025年2月19日
972000
代码实践

工作流：通过业务数据操作工作流程（催办、撤销等）

一、抽象模型，需要操作流程的模型继承此模型定义流程相关的一些信息在模型中；如果直接定义在存储模型中，下面这些字段都是显示的指定为非存储字段。更好的建议：1、如果有多个业务模型有这类需要，则可以把这些字段抽取到抽象模型中2、如果仅有一个业务模型需要，则可以放到代理模型中 /** * 定义流程相关的一些信息在模型中 */ @Model.model(DemoBaseAbstractModel.MODEL_MODEL) @Model(displayName = "抽象模型") @Model.Advanced(type= ModelTypeEnum.ABSTRACT) public abstract class DemoBaseAbstractModel extends IdModel { public static final String MODEL_MODEL = "hr.simple.DemoBaseAbstractModel"; // 流程相关 @Field.Integer @Field(displayName = "工作流用户任务ID", summary = "业务数据列表中审核流程使用", invisible = true, store = NullableBoolEnum.FALSE) private Long workflowUserTaskId; @Field.Integer @Field(displayName = "流程实例ID", summary = "业务数据列表中催办使用", invisible = true, store = NullableBoolEnum.FALSE) private Long instanceId; @Field.String @UxForm.FieldWidget(@UxWidget(invisible = "true")) @UxDetail.FieldWidget(@UxWidget(invisible = "true")) @Field(displayName = "当前流程节点", store = NullableBoolEnum.FALSE) private String currentFlowNode; @Field.Boolean @Field(displayName = "能否催办", invisible = true, defaultValue = "false", store = NullableBoolEnum.FALSE) private Boolean canUrge; // 审批状态控制申请单是否可以被发起流程、能否编辑等控制 @Field.Enum @Field(displayName = "审批状态", defaultValue = "NC") @UxForm.FieldWidget(@UxWidget(invisible = "true")) private ApprovalStatusEnum approvalStatus; } @Dict(dictionary = ApprovalStatusEnum.dictionary, displayName = "审批状态") public enum ApprovalStatusEnum implements IEnum<String> { NC("NC", "待提交", "待提交"), PENDING("PENDING", "已提交", "已提交，待审批"), APPROVED("APPROVED", "已批准", "已批准"), REJECTED("REJECTED", "已拒绝", "已拒绝"); public static final String dictionary = "land.enums.LandApprovalStatusEnum"; private final String value; private final String displayName; private final String help; ApprovalStatusEnum(String value, String displayName, String help) { this.value = value; this.displayName = displayName; this.help = help; } public String getValue() { return value; } public String getDisplayName() { return…

yexiu
2025年6月26日
669000
代码实践

系统图标使用自定义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.3K000
代码实践

部分模型不动态修改表结构(由单独DDL处理)

需求描述实际项目中, 存在部分模型不动态修改表结构，由单独DDL脚本处理，常见的场景有：已存在库和表中使用Oinone进行功能开发，此时对于已经存在的表对应的模型不允许改表结构其他情况不希望动态改变表结构的情况实现步骤新建NODDL的基础模型模型公共字段公共字段说明：使用Oinone进行开发时，业务模型需继承基础IdModel(或者由IdModel衍生出的子类)，这些基础模型有createDate(创建时间)、writeDate(更新时间)、createUid(创建人ID)和writeUid(更新人ID)等公共字段；实际表中公共字段可能与Oinone有所不同。实现方式方式1：公共属性字段用平台提供的createDate、writeDate、createUid和writeUid，通过指定column与表中的实际字段对应.【推荐】该方式，公共字段的处理可以继续使用平台的默认赋值处理方式; 方式2：继承平台的时候，把公共字段排除掉(配置unInheritedFields)，然后自行加通用字段：排除字段：@Model.Advanced(type= ModelTypeEnum.ABSTRACT, ordering = "createAt DESC, id DESC", unInheritedFields = {"createUid","writeUid","createDate","writeDate"})【不推荐】该方式，公共字段的赋值逻辑需要自行处理，略显复杂; 实现方式举例下面的示例以方式1举例；假设表的基础字段分别是：createAt、updateAt、createId和updateId 与平台的不同. 不自动DDL的抽象模型示例 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.FieldStrategyEnum; import pro.shushi.pamirs.meta.enmu.ModelTypeEnum; import java.util.Date; /** * 假设表的基础字段分别是：createAt、updateAt、createId和updateId 与平台的不同 */ @Model.model(BaseNoDdlModel.MODEL_MODEL) @Model(displayName = "不自动DDL的抽象模型") @Model.Advanced(type= ModelTypeEnum.ABSTRACT, ordering = "createAt DESC, id DESC") public abstract class BaseNoDdlModel extends IdModel { public static final String MODEL_MODEL = "hr.std.BaseNoDdlModel"; // 如果原表的主键的列名不是ID的情况，这里可以定义column指定ID属性对应的列名 /** @Field.PrimaryKey @Field(displayName = "主键ID") @Field.Advanced(column = "XLH") private Long id; **/ // 下面这几个字段按实际项目中的情况来增加，包括字段名 @Field.Advanced(columnDefinition = "DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP", column = "createAt", insertStrategy = FieldStrategyEnum.NEVER, updateStrategy = FieldStrategyEnum.NEVER, batchStrategy = FieldStrategyEnum.NEVER) @Field(displayName = "创建时间", priority = 200) private Date createDate; @Field.Advanced(columnDefinition = "DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP", column = "updateAt", batchStrategy = FieldStrategyEnum.NEVER) @Field(displayName = "更新时间", priority = 210) private Date writeDate; @Field.Advanced(column = "createId") @Field(displayName = "创建人ID", priority = 220, invisible = true) private Long createUid; @Field.Advanced(column = "updateId") @Field(displayName = "更新人ID", priority = 230, invisible = true) private Long writeUid; } 不需动态DDL的业务模型，业务模型继承BaseNoDdlModel。其他业务模型如果有相同的需求类似的做法 /** * 测试合同表 */ @Model.model(InspectionInfo.MODEL_MODEL) @Model(displayName = "合同", labelFields…

望闲
2025年2月22日
1.1K001
代码实践

如何改变调度策略，让Schedule独立执行线程

schedule里，相同的taskType跑多个业务任务，如果其中一个任务大量重试占满了调度线程，会影响别的业务任务及时被执行，如下面截图中，taskType用的是平台内置的常量，这个常量会被其他任务也使用，如果当前任务出现了异常占用了这个taskType的所有线程，那么这个taskType下面的其他任务就会被阻塞延后执行。应该给需要业务及时性的任务单独建立自定义的taskType，这样每个taskType的线程就是独立的，A任务异常不会影响B任务的执行。 1、后台创建task type相关的类，继承BaseScheduleNoTransactionTask，要加springbean的注解，参考：task type建议使用类名 2、提交任务的时候，设置tasktype为步骤1的TaskType 3、控制台新增策略和任务bean名称为步骤1的spring beanName，任务名称 $xxx，右边的占位符内容为yml里面配置的ownSign字段任务的名称也是步骤1的 spring beanName 4、配置完成后，控制台启动任务，就可以测试了

shao
2024年2月20日
992000

登录后才能评论

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地址(内网部署)

部分模型不动态修改表结构(由单独DDL处理)

如何改变调度策略，让Schedule独立执行线程

Leave a Reply