BeetlSQL数据库访问框架是一个全功能 DAO 工具，同时具有 Hibernate.rar

<p align="center"> <img alt="logo" src="https://gitee.com/xiandafu/beetlsql/raw/master/doc/bee-logo.png" width="120" height="120"> </p> <p align="center"> <a href="http://ibeetl.com/">http://ibeetl.com</a> </p> <p align="center"> <a href="https://mvnrepository.com/search?q=g:com.ibeetl%20AND%20beetlsql"><img src="https://img.shields.io/maven-central/v/com.ibeetl/beetlsql.svg"></a> <a href="https://www.oracle.com/java/technologies/downloads/"><img src="https://img.shields.io/badge/JDK-8+-red.svg"></a> <a href="https://gitee.com/xiandafu/beetlsql/blob/master/LICENSE"><img src="https://img.shields.io/:license-BSD%203-green.svg?style=flat-square"></a> </p> ## 简介 BeetlSQL的目标是提供**开发高效**，**维护高效**，**运行高效**的数据库访问框架，在一个系统多个库的情况下，提供一致的编写代码方式。支持如下数据平台 * 传统数据库：MySQL(国内兼容MySQL协议的各种大数据库),MariaDB,Oracle,Postgres,DB2,SQL Server，H2,SQLite,Derby，神通，达梦，华为高斯，人大金仓，PolarDB等 * 大数据：HBase，ClickHouse，Cassandar，Hive * 物联网时序数据库：Machbase，TD-Engine，IotDB * SQL查询引擎:Drill,Presto，Druid * 内存数据库:ignite，CouchBase BeetlSQL 不仅仅是简单的类似MyBatis或者是Hibernate，或者是俩着的综合，BeetlSQL远大理想是对标甚至超越Spring Data，是实现数据访问统一的框架，无论是传统数据库，还是大数据，还是查询引擎或者时序库，内存数据库。 > 直接在线试用BeetlSQL http://121.42.237.11:8080/beetlsql_online/ * 作者: 闲大赋,Gavin.King,Sue,Zhoupan，woate,darren,蚊子 * 开发时间:2015-07 * 网站 http://ibeetl.com * qq群 219324263(满) 252010126 ## 文档 BeetlSQL 3.x 使用说明，当前版本](https://www.kancloud.cn/xiandafu/beetlsql3_guide) 社区提供的文档 https://beetlsql-doc.vercel.app ```xml <dependency> <groupId>com.ibeetl</groupId> <artifactId>beetlsql</artifactId> <version>3.${version}</version> </dependency> ``` [BeetlSQL 2.x 使用说明，旧版本](README2.md) ```xml <dependency> <groupId>com.ibeetl</groupId> <artifactId>beetlsql</artifactId> <version>2.13.3.RELEASE</version> </dependency> ``` ## 适合用户 * 你不想把精力浪费在简单据库增删改查上？BeetlSQL 内置数据库的CRUD功能 * 你是属于以SQL为中心的程序员派别。BeetlSQL提供了较好的SQL管理，以及内置大量SQL * 你是对代码可维护性有高要求的架构师？BeetlSQL的设计目的就是尽可能提高数据库访问代码可维护性 * 平台级产品需要跨库，支持各种客户数据库的？BeetlSQL 支持各种库，程序员编写一次，能运行到各种数据库 * 系统需要连接多种库，比如连接商品库，连接订单库，或者设备基本信息在MySQL，设备数据在Clickhouse里。BeetlSQL很容易支持各种库，并能一统一的方式使用 * 系统初期单库单表，长期需要多库多表？BeetlSQL很容易实现多库多表而不需要程序员过多关注。 ## 编译源码 ```bash git clone https://gitee.com/xiandafu/beetlsql mvn clean package # 如果想修改源码 mvn clean install ``` 注意：BeetlSQL3 集成了Spring，以及支持大数据等，就算配置了国内镜像，也可能需要很长时间下载大数据依赖包，为了让编译快速通过，你需要进入pom.xml ，屏蔽sql-integration,sql-db-support,sql-jmh三个模块 ```xml <modules> <!--核心功能 --> <module>sql-core</module> <module>sql-mapper</module> <module>sql-util</module> <module>sql-fetch</module> <!-- 打包到一起 --> <module>beetlsql</module> <module>sql-gen</module> <module>sql-test</module> <module>sql-samples</module> <!-- 集成和扩展太多的数据库,可以被屏蔽，以加速项目下载jar --> <!-- <module>sql-integration</module>--> <!-- <module>sql-jmh</module>--> <!-- <module>sql-db-support</module>--> </modules> ``` ## 阅读源码例子 可以从模块`sql-samples`中找得到所有例子，或者从`sql-test` 中运行单元测试例子，或者在`sql-integration` 中的各个框架单元测试中找到相关例子。所有例子都是基于H2内存数据库，可以反复运行 以`sql-samples`为例子 sql-samples 又包含了三个模块大约100个例子 * quickstart: BeetlSQL基础使用例子，可以快速了解BeetlSQL3 * usuage: BeetlSQL所有API和功能 * plugin:BeetlSQL高级扩展实例 以usage模块为例子，包含如下代码 * S01MapperSelectSample 15个例子， mapper中的查询演示 * S02MapperUpdateSample 11个例子， mapper中更新操作 * S03MapperPageSample 3个例子，mapper中的翻页查询 * S04QuerySample 9个例子，Query查询 * S05QueryUpdateSample 3个例子，Query完成update操作 * S06SelectSample 14个例子，SQLManager 查询API * S07InsertSample 8个例子，SQLManager 插入新数据API,主键生成 * S08UpdateSample 6个例子,更新数据 * S09JsonMappingSample 5个例子， json配置映射 * S10FetchSample 2个例子，关系映射 * S11BeetlFunctionSample 2个例子，自定义sql脚本的方法 BeetlSQL提供了saga事物管理一种思路，但目前还是试验版本，欢迎不怕死的人尝试，和我一起完善这部分，其例子可以在saga模块的单元测试中找到 ## 代码示例 ### 例子1,内置方法，无需写SQL完成常用操作 ```java UserEntity user = sqlManager.unique(UserEntity.class,1); user.setName("ok123"); sqlManager.updateById(user); UserEntity newUser = new UserEntity(); newUser.setName("newUser"); newUser.setDepartmentId(1); sqlManager.insert(newUser); ``` 输出日志友好,可反向定位到调用的代码 ``` ┏━━━━━ Debug [user.selectUserAndDepartment] ━━━ ┣ SQL： select * from user where 1 = 1 and id=? ┣ 参数： [1] ┣ 位置： org.beetl.sql.test.QuickTest.main(QuickTest.java:47) ┣ 时间： 23ms ┣ 结果： [1] ┗━━━━━ Debug [user.selectUserAndDepartment] ━━━ ``` ### 例子2 使用SQL ```java String sql = "select * from user where id=?"; Integer id = 1; SQLReady sqlReady = new SQLReady(sql,new Object[id]); List<UserEntity> userEntities = sqlManager.execute(sqlReady,UserEntity.class); //Map 也可以作为输入输出参数 List<Map> listMap = sqlManager.execute(sqlReady,Map.class); ``` ### 例子3 使用模板SQL ```java String sql = "select * from user where department_id=#{id} and name=#{name}"; UserEntity paras = new UserEntity(); paras.setDepartmentId(1); paras.setName("lijz"); List<UserEntity> list = sqlManager.execute(sql,UserEntity.class,paras); String sql = "select * from user where id in ( #{join(ids)} )"; List list = Arrays.asList(1,2,3,4,5); Map paras = new HashMap(); paras.put("ids", list); List<UserEntity> users = sqlManager.execute(sql, UserEntity.class, paras); ``` ### 例子4 使用Query类 支持重构 ```java LambdaQuery<UserEntity> query = sqlManager.lambdaQuery(UserEntity.class); List<UserEntity> entities = query.andEq(UserEntity::getDepartmentId,1) .andIsNotNull(UserEntity::getName).select(); ``` ### 例子5 把数十行SQL放到sql文件里维护 ```java //访问user.md#select SqlId id = SqlId.of("user","select"); Map map = new HashMap(); map.put("name","n"); List<UserEntity> list = sqlManager.select(id,UserEntity.class,map); ```  ### 例子6 复杂映射支持 支持像mybatis那样复杂的映射 * 自动映射 ```java @Data @ResultProvider(AutoJsonMapper.class) public static class MyUserView { Integer id; String name; DepartmentEntity dept; } ``` * 配置映射，比MyBatis更容易理解，报错信息更详细 ```json { "id": "id", "name": "name", "dept": { "id": "dept_id", "name": "dept_name" }, "roles": { "id": "r_id", "name": "r_name" } } `