jeecg miniDao 框架原理

简述

官方文档的介绍如下：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，获得结果集后封装成需要返回的类型的过程。下图是该部分代码的截图：

  
  
  

  MiniDaoHandler.png

• 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 这样的轻量级框架，对技术的提升和日常项目的快速开发也是有好处的。