beetl模板使用场景_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 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 all(); List template(T entity); T templateOne(T entity); List execute(String sql,Object... args); int executeUpdate(String sql,Object... args ); Query createQuery(); LambdaQuery createLambdaQuery();

Query 链式操作 Query query = sqlManager.query(User.class); long count = query.andEq("name", "new name") .orEq("id", 1637).limit(1, 10).count();

Java8 LambdaQuery 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 { PageQuery queryByCondtion(PageQuery query); void batchDelUserByIds( List ids); void batchUpdateUserState(List ids, GeneralStateEnum state); List 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周精通