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

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

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

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

代码实践

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

一、抽象模型，需要操作流程的模型继承此模型定义流程相关的一些信息在模型中；如果直接定义在存储模型中，下面这些字段都是显示的指定为非存储字段。更好的建议：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日
235000
代码实践

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

概述在使用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.4K000
代码实践

复杂Excel模版定义

模版示例： Demo Excel样例代码示例： @Model.model(TestApply.MODEL_MODEL) @Model(displayName = "测试申请") public class TestApply extends IdModel { public static final String MODEL_MODEL = "top.TestApply"; @Field.String @Field(displayName = "发件人") private String addresser; @Field.String @Field(displayName = "委托单位") private String entrustedUnit; @Field.String @Field(displayName = "付款单位") private String payer; @Field.String @Field(displayName = "付款单位地址") private String paymentUnitAdd; } 模版： package pro.shushi.pamirs.top.core.temp; import org.springframework.stereotype.Component; import pro.shushi.pamirs.file.api.builder.SheetDefinitionBuilder; import pro.shushi.pamirs.file.api.builder.WorkbookDefinitionBuilder; import pro.shushi.pamirs.file.api.enmu.ExcelAnalysisTypeEnum; import pro.shushi.pamirs.file.api.enmu.ExcelDirectionEnum; import pro.shushi.pamirs.file.api.enmu.ExcelHorizontalAlignmentEnum; import pro.shushi.pamirs.file.api.model.ExcelWorkbookDefinition; import pro.shushi.pamirs.file.api.util.ExcelHelper; import pro.shushi.pamirs.file.api.util.ExcelTemplateInit; import pro.shushi.pamirs.top.api.model.TestApply; import java.util.Collections; import java.util.List; @Component public class DemoTemplate implements ExcelTemplateInit { public static final String TEMPLATE_NAME = "DemoTemplate"; @Override public List<ExcelWorkbookDefinition> generator() { WorkbookDefinitionBuilder builder = WorkbookDefinitionBuilder.newInstance(TestApply.MODEL_MODEL, TEMPLATE_NAME) .setDisplayName("测试Demo"); DemoTemplate.createSheet(builder); return Collections.singletonList(builder.build()); } private static void createSheet(WorkbookDefinitionBuilder builder) { SheetDefinitionBuilder sheetBuilder = builder.createSheet().setName("测试Demo"); buildBasicInfo(sheetBuilder); } private static void buildBasicInfo(SheetDefinitionBuilder builder) { //A1:D8：表示表头占的单元格数，范围必须大于实际表头行 BlockDefinitionBuilder mergeRange = builder.createBlock(TestApply.MODEL_MODEL, ExcelAnalysisTypeEnum.FIXED_HEADER, ExcelDirectionEnum.HORIZONTAL, "A1:D8") //预设行 .setPresetNumber(10) //合并哪几个单元格 .createMergeRange("A1:D1") .createMergeRange("A2:D2") .createMergeRange("A3:D3") .createMergeRange("A4:A6") .createMergeRange("B4:B6") .createMergeRange("C4:C6") .createMergeRange("D4:D5"); //createHeader创建行，createCell创建单元格，setField指定解析字段，setIsConfig指定为true标记该行是需要解析的值 mergeRange.createHeader().setStyleBuilder(ExcelHelper.createDefaultStyle()).setIsConfig(Boolean.TRUE) .createCell().setField("addresser").setStyleBuilder(ExcelHelper.createDefaultStyle().setWidth(6000)).and() .createCell().setField("entrustedUnit").and() .createCell().setField("payer").and() .createCell().setField("paymentUnitAdd").and() .and() .createHeader().setStyleBuilder(ExcelHelper.createDefaultStyle(typeface -> typeface.setBold(Boolean.TRUE)).setHorizontalAlignment(ExcelHorizontalAlignmentEnum.CENTER)) .createCell().setValue("Demo").and() .createCell().and() .createCell().and() .createCell().and() .and() //由于该行合并为一个单元格，所以其他可以不设置value .createHeader().setStyleBuilder(ExcelHelper.createDefaultStyle(typeface -> typeface.setBold(Boolean.TRUE)).setHorizontalAlignment(ExcelHorizontalAlignmentEnum.CENTER)) .createCell().setValue("生效金额").and() .createCell().and() .createCell().and() .createCell().and() .and() .createHeader().setStyleBuilder(ExcelHelper.createDefaultStyle(typeface -> typeface.setBold(Boolean.TRUE)).setHorizontalAlignment(ExcelHorizontalAlignmentEnum.RIGHT)) .createCell().setValue("金额单位：元").and() .createCell().and() .createCell().and() .createCell().and() .and() //easyExcel解析不了空行，所以这里写上值。由于上面使用createMergeRange把单元格合并了，并且D列有分割，这里填上每个单元格的值，把合并的单元格填为一样的。 .createHeader().setStyleBuilder(ExcelHelper.createDefaultStyle(typeface -> typeface.setBold(Boolean.TRUE)).setHorizontalAlignment(ExcelHorizontalAlignmentEnum.CENTER)) .createCell().setValue("发件人").and() .createCell().setValue("委托单位").and()…

yexiu
2024年11月18日
1.8K001
代码实践

如何使用位运算的数据字典

场景举例日常有很多项目，数据库中都有表示“多选状态标识”的字段。在这里用我们项目中的一个例子进行说明一下：示例一：表示某个商家是否支持多种会员卡打折（如有金卡、银卡、其他卡等），项目中的以往的做法是：在每条商家记录中为每种会员卡建立一个标志位字段。如图：用多字段来表示“多选标识”存在一定的缺点：首先这种设置方式很明显不符合数据库设计第一范式，增加了数据冗余和存储空间。再者，当业务发生变化时，不利于灵活调整。比如，增加了一种新的会员卡类型时，需要在数据表中增加一个新的字段，以适应需求的变化。 – 改进设计：标签位flag设计二进制的“位”本来就有表示状态的作用。可以用各个位来分别表示不同种类的会员卡打折支持：这样，“MEMBERCARD”字段仍采用整型。当某个商家支持金卡打折时，则保存“1（0001）”，支持银卡时，则保存“2（0010）”，两种都支持，则保存“3（0011）”。其他类似。表结构如图：我们在编写SQL语句时，只需要通过“位”的与运算，就能简单的查询出想要数据。通过这样的处理方式既节省存储空间，查询时又简单方便。 //查询支持金卡打折的商家信息： select * from factory where MEMBERCARD & b'0001'; // 或者： select * from factory where MEMBERCARD & 1; // 查询支持银卡打折的商家信息： select * from factory where MEMBERCARD & b'0010'; // 或者： select * from factory where MEMBERCARD & 2; 二进制( 位运算)枚举可以通过@Dict注解设置数据字典的bit属性或者实现BitEnum接口来标识该枚举值为2的次幂。二进制枚举最大的区别在于值的序列化和反序列化方式是不一样的。位运算的枚举定义示例 import pro.shushi.pamirs.meta.annotation.Dict; import pro.shushi.pamirs.meta.common.enmu.BitEnum; @Dict(dictionary = ClientTypeEnum.DICTIONARY, displayName = "客户端类型枚举", summary = "客户端类型枚举") public enum ClientTypeEnum implements BitEnum { PC(1L, "PC端", "PC端"), MOBILE(1L << 1, "移动端", "移动端"), ; public static final String DICTIONARY = "base.ClientTypeEnum"; private final Long value; private final String displayName; private final String help; ClientTypeEnum(Long value, String displayName, String help) { this.value = value; this.displayName = displayName; this.help = help; } @Override public Long value() { return value; } @Override public String displayName() { return displayName; } @Override public String help() { return help; } } 使用方法示例 API: addTo 和 removeFrom List<ClientTypeEnum> clientTypes = module.getClientTypes(); // addTo ClientTypeEnum.PC.addTo(clientTypes); // removeFrom ClientTypeEnum.PC.removeFrom(clientTypes); 在查询条件中的使用 List<Menu> moduleMenus = new Menu().queryListByWrapper(menuPage, LoaderUtils.authQuery(wrapper).eq(Menu::getClientTypes, ClientTypeEnum.PC));

nation
2023年11月24日
1.2K000
代码实践

推送自定义消息

项目中添加消息依赖 pro.shushi.pamirs.core pamirs-message-api 调用pro.shushi.pamirs.message.engine.message.MessageSender#sendSystemMail发送系统消息示例： @Action(displayName = "发送消息") public Student sendMessage(Student data){ MessageSender mailSender = (MessageSender) MessageEngine.get(MessageEngineTypeEnum.MAIL_SEND).get(null); String content = "发送自定义消息"; String subject = null; List<Long> userIds = new ArrayList<>(); userIds.add(PamirsSession.getUserId()); PamirsMessage message = new PamirsMessage() .setName(subject) .setSubject(subject) .setBody(content) .setMessageType(MessageTypeEnum.NOTIFICATION); List<PamirsMessage> messages = new ArrayList<>(); messages.add(message); SystemMessage systemMessage = new SystemMessage(); systemMessage.setPartners(userIds.stream().map(i -> (PamirsUser) new PamirsUser().setId(i)).collect(Collectors.toList())) .setType(MessageGroupTypeEnum.SYSTEM_MAIL) .setMessages(messages); mailSender.sendSystemMail(systemMessage); return data; }

yexiu
2024年8月19日
934000

登录后才能评论

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与行业对比

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

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

相关推荐

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

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

复杂Excel模版定义

如何使用位运算的数据字典

推送自定义消息

Leave a Reply