其实，我更喜欢写 SQL

此文章充满了个人的主观色彩，如果引起了大家的不适，那我也没办法。

其实，我更喜欢写 SQL，如果在此基础上再稍微方便一些就更好了，所以，我理想中的持久层应该是这样的。

对于单表的增删改查

由于它不需要各种 join，所以我们关心的只不过是字段，参数和条件而已，所以必须要有一种方式让我们只需要关注这三点，不需要去写那些固定模式的 SQL，比如这样。

ParamPO paramPO = new ParamPO();
paramPO.setUserName("a");
paramPO.setUserEmail("test@qq.com");

int result = MagicDBUtils.get(jdbcTemplate).insert("表名", paramPO);

又或者这样

/ 构建查询条件
ConditionBuilder conditionBuilder = ConditionBuilder.createCondition()
            .add("id > ?", 10)
            .add("and (name = ? or age > ?)", "bee", 10)
            .add("order by create_time", Condition.NOT_WHERE);

// 执行查询
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).select("表名", conditionBuilder, ParamPO.class);

注意看上面的代码示例，他跟现有的框架有什么区别？答案就在这行

.add("and (name = ? or age > ?)", "bee", 10)

现有的框架如果要实现这样的条件是一件很头疼的事，而我们可以直接把查询条件写出来，不需要去 set 一堆对象。

其他框架只能很方便的实现这种（也许是我孤陋寡闻，如果说错了欢迎大家来拍砖）

.add("id > ?", 10)

这就是其他框架的写法，不仅没有我们灵活，而且还不够直观，需要能一眼看懂方法名是什么意思。大家可以把这段代码跟上面的那段比一比，哪段更直观简直不言而喻。

ImsCardGoodsExample.Criteria criteria = cardGoodsExample.createCriteria()
                .andIccidEqualTo(iccid) // 需要看懂英文equal
                .andEndTimeLessThanOrEqualTo(new Date()); // 至于这句是什么意思？到底是>=还是<=，别装了，英文很好的程序员占比真不大

对于其他操作

由于需要各种统计，函数，join，这个时候无论代码设计的多么出色都不可能有 SQL 灵活好用，而且我们几乎都会在 navicat 等各种客户端里写一遍 SQL，验证成功了才会把他应用到程序里去。所以在这个场景下我个人认为没有什么方式比把 SQL 直接拷贝到程序里更方便的方式了，所以他必须能很友好的支持原生 SQL。

比如查询

ParamPO paramPO = new ParamPO();
paramPO.setId(5);
paramPO.setUserName("a");

// 采用{}占位符的写法
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).selectList("select * from xt_message_board where id > {id} and user_name != {user_name}", paramPO, ParamPO.class);

// 采用 ? 占位符的写法
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).selectList("select * from xt_message_board where id > ? and user_name != ?", new Object[]{5, "a"}, ParamPO.class);

又或者增删改

ParamPO paramPO = new ParamPO();
paramPO.setUserName("testTx222");
paramPO.setUserEmail("testTx222@qq.com");
paramPO.setId(4);

// 采用{}占位符的写法
int result = MagicDBUtils.get(jdbcTemplate).exec("update xt_message_board set user_name = {user_name} , user_email = {user_email} where id = {id}", paramPO);

// 采用 ? 占位符的写法
int result = MagicDBUtils.get(jdbcTemplate).exec("update xt_message_board set user_name = ? , user_email = ? where id = ?", new Object[]{"testTx222","testTx222@qq.com", 4});

分个页而已，有没有必要引入三方插件啊？

简简单单一句话搞定，当然了，只支持 mysql 哈，为什么不支持别的？因为我懒（其实是大部分公司都不舍得买 oracle，db2 等数据库，所以我觉得这个懒可以偷）

// 查询条件
ParamPO paramPO = new ParamPO();
paramPO.setId(5);
paramPO.setUserName("a");

// 查询参数
PageParamModel pageParamModel = new PageParamModel();
pageParamModel.setCurrentPage(1);
pageParamModel.setPageSize(10);
pageParamModel.setParam(paramPO);// 把查询条件set进去

// 使用默认countSql查询
PageModel<ParamPO> pageModel =  MagicDBUtils.get(jdbcTemplate).selectPage("select * from xt_message_board where id > {id} and user_name != {user_name}", pageParamModel, ParamPO.class);

// 使用自定义countSql查询
String countSql = "自己定义countSql";

PageModel<ParamPO> pageModel =  MagicDBUtils.get(jdbcTemplate).selectPageCustomCountSql("select * from xt_message_board where id > {id} and user_name != {user_name}", countSql, pageParamModel, ParamPO.class);

SQL 写在代码里很难看？

现在已经 2024 年的年底了，90 年出生的程序员都已经达到 35 岁退休的年龄了，所以不要再守着 JDK8 过日子了，试一试 JDK17

String sql = """
             select 
                 id,name,age,create_time
             from 
                 user_info
             where 
                 name = {name} and age > {age}
            """;

最重要的是

它只不过是对 Spring 的 JdbcTemplate 做了一个小小的扩展，也就是这玩意儿

@Resource
private JdbcTemplate jdbcTemplate;

所以稳定性，各方面都不用担心，而且使用起来超级方便，也就是说你只需要在 https://start.springboot.io 网站建立一个 springboot 项目，然后再添加一个依赖就好了，不需要去查阅 mybaits 怎么整合，分页插件怎么整合等一堆事。

所以你们打算尝试一下吗？

项目官网：https://magician-io.com