项目介绍
MiniDao 是一款轻量级 JAVA 持久层框架，基于 SpringJdbc + freemarker 实现，具备 Mybatis 一样的 SQL 分离和逻辑标签能力。Minidao 产生的初衷是为了解决 Hibernate 项目，在复杂 SQL 具备 Mybatis 一样的灵活能力，同时支持事务同步。
当前版本：v1.9.0 | 2022-09-02
源码下载
- https://github.com/zhangdaiscott/MiniDao
- https://gitee.com/jeecg/minidao
升级日志
- 升级依赖版本号与 jeecgboot 版本号一致，重点升级 jsqlparser 重构了不兼容方法
- 升级 springframework 依赖到 5.3.18 ，与 jeecgboot 同步
- 升级 spring-boot-starter 依赖到 2.6.6 ，与 jeecgboot 同步
- 升级 javassist 依赖到 3.25.0-GA
- 升级 jsqlparser 依赖到 4.3
- 升级 ognl 版本号解决报错问题
- 不支持 SqlServer 分页问题
- 支持用户自定义数据源
- SqlServer2012 (derby 用到)、PostgreSql、神通、Hsql、mysql 分页优化，有分页关键词就用 select 包裹起来
- 反射打破方法没必要写，去掉 fields [j].setAccessible (true)
- SQL Server 表名关键字查询失败
技术文档
- 技术官网： 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 andname = :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);
}
}