不好意思，我吹牛了，有点标题党。
本次的升级并没有什么新鲜的东西，就是给StringBuilder套了个壳子，本质上还是字符串的拼接，目的是为了减少大量的if，让判断+拼接的过程缩短在一行上，以及在拼接时不再需要注意空格了。
可是，不管怎么样，反正比以前更方便了就是了，大家如果有兴趣的话可以了解一下。
假如我们有一个实体对象，需要把它作为查询条件，那么我们一般的做法是这样的。
// 作为查询条件的实体对象
ParamPO paramPO = new ParamPO();
paramPO.setAge(10);
paramPO.setHeight(1);
// sql主体，JDK17+的写法
String sql = """
select
id,name,age,create_time
from
user_info
where 1=1
""";
// 拼接条件
StringBuilder stringBuilder = new StringBuilder(sql);
if(paramPO.getAge() > 0){
stringBuilder.append(" and age > {age}"); // 需要注意空格，不然一不小心就沾一起了
}
if(paramPO.getName() != null){
stringBuilder.append(" and name = {name}"); // 需要注意空格，不然一不小心就沾一起了
}
if(paramPO.getHeight() != null){
stringBuilder.append(" and height > {height}"); // 需要注意空格，不然一不小心就沾一起了
}
// 查询数据
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).selectList(stringBuilder.toString(), paramPO, ParamPO.class);
这里面最被人诟病的就在于拼接条件的这一段，因为会出现大量的if，本来一行就可以解决的，现在变成了三行
所以，我们此次的升级就是为了让这一段更优雅一点。
以实体对象作为参数的示例
ParamPO paramPO = new ParamPO();
paramPO.setAge(10);
paramPO.setHeight(1);
// sql主体，JDK17+的写法
String sql = """
select
id,name,age,create_time
from
user_info
where 1=1
""";
// 条件拼接
SqlBuilder sqlBuilder = SqlBuilder.builder()
.init(sql) // 这里传入sql主体
.append("and age > {age}", paramPO.getAge() > 0) // 第一个参数传入要拼接的where条件，第二个参数传入是否要拼接的判断条件，也就是说第二个参数的等式成立才会将第一个参数拼接到sql上去，下面都是一样的
.append("and name = {name}", paramPO.getName() != null)
.append("and height > {height}", paramPO.getHeight() != null);
// 直接toString 可以获取到拼接后的完整sql
String sql = sqlBuilder.toString();
// 查询数据
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).selectList(sql, paramPO, ParamPO.class);
以数组作为参数的示例
// 作为参数的数组
List<Object> params = new ArrayList<>();
// sql主体，JDK17+的写法
String sql = """
select
id,name,age,create_time
from
user_info
where 1=1
""";
// 条件拼接
SqlBuilder sqlBuilder = SqlBuilder.builder()
.init(sql) // 这里传入sql主体
// 这里为了偷懒，还是用到了paramPO对象，反正大家懂那个意思就行了
// 第一个参数传入要拼接的where条件，第二个参数传入是否要拼接的判断条件
// 也就是说第二个参数的等式成立才会将第一个参数拼接到sql上去，下面都是一样的
// 第三个参数是一个回调函数，用来往params里添加数据的
.append("and age > ?", paramPO.getAge() > 0, ()->{params.add(paramPO.getAge());})
.append("and name = ?", paramPO.getName() != null, ()->{params.add(paramPO.getName());})
.append("and height > ?", paramPO.getHeight() != null, ()->{params.add(paramPO.getHeight());});
// 直接toString 可以获取到拼接后的完整sql
String sql = sqlBuilder.toString();
// 查询数据，注意看第二个参数，需要将List转成数组
List<ParamPO> result = MagicDBUtils.get(jdbcTemplate).selectList(sql, params.toArray(), ParamPO.class);
简单说明
我们肯定都知道这个吧
@Resource
private JdbcTemplate jdbcTemplate;
本工具包只是对它做了一个很轻微的扩展，大家不必把它当成是一个持久层框架，而且它事实上也不是一个框架，就是个小型的工具包而已，里面提供的功能也不仅仅是操作数据库。
大家如果有兴趣可以访问官网了解详情：https://magician-io.com
