一、WTM是什么
WalkingTec.Mvvm框架(简称WTM)最早开发与2013年,基于Asp.net MVC3 和 最早的Entity Framework,当初主要是为了解决公司内部开发效率低,代码风格不统一的问题。
2017年9月,将代码移植到了.Net Core上,并进行了深度优化和重构,推出了基于Asp.net Core和EF Core的全新框架,新框架在架构,稳定性,速度上都有长足进步,真正成为一款高效开发的利器。
经历了四年间数十个项目的考验,框架逐步的完善,推出了四个主要版本。
WTM框架设计的核心理念就是”尽一切可能提高开发效率“。
WTM框架把常规编码结构化,重复编码自动化,它不仅是一个框架,它是强有力的生产力工具!
在不分离的模式下,它连通了前台UI和后台代码。你不需要前后台分离,不需要两个人配合,减少成本,缩短工期。
在前后端分离的模式下,同样可以使用代码生成器同时生成前台和后台的代码,极大的降低了前后端人员的沟通成本,从本质上提升了开发效率,让“分离”不再复杂和昂贵。
框架特点:
一键生成WTM项目
一键生成增删改查,导入导出,批量操作代码
支持一对多,多对多关联模型的识别和代码生成
支持React+AntD,Vue+Element,LayUI,Blazor等多种前端模式
支持sqlserver,MysqL,pgsql,sqlite,Oracle等多种数据库
封装了Layui,AntD,Element的大部分控件,编写前台更加简便
提供了很多基类,封装了绝大部分后台常用操作
提供了用户,角色,用户组,菜单,日志等常用模块
支持数据权限的开发和配置
支持读写分离和数据库分库
开源地址:
(GitHub) https://github.com/WalkingTec/WalkingTec.Mvvm
(Gitee) https://gitee.com/liuliang-wtm/WTM
二、人大金仓是什么
人大金仓数据库管理系统[简称:KingbaseES]是北京人大金仓信息技术股份有限公司[简称人大金仓]的核心产品,具有大型通用、"三高"(高可靠、高性能、高安全)、"三易"(易管理、易使用、易扩展)、运行稳定等特点,是唯一入选国家自主创新产品目录的数据库产品,也是国家级、省部级实际项目中应用最广泛的国产数据库产品。
人大金仓数据库管理系统 KingbaseES(KES) 是面向全行业、全客户关键应用的企业级大型通用数据库管理系统,适用于联机事务处理、查询密集型数据仓库、要求苛刻的互联网应用等场景,提供全部应用开发及系统管理功能,提供性能增强特性,可支持主备集群、读写分离集群、多活共享存储集群等全集群架构,具有高性能、高安全、高可用、易使用、易管理、易维护的特点,支持所有国内外主流cpu、操作系统与云平台部署。
下载试用地址:
https://www.kingbase.com.cn/xzzx/index.htm
可在下载页面申请开发试用授权文件,授权时间365天。
安装过程比较简单,唯一需要注意的就是在安装过程中可以选择数据库兼容类型,这里选择的是UTF8字符集,兼容MysqL,大小写不敏感。
三、迁移注意事项
项目用的是.NET6框架,在项目里引用(或者NuGet安装)人大金仓官方的EFCore的Kdbndp驱动Kdbndp.EntityFrameworkCore6.KingbaseES。
1、工作流使用的数据库所属模式手动创建
WTM集成了Elsa的工作流,在迁移的过程中需要把Elsa所需要的几个表迁移到特定的模式下面,否则运行会提示找不到Elsa.xxxx的错误提示;
模式右键-->新建-->Elsa,然后把所需要的这几个表迁移到它下面。
2、字段类型转换
绝大部分的MysqL字段可以无缝迁移到人大金仓,对于MysqL的bool类型的字段需要特别关注一下,会迁移成bit或者int类型,需要手动调整成人大金仓的bool类型;
MysqL的datetime类型,迁移到人大金仓后对应的类型是timestamp。这个需要在DataContext的OnConfiguring中指定一下参数,否则会报以下错误:
System.InvalidCastException: Cannot write DateTime with Kind=Local to Postgresql type 'timestamp with time zone',only UTC is supported. Note that it's not possible to mix DateTimes with different Kinds in an array/range. See the Npgsql.EnableLegacyTimestampBehavior AppContext switch to enable legacy behavior.
具体参考:https://www.npgsql.org/doc/types/datetime.html#timestamps-and-timezones
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
if (DBType == DBTypeEnum.Pgsql)
{
AppContext.SetSwitch("Npgsql.EnableLegacyTimestampBehavior",true);
AppContext.SetSwitch("Npgsql.DisableDateTimeInfinityConversions",true);
}
base.OnConfiguring(optionsBuilder);
}
2、自增字段实现
在MysqL、sqlserver等数据库中,只要把字段设置为int,然后打开自增选项后,字段就会实现自增功能。在人大金仓中,默认没有这种字段类型,官网中称这种为序数类型,类似于Oracle的SEQUENCE:
smallserial、serial 和 bigserial类型不是真正的类型, 它们只是为了创建唯一标识符列而存在的方便符号(类似其它一些数据库中支持的 AUTO_INCREMENT 属性)。 这是 KingbaseES 特有的创建一个自增列的方法。
因为 smallserial、serial 和 bigserial 是用序列实现的,所以即使没有删除过行,在出现在列中的序列值可能有“空洞”或者间隙。如果一个从序列中分配的值被用在一行中,即使该行最终没有被成功地插入到表中,该值也被“用掉”了。例如,当插入事务回滚时就会发生这种情况。更多信息参见序列操作函数中的 nextval()。
在人大金仓中需要通过序列类型实现字段自增的方式,需要我们在数据库的Public模式下的序列中,创建一个序列(这里设置的最大值为bigint的最大值附近,具体可自己决定):
随后,在需要自增的字段,给它的默认值设置为 nextval('USER_SEQUENCE'::regclass) ,这样在每次insert数据的时候,这个字段会自动从序列中获取最新的值来填充(不需要代码中进行赋值)。