MiniDao1.8.3 版本发布，轻量级Java持久化框架

Posted 2021-10-20 JEECG官方博客

项目介绍

MiniDao 是一款轻量级JAVA持久层框架，基于 SpringJdbc + freemarker 实现，具备Mybatis一样的SQL分离和逻辑标签能力。Minidao产生的初衷是为了解决Hibernate项目，在复杂SQL具备Mybatis一样的灵活能力，同时支持事务同步。

当前版本：v1.8.3 | 2021-08-09

源码下载

• https://github.com/zhangdaiscott/MiniDao
• https://gitee.com/jeecg/minidao

升级日志

• 数据库分页方言重构支持含常规、国产、大数据等28种数据库

数据库	支持
mysql	√
Oracle、Oracle9i	√
SqlServer、SqlServer2012	√
PostgreSQL	√
DB2、Informix	√
MariaDB	√
SQLite、Hsqldb、Derby、H2	√
达梦、人大金仓、神通	√
华为高斯、虚谷、瀚高数据库	√
阿里云PolarDB、PPAS、HerdDB	√
Hive、HBase、CouchBase	√

• 数据库实现自动适配不再需要手工配置DB类型
• 解决上个版本重构后，不支持SqlServer分页问题
• debug模式下，解决报错: Minidao报错“Template java/lang/Object_toString.sql not found”
• ID支持主键策略自动生成 @TableId(type = IdType.UUID)
• @TableId 支持uuid(默认)\\AUTO(自增)\\ID_WORKER(雪花ID)\\ID_SEQ(序列seq,必须配置seqName)四种主键策略

技术文档

• 技术官网： http://www.jeecg.com
• 技术文档： https://minidao.mydoc.io
• 如何快速集成minidao

MiniDao特征

An powerful enhanced toolkit of SpringJdbc for simplify development

具有以下特征:

• O/R mapping不用设置xml，零配置便于维护
• 不需要了解JDBC的知识
• SQL语句和java代码的分离
• 只需接口定义，无需接口实现
• SQL支持脚本语言（强大脚本语言，freemarker语法）
• 支持与hibernate轻量级无缝集成
• 支持自动事务处理和手动事务处理
• 性能优于Mybatis
• 比Mybatis更简单易用
• SQL 支持注解方式
• SQL 支持独立文件方式，SQL文件的命名规则: 类名_方法名; SQL文件更容易定位，方便后期维护，项目越大此优势越明显
• SQL标签采用Freemarker的基本语法

代码体验

1. 接口定义[EmployeeDao.java]

@MiniDao
public interface EmployeeDao {

 @Arguments({ "employee"})
 @Sql("select * from employee")
 List<Map<String,Object>> getAll(Employee employee);

 @Sql("select * from employee where id = :id")
 Employee get(@Param("id") String id);

 @Sql("select * from employee where empno = :empno and  name = :name")
 Map getMap(@Param("empno")String empno,@Param("name")String name);

 @Sql("SELECT count(*) FROM employee")
 Integer getCount();

 int update(@Param("employee") Employee employee);

 void insert(@Param("employee") Employee employee);
 
 @ResultType(Employee.class)
 public MiniDaoPage<Employee> getAll(@Param("employee") Employee employee,@Param("page")  int page,@Param("rows") int rows);

}

2. SQL文件[EmployeeDao_getAllEmployees.sql]

SELECT * FROM employee where 1=1 
<#if employee.age ?exists>
and age = :employee.age
</#if>
<#if employee.name ?exists>
and name = :employee.name
</#if>
<#if employee.empno ?exists>
and empno = :employee.empno
</#if>

3. 接口和SQL文件对应目录

4. 测试代码

public class Client {
public static void main(String args[]) {
	BeanFactory factory = new ClassPathXmlApplicationContext("applicationContext.xml");
	EmployeeDao employeeDao = (EmployeeDao) factory.getBean("employeeDao");
	Employee employee = new Employee();
	String id = UUID.randomUUID().toString().replaceAll("-", "").toUpperCase();
	employee.setId(id);
	employee.setEmpno("A001");
	employee.setSalary(new BigDecimal(5000));
	employee.setBirthday(new Date());
	employee.setName("scott");
	employee.setAge(25);
	//调用minidao方法插入
	employeeDao.insert(employee);
}
}