开源软件名称：

sql-builder

开源软件地址：

https://gitee.com/unknow0409/sql-builder

开源软件介绍：

不再为Java代码中难以维护的Sql语句而烦恼，SqlBuilder帮助您！

工具优势

整个工具大小仅36.6KB
读取外部sql.md文件并缓存
开放SqlRenderEngine接口让您可以自己渲染原生语句
内部已集成只要引入jar包即可直接使用的模板引擎（Beetl、Freemarker）

1分钟快速配置

将 sqlbuilder-config-default.properties 拷入您的项目src文件夹下
并将其更名为 sqlbuilder-config.properties
sqlFolders 填入sql文件存放目录，多目录用逗号（,）分隔
sqlMode 选择运行模式，run模式为产品模式读取缓存速度快，没有实时性；debug为开发模式，实时监测sql文件变化改动sql无需重启
引入 sql-builder-v1.3.5.jar 包
Java 代码内调用

/** * 如果您需要使用模板引擎来渲染那么 * 在这里设置一个全局引擎 * 比如我使用beetl引擎   */SqlBuilder.setEngine(new SqlBeetlEngine());    // 获取sql语句，test为文件名称，findSqlOfBeetl为语句唯一id，重名则获取第一个  String sql0 = SqlBuilder.render("test.findSqlOfBeetl");  // 该传参构造在 v1.3.5 版本已不推荐使用String sql1 = SqlBuilder.render("test.findSqlOfBeetl", new SqlBuilderPara("name", "颖"), ...); // 推荐使用String sql2 = SqlBuilder.sql("test.findSqlOfBeetl")// 不指定engine则使用全局引擎// 指定模板渲染引擎，仅作用于该条语句，后设置会覆盖前设置// 使用 freemarker 引擎.engine(SqlFreemarkerEngine.class)// 使用 beetl 引擎.engine(SqlBeetlEngine.class)// 设置参数.para("name", "颖").para(..., ...)// 渲染语句.render();

测试用例

test.md 文件

findSqlOfFreemarker===-- 外部sql一样可以写注释select * from T_TEST AS i <#if order ??>ORDER BY i.date ${order} </#if>findSqlOfBeetl===-- 注释2select * from T_TEST AS i <%if (!isEmpty(name)) {%>where i.name = '${name}' <%}%>fromUserId===from user where id = ? findUserName===-- 语句引入函数-- 引入本文件直接写语句名称-- 引入它文件如普通调用 test.yourSqlName 即可select username sql('fromUserId')

Tester.java 测试类

// 设置 全局模板引擎SqlBuilder.setEngine(new SqlBeetlEngine());// BeetlString sql1 = SqlBuilder.render("test.findSqlOfBeetl", new SqlBuilderPara("name", "颖"));System.out.println("Beetl渲染：");System.out.println(sql1);// Freemarker// 设置 单独模板引擎String sql2 = SqlBuilder.render(new SqlFreemarkerEngine(), "test.findSqlOfFreemarker", new SqlBuilderPara("order", "DESC"));System.out.println("Freemarker渲染：");System.out.println(sql2);// 语句引入函数用例String sql3 = SqlBuilder.render("test.findUserName");System.out.println("sql('...') 函数渲染：");System.out.println(sql3);

输出结果

Beetl渲染：  select * from T_TEST AS i where i.name = '颖'  Freemarker渲染：  select * from T_TEST AS i ORDER BY i.date DESC  sql('...') 函数渲染：  select * from user where id = ?