简述
官方文档的介绍如下:MiniDao-PE是一款JAVA持久化框架,类似mybatis的持久层解决方案,可以轻松集成Hibernate 工程,事务统一管理,解决了Hibernate 工程支持mybaits的功能问题。简单点理解,就是可以用 sql 模板方式操作数据库的工具。
关键代码解读
-
MiniDao 提供了几个注解类,下面我们来看下这些注解类的作用。
- @Arguments 作用在 Dao 的方法上,用于传递方法的参数到 sql 模板。
- @Param 作用在 Dao 的方法的每个参数上,同样用于传递方法的参数到 sql 模板。
- @ResultType 作用在 Dao 的方法上,方法返回值如果是List,指定List里的具体类型,用于转换查询结果,默认是Map类型。
- @Sql 作用在 Dao 的方法上,用于指定方法对应的 sql 模板,如果配置,会忽略方法对应的sql文件模板
- MiniDao 作用在 Dao 接口上,用于标识需要扫描的接口,已推荐使用@Repository
-
核心逻辑处理类:MiniDaoHandler
MiniDaoHandler 是JDK的动态代理类,代理了每个 Dao 方法的调用。而在其中就主要完成了从sql模板生成可执行sql,然后调用Spring JDBC的方法执行sql,获得结果集后封装成需要返回的类型的过程。下图是该部分代码的截图:
EmptyInterceptor类
该类的作用是在构造sql模板时,对 insert 或 update 语句做一些特殊处理,如设置“操作人”、“操作日期”等公共字段,但它只会对方法名称是 insert 或 update 开头的方法做处理。-
自动扫描注册Bean的实现
主要由两个类来实现:- MiniDaoBeanScannerConfigurer: 配置了具体做扫描配置文件的类是哪个;
- MiniDaoClassPathMapperScanner: 根据配置参数,扫描指定包路径下的类,符合要求的(有@MiniDao注解的接口)加入Bean定义,并指定代理类(MiniDaoHandler)和bean对应的接口(有@MiniDao注解的接口)。
其他
除了以上主要逻辑的类,还有一些工具类,用来对不同的数据库封装处理,比如分页查询的处理,分页查询也提供了 MiniDaoPage 类来封装请求与返回参数。
总结
MiniDao 这个框架的代码不是很多,它是站在 Spring 这个巨人的肩膀上,用到了 Spring 的 bean 扫描机制和 JDBC 的封装操作。由于是基于 Spring,自然也可以使用 Spring 的事务管理,也可以与 Spring 的其他组件方便地集成。MiniDao 本身有一些使用上的约定,比如前面提到 EmptyInterceptor 只对 insert 或 update 开头的方法做处理,等等。如果要灵活地使用好这个框架,还是要多踩坑后,熟悉里面的逻辑。笔者自己也曾经手写过一些数据库操作框架,但也只限于应付手头上的项目,有很大的局限性,还不能像 MiniDao 这样做得比较能用灵活。虽然 MyBatis 框架是 java 操作数据库的主流技术,但如果有一点点时间熟悉一些类似 MiniDao 这样的轻量级框架,对技术的提升和日常项目的快速开发也是有好处的。