<dependency>
   <groupId>com.github.drinkjava2</groupId>
   <artifactId>jsqlbox</artifactId>  
   <version>5.0.15.jre8</version> <!-- Или последняя версия -->
</dependency> 

DbContext db= new DbContext(dataSource);
db.exe("insert into users (", //
          " name ,", par("Sam"), //один параметр записывается в одну строку для удобства обслуживания
          notNull("address,", user.getAddress()), //проверка на пустые значения
      when(age>10, "age,", par(user.getAge())), //динамическое добавление фрагмента SQL на основе условия
          " address ", par("Canada"), //
          ") ", valuesQuestions()); //автоматическое добавление фрагментов values(?,?...?) в соответствии с количеством параметров

 QTbPriceSetting p=QTbPriceSetting.instance;
 DB.exe("insert into ",p," (", //
    p.id, ",", par(1200), //
    p.price, ",", par(80), //
    p.currency, ",", par("USD"), //
    p.created_at, par("2019-09-17 04:07:55"), //
    ")", valuesQuestions());

<dependency>
    <groupId>com.github.drinkjava2</groupId>
    <artifactId>jdialects</artifactId>
    <version>5.0.13.jre8</version> <!--или последняя версия-->
</dependency>

DB.exe(DB.gctx().toCreateDDL(HelloWorld.class)); //создание DDL на основе сущности для создания таблицы
String sql=DB.trans("select concat('a','b','c'), current_time() from user_tb where age>0"); //перевод функций SQL в зависимости от диалекта
DB.qryString(sql, " and price>100", pagin(1, 10));  //разбиение на страницы для любой базы данных путём передачи объекта pagin

public class User implements ActiveEntity{
 @UUID
 private String id;
 private String name;
 //геттеры и сеттеры ...
}

//ActiveRecord
new User().loadById("张三").setUserAge(13).update(); 

SqlTemplateEngine TEMPLATE = BasicSqlTemplate.instance()
ctx2.exe(TEMPLATE, "update users set name=#{user.name}, address=:user.address",

``` **Совместимость с основными JPA аннотациями, поддержка динамического изменения конфигурации в процессе выполнения**

Для удобства изучения jSqlBox совместим с основными аннотациями JPA для сущностных классов: @Entity, @Transient, @UniqueConstraint, @GenerationType, @Id, @Index, @SequenceGenerator, @GeneratedValue, @Table, @Column, @TableGenerator, @Version, @Enumerated, @Convert, @Temporal.

jSql также имеет несколько специальных аннотаций для сущностей, таких как CreatedBy, LastModifiedBy, ShardTable, ShardDatabase и Snowflake.

В jSqlBox можно динамически изменять конфигурацию связей сущностей во время выполнения. Например, можно настроить UUID32 первичный ключ для класса PojoDemo и изменить отображение поля name на поле address:

**Поддержка мультиарендности, репликации главный-подчиненный, разделения базы данных и таблиц**

jSqlBox поддерживает мультиарендность, репликацию главный-подчинённый и разделение базы данных и таблиц. Помимо использования аннотации Sharding для сущностей, jSqlBox также позволяет передавать методы разделения базы данных и таблиц непосредственно в SQL для точного контроля над разделением каждой строки SQL.

Пример разделения сущностей:

Мультиарендность может быть реализована на основе IP-адреса или другого поля сущности. Для этого необходимо настроить экземпляр TenantGetter:

**Встроенная декларативная транзакция, поддержка транзакций Spring**

jSqlBox имеет встроенный инструмент IOC/AOP и функцию декларативной транзакции. Если вы используете Spring, то можете легко настроить транзакцию, например:

**Встроенная функция распределённой транзакции**

Принцип работы распределённых транзакций в jSqlBox похож на Seata. Он может автоматически генерировать откатные SQL-запросы, но исходный код jSqlBox проще, чем у Seata, поскольку jSqlBox генерирует откатные SQL на основе сущностного CRUD, что устраняет необходимость учитывать проблемы совместимости SQL.

**Избегание повторной разработки, отказ от антипаттернов**

jSqlBox не изобретает велосипед и использует DbUtils в качестве ядра. DbUtils — зрелый, лаконичный и эффективный JDBC-инструмент.

jSqlBox старается избегать антипаттернов. Антипаттерн — это когда тратится много времени на действия, которые не имеют смысла. В jSqlBox, например, не поддерживается конфигурация ассоциаций один-ко-многим и многие-к-одному. Это связано с тем, что такие ассоциации могут привести к проблемам с производительностью, обучением и обслуживанием, которые могут перевесить преимущества их использования.

Также в jSqlBox нет методов, заменяющих ключевые слова SQL. Такие методы считаются антипаттерном, так как они могут усложнить чтение и поддержку кода, а также сделать его менее эффективным по сравнению с использованием SQL напрямую.

**Пример начала работы**

Следующий пример демонстрирует базовую настройку и использование jSqlBox:

Добавьте зависимость в файл pom.xml:

import javax.sql.DataSource;
import org.h2.jdbcx.JdbcConnectionPool;
import static com.github.drinkjava2.jsqlbox.DB.*;
import com.github.drinkjava2.jdialects.annotation.jdia.UUID25;
import com.github.drinkjava2.jdialects.annotation.jpa.Id;
import com.github.drinkjava2.jsqlbox.ActiveEntity;
import com.github.drinkjava2.jsqlbox.DB;
import com.github.drinkjava2.jsqlbox.DbContext;

public class HelloWorld implements ActiveEntity<HelloWorld> {
  @Id
  @UUID25
  private String id;
  private String name;
  public String getId() {return id;}