/**
 * Если вам нужно использовать шаблонизатор для рендеринга,
 * здесь вы можете установить глобальный механизм.
 * Например, я использую механизм beetl.
 */
SqlBuilder.setEngine(new SqlBeetlEngine());

// Получаем SQL-запрос, test — это имя файла, findSqlOfBeetl — уникальный идентификатор запроса, при повторении будет возвращён первый.
String sql0 = SqlBuilder.render("test.findSqlOfBeetl");

// Этот способ передачи параметров в конструкторе был объявлен устаревшим в версии v1.3.5
String sql1 = SqlBuilder.render("test.findSqlOfBeetl", new SqlBuilderPara("name", "颖"), ...);

// Рекомендуется использовать
String sql2 = SqlBuilder.sql("test.findSqlOfBeetl")
// Если не указан механизм, используется глобальный.
// Указание механизма рендеринга шаблона применяется только к этому запросу, последующие настройки будут перекрывать предыдущие.
// Использование механизма freemarker
.engine(SqlFreemarkerEngine.class)
// Использование механизма beetl
.engine(SqlBeetlEngine.class)
// Установка параметров
.para("name", "颖")
.para(..., ...)
// Рендеринг запроса
.render();

findSqlOfFreemarker
===
-- Внешние SQL-запросы также могут содержать комментарии
select * from T_TEST AS i <#if order ??>ORDER BY i.date ${order} </#if>

findSqlOfBeetl
===
-- Комментарий 2
select * from T_TEST AS i <%if (!isEmpty(name)) {%>where i.name = '${name}' <%}%>

fromUserId
===
from user where id = ?

findUserName
===
-- Запрос с использованием функции
-- Включение этого файла аналогично обычному вызову test.yourSqlName
select username sql('fromUserId')

// Устанавливаем глобальный шаблонизатор
SqlBuilder.setEngine(new SqlBeetlEngine());

// Beetl
String 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 = ?