5分钟 BeetlSQL 快速入门

企业应用面临的问题

  • 高效编写数据库访问代码
    • 内置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#

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

跨数据平台

  • 内置操作都是跨数据库平台,依赖不同的XXDBStyle
  • 提供翻页内置操作,支持不同数据库
  • MarkDown 管理不同数据库平台的有差异的SQL
    • sql/user.md,
    • sql/oracle/user.md
    • sql/mysql/user.md

一句话总结其他Dao工具问题

每个Dao工具都有特定使用范围和历史背景,没有最好的工具,只有适合自己的工具

  • JPA: 缺少管理复杂SQL能力,OR/Mapping 太强大容易用错。
  • Spring Data: 主要目的是SQL和NOSQL统一api,应用场景较为简单。其他缺点同JPA
  • MyBatis: 缺少内置功能,XML管理SQL不方便,出错调试难度大(没有自己的语法体系),OR/Mapping 功能弱
  • MyBatis-Plus: 国内基于Mybatis封装功能,具备内置功能和Lock,逻辑删除等方便的功能。缺点同BeetlSQL一样,都是国内个人维护。
  • JOOQ:应用场景较为简单,类似BeetlSQL Query功能,实际使用起来比较复杂
  • EBean:功能同JPA,比Hiberante弱,比JPA强。缺点同JPA
  • Spring-JDBCTemplate: 几乎没有提供企业应用需要的任何功能,还需要二次封装才能使用

总结BeetlSQL

  • 混合JPA,MyBatis,JOOQ功能
  • 创立Markdown管理复杂SQL

学习曲线

  • Hibernate 1个月入门,半年精通
  • JPA 一周入门,3个月年精通
  • MyBatis 一周入门,一个月精通
  • BeetlSQL 3天入门,2周精通

猜你喜欢

转载自my.oschina.net/xiandafu/blog/1791215