开源地址：

• github: https://github.com/sagframe/sagacity-sqltoy
• gitee: https://gitee.com/sagacity/sagacity-sqltoy
• idea 插件(可直接在idea中检索安装):  https://github.com/threefish/sqltoy-idea-plugins

更新内容

1、修复updateSaveFetch锁查询、修改(不存在则插入)、并返回修改后结果功能在复合主键场景下的bug
2、修复sqlite数据库identity主键策略insert的缺陷
3、优化saveOrUpdate，增加当主键值为null时直接走save操作

• updateSaveFetch特点：

/**
 * @TODO 适用于库存台账、客户资金账等高并发强事务场景，一次数据库交互实现：
 *       <p>
 *       <li>1、锁查询；</li>
 *       <li>2、记录存在则修改；</li>
 *       <li>3、记录不存在则执行insert；</li>
 *       <li>4、返回修改或插入的记录信息</li>
 *       </p>
 * @param <T>
 * @param entity           尽量不要使用identity、sequence主键
 * @param updateRowHandler
 * @param uniqueProps      唯一性字段，用于做唯一性检索，不设置则按照主键进行查询
 * @return
 */
public <T extends Serializable> T updateSaveFetch(final T entity, final UpdateRowHandler 
         updateRowHandler,final String... uniqueProps);

//使用方法范例
public TransLedgerVO updateSaveTrans(TransLedgerVO transVO) {
      return sqlToyLazyDao.updateSaveFetch(transVO, new UpdateRowHandler() {
          @Override
         public void updateRow(ResultSet rs, int index) throws Exception {
            // 一般updateFetch会依托表中的现有值做一些逻辑处理,否则可以直接update
            rs.updateInt("QUANTITY", rs.getInt("QUANTITY") + transVO.getQuantity());
            rs.updateBigDecimal("AMT", rs.getBigDecimal("AMT").add(transVO.getAmt()));
         }
     }, "orderId");
}

• sqltoy的关键优势：

//------------------了解 sqltoy的关键优势: -------------------------------------------------------------------------------------------*/
//1、最简最直观的sql编写方式(不仅仅是查询语句)，采用条件参数前置处理规整法，让sql语句部分跟客户端保持高度一致
//2、sql中支持注释(规避了对hint特性的影响,知道hint吗?搜oracle hint)，和动态更新加载，便于开发和后期维护整个过程的管理
//3、支持缓存翻译和反向缓存条件检索(通过缓存将名称匹配成精确的key)，实现sql简化和性能大幅提升
//4、支持快速分页和分页优化功能，实现分页最高级别的优化，同时还考虑到了cte多个with as情况下的优化支持
//5、支持并行查询
//6、根本杜绝sql注入问题
//7、支持行列转换、分组汇总求平均、同比环比计算，在于用算法解决复杂sql，同时也解决了sql跨数据库问题
//8、支持保留字自动适配
//9、支持跨数据库函数自适配,从而非常有利于一套代码适应多种数据库便于产品化,比如oracle的nvl，当sql在mysql环境执行时自动替换为ifnull
//10、支持分库分表
//11、提供了取top、取random记录、树形表结构构造和递归查询支持、updateFetch单次交互完成修改和查询等实用的功能
//12、sqltoy的update、save、saveAll、load 等crud操作规避了jpa的缺陷,参见update(entity,String...forceUpdateProps)和updateFetch
//13、提供了极为人性化的条件处理：排它性条件、日期条件加减和提取月末月初处理等
//14、提供了查询结果日期、数字格式化、安全脱敏处理，让复杂的事情变得简单，大幅简化sql或结果的二次处理工作
//-----------------------------------------------------------------------------------*/

sqltoy特点介绍：

• JPA式的crud是基本共识，但sqltoy改进了update，增加了updateFetch

• sqltoy的update、updateAll，弹性设置强制修改属性，一次性数据库交互，解决并发问题

/**
 * @todo 修改数据并返回数据库记录变更数量(非强制修改属性，当属性值为null不参与修改)
 * @param entity
 * @param forceUpdateProps 强制修改的字段属性
 * @return Long 数据库记录变更量(插入数据量)
 */
public Long update(Serializable entity, String... forceUpdateProps);
	
/**
 * @TODO 批量修改操作，并可以指定强制修改的属性(非强制修改属性，当属性值为null不参与修改)
 * @param <T>
 * @param entities
 * @param forceUpdateProps
 * @return Long 数据库记录变更量(插入数据量)
 */
public <T extends Serializable> Long updateAll(List<T> entities, String... forceUpdateProps);
	
//保存或修改数据并返回数据库记录变更数量
public Long saveOrUpdate(Serializable entity, String... forceUpdateProps);

• updateFetch: 一次交互完成锁查询、修改，并返回修改后的结果，尤其适用于库存台账、资金台账场景

// sqltoy的updateFetch是jpa没有的，可以深入了解其原理，一次交互完成查询、锁定、修改并返回修改后结果
/**
 * @todo 获取并锁定数据并进行修改(只支持针对单表查询，查询语句要简单)
 * @param queryExecutor
 * @param updateRowHandler
 * @return
 */
public List updateFetch(final QueryExecutor queryExecutor, final UpdateRowHandler updateRowHandler);

• sqltoy最佳sql编写模式，便于开发和后期维护

• sqltoy的缓存翻译，大幅减少表关联简化sql，让你的查询性能成几何级提升

• 极致的分页，同样帮助你实现查询的性能大幅提升

1. 快速分页:@fast() 实现先取单页数据然后再关联查询，极大提升速度
2. 分页优化器:page-optimize 让分页查询由两次变成1.3~1.5次(用缓存实现相同查询条件的总记录数量在一定周期内无需重复查询
3. sqltoy的分页取总记录的过程不是简单的select count(1) from (原始sql)；而是智能判断是否变成:select count(1) from 'from后语句'， 并自动剔除最外层的order by
4. sqltoy支持并行查询：parallel="true"，同时查询总记录数和单页数据,大幅提升性能

• 便利的跨数据库统计计算：数据旋转

• 便利的跨数据库统计计算：无限极分组统计(含汇总求平均)

• 便利的跨数据库统计计算：同比环比