企业应用面临的问题

高效编写数据库访问代码
- 内置CRUD，不需要写SQL
- 支持OR/Mapping
- 悲观锁，乐观锁，逻辑删除等辅助支持等
即支持简单的CRUD，也支持数十行，上百行SQL编写
跨数据库平台支持，Oracle,Postgres,Mysql,以及SQLServer，DB2，H2，SQLLite，包括翻页，排序，还有各个厂商特殊语法
易于维护
- 重构支持
- 易于修改
- DBA友好
丰富的调试手段，详细日志输出
Interceptor支持：具备SQL执行监控，SQL重写
支持POJO或者Map，或者混合模型

BeetlSQL 使用方式

内置API调用完成
Query链式查询
MarkDown 维护复杂SQL
支持POJO，也支持Map或者混合模型
主从支持和Sharding-JDBC分表分库集成

内置API

void insert(T entity);
void insertBatch(List<T> list);
int updateById(T entity);
int updateTemplateById(T entity);
int deleteById(Object key);
T unique(Object key);
T single(Object key);
T lock(Object key);
List<T> all();
List<T> template(T entity);
<T> T templateOne(T entity);
List<T> execute(String sql,Object... args);
int executeUpdate(String sql,Object... args );
Query<T> createQuery();
LambdaQuery<T> createLambdaQuery();

Query 链式操作

 Query<User> query = sqlManager.query(User.class);
        long count = query.andEq("name", "new name")
                .orEq("id", 1637).limit(1, 10).count();

Java8

LambdaQuery<User> query = sqlManager.lambdaQuery(User.class);
        User user = query.andEq(User::getId, 1641).single();
        user = query.andEq(User::getId, 1642).single();

处理复杂SQL

select 
@pageTag(){
u.*,o.name org_name
@}
from core_user u left join core_org o on u.org_id=o.id where 1=1 and u.del_flag = 0 
@//数据权限，该sql语句功能点  
and #function("user.query")#
@if(!isEmpty(orgId)){
    and  u.org_id =#orgId#
@}
 @if(!isEmpty(orgId)){
    and  u.org_id =#orgId#
@}
@if(!isEmpty(code)){
    and  u.code like #"%"+code+"%"#
@}
@if(!isEmpty(name)){
    and  u.name like #"%"+name+"%"#
@}
@if(!isEmpty(state)){
    and  u.state = #state#
@}

超简单的Dao实现

@SqlResource("console.user")
public interface UserConsoleDao extends BaseMapper<CoreUser> {

    PageQuery<CoreUser> queryByCondtion(PageQuery<CoreUser> query);

    void batchDelUserByIds( List<Long> ids);

    void batchUpdateUserState(List<Long> ids, GeneralStateEnum state);
    
    List<CoreUserRole> queryUserRole( Long id,Long orgId,Long roleId);

}

console.user 指明了SQL文件的位置，方法名对应了SQL片段名称。
继承BaseMapper可以获得内置的CRUD等若干现成方法

调试

内置DebugInterceptor，也支持扩展，用于安全监控，性能监控，改写SQL

┏━━━━━ Debug [user.selectUserAndDepartment] ━━━
┣ SQL：     select * from user where 1 = 1
┣ 参数：     []
┣ 位置：     org.beetl.sql.test.QuickTest.main(QuickTest.java:47)
┣ 时间：     23ms
┣ 结果：     [3]
┗━━━━━ Debug [user.selectUserAndDepartment] ━━━

完美定位到业务场景发生代码，消费时间，输入输出。

简单支持复杂关系映射查询

selectUserAndDepartment
===
    select * from user where user_id=#userId#
    @ orm.single({"departmentId":"id"},"Department");
    @ orm.many({"id":"userId"},"user.selectRole","Role");

user.selectRole
===

    select r.* from user_role ur left join role r on ur.role_id=r.id

    where ur.user_id=#userId#

一个用户关联一个部门，关联多个角色