SmartDb-Java轻量级 Java ORM 框架

联合创作 · 2023-09-30 01:35

SmartDb 是以SQL为中心,支持多数据源、读写分离,同时又不与原有项目mybatis、hibernate冲突的非常轻量级的Java ORM框架。


特性如下:



  • 支持ORM操作、常见增删改查、批量、分页等功能

  • 支持MySQL、Oracle、Postgresql、SqlServer

  • 支持在mybatis、hibernate等项目上引入SmartDb

  • 支持多数据源

  • 支持分写分离

  • 支持枚举Enum映射

  • 支持Spring和Spring事务

  • 支持SQL链式API

  • 支持代码生成

  • 支持 filter 过滤器

  • 所有类均可扩展

  • 支持Java 6 ( 收费,收费是为了更好的伺候 “客官 ”  )


SmartDb文档


gitee地址: https://gitee.com/lab1024/smartdb


文档地址:https://zhuoluodada.cn/smartdb


SmartDb特点


mybatis现在在国内已经是一家独大,而且也非常好用,笔者也推荐在大型项目中使用mybatis这种框架,但是总有一些场景,mybatis显得有些力不从心,这个时候选择SmartDb是一个不错的选择。



  • 在原有mybatis或hibernate连接其他数据库进行一些数据处理

  • 读写分离场景,有些数据需要操作主库,有些操作从库

  • 多数据源场景,要从mysql读出数据,然后进行转换存储到sqlserver中,等等

  • 在一个方法中进行多个数据源的数据库操作

  • 一个简单并追求开发效率的小型项目,例如 [SmartBlog(卓大的官方博客)](https://zhuoluodada.cn "SmartBlog(一个精心雕琢的博客)")

  • 不想使用sharding-sphere,sharding-jdbc, mycat,cobar等重型读写分离框架

  • 等等其他


基于以上种种,设计了一个支持多数据源、读写分离的轻量级ORM框架:SmartDb, 让使用者有个极致的开发体验。


SmartDb演示


引入



<dependency>
<groupId>net.1024lab</groupId>
<artifactId>smartdb</artifactId>
<version>1.0.0</version>
</dependency>

SmartDb 操作多数据源(在一个方法中操作多个数据库,不用再使用注解切换来切换去,还不容易出错, oh yeah~)



public void multiDatasource(UserEntity userEntity) {
// mysqlSmartDb 对象为 连接SqlServer的SmartDb
SmartDb mysqlSmartDb = build1();
// sqlServerSmartDb 对象为 连接SqlServer的SmartDb
SmartDb sqlServerSmartDb = build2();
// 将数据插入mysql数据库
mysqlSmartDb.insert(userEntity);
// 将数据插入sql server数据库
sqlServerSmartDb.insert(userEntity);
}

SmartDb ORM操作



UserEntity userEntity = new UserEntity(1, "zhuoda");
// 插入
smartDb.insert(userEntity);
smartDb.insertSelective(userEntity); // 非空字段插入
smartDb.batchInsert(userList);//批量插入
// 更新
smartDb.update(userEntity);
smartDb.updateSelective(userEntity); // 非空字段更新
// 删除
smartDb.delete(userEntity);//根据主键删除

SmartDb 读写分离操作



//默认操作 都是操作从库
List<UserEntity> userList = smartDb.selectSqlBuilder()
.select("*")
.from(UserEntity.class)
.queryList(UserEntity.class);

//获取写库
SmartDb writeSmartDb = smartDb.getMaster();
//将数据写入主库
writeSmartDb.insert(userEntity);
//进行主库其他操作
writeSmartDb.delete(userEntity);
writeSmartDb.updateSelective(userEntity);

SmartDb 链式Builder操作


SmartDb 链式SelectBuilder操作(支持and、or、in、like、group、having、limit等等)



UserEntity userEntity = smartDb.selectSqlBuilder()
.select("user.*")
.select("score.*")
.from(UserEntity.class)
.joinLeft("t_score on t_user.id = t_score.user_id")
.whereAnd("user.id = ?", 1)
.whereAnd("type = 3")
.whereAndIn(" status ", Arrays.asList(1, 2, 3))
.groupby("user.type")
.havingAnd("user.type = 1")
.queryFirst(UserEntity.class);

SmartDb 链式InsertBuilder操作



smartDb.insertSqlBuilder()
.table("t_user")
.insertColumn("id",1)
.insertColumn("name","smartdb")
.insertFunctionColumn("login_time","now()") //sql方法
.execute();

SmartDb 链式UpdateBuilder操作



smartDb.updateSqlBuilder()
.table("t_user")
.updateColumn("name = ?","smart")
.updateColumn(" login_time = now()")
.whereAnd("id = 1")
.execute();

SmartDb 链式DeleteBuilder操作



smartDb.deleteSqlBuilder()
.table("t_user")
.whereAnd("id = 1")
.execute();

SmartDb 链式ReplaceBuilder操作



smartDb.replaceSqlBuilder()
.table("t_user")
.replaceColumn("id",1)
.replaceColumn("name","smartdb")
.replaceFunctionColumn("login_time","now()")
.execute();

创建 SmartDb 



SmartDb smartDb =
SmartDbBuilder.create()
//设置 写库 数据源
.setMasterDataSource(writeDataSource)
//设置 两个读库 数据源
.setSlaveDataSource(readDataSource1,readDataSource2)
// 打印 info 级别sql
.setShowSql(true)
//设置数据库类型
.setSupportDatabaseType(SupportDatabaseType.MYSQL)
//设置支持spring
.setSmartDbExtEnum(SmartDbExtEnum.SPRING5)
//表名与类名转换
.setTableNameConverter(cls -> "t_" + CaseFormat.UPPER_CAMEL.to(CaseFormat.LOWER_UNDERSCORE, cls.getSimpleName()))
//列名字 转换
.setColumnNameConverter(new CaseFormatColumnNameConverter(CaseFormat.LOWER_CAMEL, CaseFormat.LOWER_UNDERSCORE))
.build();

 

浏览 37
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

编辑 分享
举报