nimble-orm基于 Spring jdbcTemplate 的 ORM

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

这是一个基于 Spring JdbcTemplate 的小工具,帮助开发者简单地完成 Mysql 的增删改查。

使用 nimble-orm 的优势

  1. 为互联网频繁的表变动而生。 表名、字段名,仅在代码中出现一次。修改表名只需要改一处地方,修改字段名,仅需改字段注解一次及where子句中涉及的字段名。增加字段只需增加一个表成员。修改量相比MyBatis大大减少。

  2. 实用主义者,注重简单实用的接口。 分页接口、软删除标记位全面支持、数据库乐观锁CAS写法、事务手动回滚、支持SOA远程方式的跨数据库关联查询等。定义完DO之后,无需增加额外配置,调用接口即可。

  3. 贫血模型,纯粹的POJO。 不需要继承指定类或实现接口,纯粹的POJO,适合于各种序列化场景。喜欢Spring就会喜欢nimble-orm。

  4. 没有潜规则约定,一切注解配置,老项目迁移成本极低。 不会约定类成员变量和表字段名的关系,全部需要通过配置指定,老项目不规则的表名字段名,不会影响新代码的命名。强制指定配置,这种“麻烦”会收获到后续代码运维上的很多便利。欠下的技术债总是要还的,何不一开始就描述清楚点?而xml或其它文件格式写sql,导致几个文件来回切换的编码,一个修改另外一个忘记修改就出错的情况,不再出现了,代码内聚,让阅读和维护更简单。

Get Started 示例

      第一步,为每个数据库表建立一个字段一一对应的DO,纯粹的POJO,无需继承类或实现接口。

     第二步,用上注解标明对应的表和字段。看起来像这样,有挺多ORM是这样的形式,但相信我,nimble-orm的接口很简单很不同。

// 这个一个标准的POJO,除了注解,没有引入任何nimble-orm的东西,不要求继承或实现任何东西。
@Table("t_student")
public class StudentDO extends IdableSoftDeleteBaseDO { 
// 这里用不用继承都是等价的,IdableSoftDeleteBaseDO也不需要继承或实现任何nimble-orm的东西。
// 用继承可以框定一些规范(在业务系统中,有些每个表都有的公共字段可以放在父类中)
// 例如业务项目中,很多都有id 软删除标记 新增时间 修改时间 等共同字段,可以放在POJO基类中,不需要每个DO都写
// 即约定了规范,又降低代码量和阅读时间

/** IdableSoftDeleteBaseDO也是单纯的POJO,无需继承或实现任何东西。其内容是:
  @Column(value = "id", isKey = true, isAutoIncrement = true)
  private Long id;
  
  // 软删除标记为,0 未删除,1已删除
  @Column(value = "deleted", softDelete = {"0", "1"})
  private Boolean deleted;
  
  @Column(value = "create_time", setTimeWhenInsert = true)
  private Date createTime;
  
  @Column(value = "update_time", setTimeWhenUpdate = true, setTimeWhenInsert = true)
  private Date updateTime;
*/
		
	@Column("name")
	private String name;
	
	@Column("age")
	private Integer age;
	
	// 标准的 getters / setters,如果提供,nimble-orm就会用;如果没提供,就会直接反射设置字段值
}

     第三步,使用nimble-orm提供的接口,进行各种增删改查吧。例如我要分页查询t_student表中名字姓李的同学或年龄大于20岁的同学,按年龄排序,再按id排序,查第一页,每页10条,来吧:

PageData<StudentDO> pageData = dbHelper.getPage(StudentDO.class, 1, 10,
     "where name like ? or age>? order by age,id", "李%", 20);

// 如果你不需要总数,例如手机端页面只要一直往下翻,直到没有数据为止,那么可以用dbHelper.getPageWithoutCount方法
// 不计算总数,更省资源

System.out.println("total:" + pageData.getTotal());
for(StudentDO studentDO : pageData.getData()) {
    Systemo.out.println(studentDO);
}

     nimble-orm提供了很多实用的接口,相信可以绝大多数匹配你的项目。如果你需要更多,也可以告诉我。

浏览 2
点赞
评论
收藏
分享

手机扫一扫分享

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

手机扫一扫分享

编辑 分享
举报