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

yexiu • 2024年8月16日 pm5:01 • 代码实践 • 1722 views

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

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低代码应用平台体验

Like (1)

yexiu数式员工

0 0

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

Previous 2024年8月16日 pm4:24

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

Next 2024年8月17日 pm3:50

代码实践

查询时自定义排序字段和排序规则

指定字段排序平台默认排序字段，参考IdModel，按创建时间和ID倒序(ordering = "createDate DESC, id DESC") 方法1：模型指定排序模型定义增加排序字段。@Model.Advanced(ordering = "xxxxx DESC, yyyy DESC") @Model.model(PetShop.MODEL_MODEL) @Model(displayName = "宠物店铺",summary="宠物店铺",labelFields ={"shopName"}) @Model.Code(sequence = "DATE_ORDERLY_SEQ",prefix = "P",size=6,step=1,initial = 10000,format = "yyyyMMdd") @Model.Advanced(ordering = "createDate DESC") public class PetShop extends AbstractDemoIdModel { public static final String MODEL_MODEL="demo.PetShop"; // ………… } 方法2：Page查询中可以自定排序规则 API参考 pro.shushi.pamirs.meta.api.dto.condition.Pagination#orderBy public <G, R> Pagination<T> orderBy(SortDirectionEnum direction, Getter<G, R> getter) { if (null == getSort()) { setSort(new Sort()); } getSort().addOrder(direction, getter); return this; } 具体示例 @Function.Advanced(type= FunctionTypeEnum.QUERY) @Function.fun(FunctionConstants.queryPage) @Function(openLevel = {FunctionOpenEnum.API}) public Pagination<PetShop> queryPage(Pagination<PetShop> page, IWrapper<PetShop> queryWrapper){ page.orderBy(SortDirectionEnum.DESC, PetShop::getCreateDate); page = new PetShop().queryPage(page, queryWrapper); return page; } 方法3：查询的wapper中指定 API参考：pro.shushi.pamirs.framework.connectors.data.sql.AbstractWrapper#orderBy @Override public Children orderBy(boolean condition, boolean isAsc, R… columns) { if (ArrayUtils.isEmpty(columns)) { return typedThis; } SqlKeyword mode = isAsc ? ASC : DESC; for (R column : columns) { doIt(condition, ORDER_BY, columnToString(column), mode); } return typedThis; } 具体示例 public List<PetShop> queryList(String name) { List<PetShop> petShops = Models.origin().queryListByWrapper( Pops.<PetShop>lambdaQuery().from(PetShop.MODEL_MODEL) .orderBy(true, true, PetShop::getCreateDate) .orderBy(true, true, PetShop::getId) .like(PetShop::getShopName, name)); return petShops; } 设置查询不排序方法1：关闭平台默认排序字段，设置模型的ordering，改成：ordering = "1=1" 模型定义增加排序字段。@Model.Advanced(ordering = "1=1") @Model.model(PetShop.MODEL_MODEL) @Model(displayName = "宠物店铺",summary="宠物店铺",labelFields ={"shopName"}) @Model.Code(sequence = "DATE_ORDERLY_SEQ",prefix = "P",size=6,step=1,initial = 10000,format = "yyyyMMdd") @Model.Advanced(ordering =…

望闲
2024年5月25日
3.0K000
代码实践

Excel添加水印功能

实现ExcelWriteHandlerExtendApi接口从而实现对Excel增加复杂功能的操作。如添加水印。具体实现请自行百度 /** * 根据上下文判断是否执行 * * @param context Excel定义上下文 * @return 是否执行该扩展 */ boolean match(ExcelDefinitionContext context); /** * 构建出一个WriteWorkbook对象，即一个工作簿对象，对应的是一个Excel文件； * * @param builder 可用于设置inMemory=true实现复杂功能（如添加水印） */ default void extendBuilder(ExcelWriterBuilder builder) { } 例：Excel添加水印本例参考文章：Java使用EasyExcel导出添加水印实现ExcelWriteHandlerExtendApi接口，并添加@Component注解添加依赖包 <!– eaysexcel –> <dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.3.2</version> </dependency> <!– poi 添加水印 –> <dependency> <groupId>org.apache.poi</groupId> <artifactId>ooxml-schemas</artifactId> <version>1.4</version> </dependency> <!– 使用了hutool的工具类 –> <dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-all</artifactId> <version>5.8.20</version> </dependency> package pro.shushi.pamirs.top.core.temp; import cn.hutool.core.img.ImgUtil; import com.alibaba.excel.write.builder.ExcelWriterBuilder; import com.alibaba.excel.write.metadata.holder.WriteSheetHolder; import com.alibaba.excel.write.metadata.holder.WriteWorkbookHolder; import org.apache.poi.openxml4j.opc.PackagePartName; import org.apache.poi.openxml4j.opc.PackageRelationship; import org.apache.poi.openxml4j.opc.TargetMode; import org.apache.poi.ss.usermodel.Workbook; import org.apache.poi.xssf.usermodel.XSSFPictureData; import org.apache.poi.xssf.usermodel.XSSFRelation; import org.apache.poi.xssf.usermodel.XSSFSheet; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.springframework.stereotype.Component; import pro.shushi.pamirs.file.api.context.ExcelDefinitionContext; import pro.shushi.pamirs.file.api.easyexcel.ExcelWriteHandlerExtendApi; import java.awt.*; import java.awt.image.BufferedImage; @Component public class CustomWaterMarkHandler implements ExcelWriteHandlerExtendApi { private final WaterMark watermark; public CustomWaterMarkHandler() { this.watermark = new WaterMark().setContent("ABC"); } @Override public void extendBuilder(ExcelWriterBuilder builder) { builder.inMemory(true); } @Override public boolean match(ExcelDefinitionContext context) { return DemoTemplate.TEMPLATE_NAME.equals(context.getName()); } @Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { try { BufferedImage bufferedImage = createWatermarkImage(); setWaterMarkToExcel((XSSFWorkbook) writeWorkbookHolder.getWorkbook(), bufferedImage); } catch (Exception e) { throw new RuntimeException("添加水印出错",e); } } private BufferedImage createWatermarkImage() { final Font font = watermark.getFont(); final int width = watermark.getWidth(); final int height = watermark.getHeight(); String[] textArray…

yexiu
2024年9月6日
2.9K001
代码实践

【前端】项目开发前端知识要点地图

概述下面整理了目前现有的所有文章，并提供了基本的学习路径。所有使用*标记的文章属于推荐必读文章。目录基础篇【路由】浏览器地址栏url参数介绍母版-布局-DSL 渲染基础（v4）* 组件SPI机制（v4）* 组件数据交互基础（v4）* 组件生命周期（v4）入门篇自定义视图组件（v4）* 如何通过浏览器开发者工具提高调试效率* 如何提高自定义组件的开发效率* 自定义组件之自动渲染（组件插槽的使用）（v4）* GraphQL请求详解（v4）* 上下文在字段和动作中的应用如何实现页面间的跳转如何自定义指定页面的样式进阶篇自定义组件之手动渲染基础（v4）自定义组件之手动渲染弹出层（v4）自定义组件之手动渲染任意视图（v4）【前端】IOC容器（v4）最佳实践篇【前端】工程结构最佳实践（v4）* 【前端】移动端工程结构最佳实践（v4）* 界面设计器实战篇基础篇【界面设计器】模型增删改查基础【界面设计器】他表字段【界面设计器】左树右表【界面设计器】树形表格【界面设计器】树下拉/级联选择【界面设计器】自定义字段组件基础展示篇【界面设计器】自定义字段组件实战——轮播图【界面设计器】自定义字段组件实战——表格字段组合展示【界面设计器】自定义字段组件实战——表格字段内嵌表格交互篇【界面设计器】自定义字段组件实战——千分位输入框其他前端低无一体使用教程如何自定义表格字段？【界面设计器】组件开发常见问题【前端】低无一体部署常见问题【前端】生产环境性能调优 API文档 OioProvider详解（v4.3.0）* 前端环境配置（v4）* 默认布局模板（v4）表格主题配置（v4）运行时上下文API文档（v4） Class Component(ts)（v4）

数式-海波
2024年5月25日
5.8K000
代码实践

Nacos做为注册中心：如何调用其他系统的SpringCloud服务？

Oinone项目引入Nacos作为注册中心，调用外部的SpringCloud服务 Nacos可以做为注册中心，提供给Dubbo和SpringCloud等微服务框架使用。目前Oinone的底层使用的是Dubbo进行微服务的默认协议调用，但是我们项目如果存在需要调用其他系统提供的SpringCloud服务，Oinone其实并没有限制大家去这么写代码。可以参考Nacos或SpringCloud的官方文档，只要不存在Jar包冲突等场景，很多的扩展其实大家都可以使用。注意！！！Nacos、SpringCloud、SpringCloudAlibaba是有依赖版本严格要求的：点击查看具体示例：一、项目中增加依赖主pom引入兼容的版本： <dependencyManagement> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-alibaba-dependencies</artifactId> <version>2.2.7.RELEASE</version> <!– 目前兼容的版本 –> <type>pom</type> <scope>import</scope> </dependency> </dependencyManagement> 使用模块的pom引入依赖： <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-openfeign</artifactId> </dependency> 二、配置 application.yml spring: cloud: nacos: discovery: server-addr: localhost:8848 username: nacos password: nacos 三、启动类添加注解 @EnableDiscoveryClient @EnableFeignClients public class NacosConsumerApplication { public static void main(String[] args) { SpringApplication.run(NacosConsumerApplication.class, args); } } 四、验证创建 Feign Client 接口 import org.springframework.cloud.openfeign.FeignClient; import org.springframework.web.bind.annotation.GetMapping; @FeignClient(name = "nacos-demo") // 指定目标服务的名称 public interface ProviderClient { @GetMapping("/hello") String hello(); } 创建 Controller 调用 Feign Client @RestController public class ConsumerController { private final ProviderClient providerClient; public ConsumerController(ProviderClient providerClient) { this.providerClient = providerClient; } @GetMapping("/hello") public String hello() { return providerClient.hello(); } } 在浏览器中访问 http://localhost:8082/hello你应该会看到服务提供者返回的响应。

冯, 天宇
2024年6月4日
3.5K000
代码实践

如何扩展行为权限

注意：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日
1.6K000

Please Login to Comment

shao 2024年11月25日

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

Comment on 6.4 国际化之多语言
xiao3 2024年11月25日

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

Comment on 6.4 国际化之多语言
psyy 2024年8月21日

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

Comment on 1.4 Oinone对软件特性的思考
望闲 2024年6月21日

感谢反馈，已修正

Comment on 1.5 Oinone与行业对比
xinf 2024年6月14日

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

Comment on 1.5 Oinone与行业对比

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

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

相关推荐

查询时自定义排序字段和排序规则

Excel添加水印功能

【前端】项目开发前端知识要点地图

Nacos做为注册中心：如何调用其他系统的SpringCloud服务？

如何扩展行为权限

Leave a Reply