# vonce-sqlbean **Repository Path**: tony7777777/vonce-sqlbean ## Basic Information - **Project Name**: vonce-sqlbean - **Description**: Sqlbean是一款使用Java面向对象思想来编写并生成Sql语句的工具，在此基础上对Mybatis和Spring Jdbc实现了类似于JPA的轻量级插件支持，无需编写DAO层，助你快速进行项目开发。 - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: https://gitee.com/iJovi/vonce-sqlbean - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 22 - **Created**: 2021-09-02 - **Last Updated**: 2021-09-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## Sqlbean #### 介绍 ###### Sqlbean是一款使用Java面向对象思想来编写并生成Sql语句的工具，在此基础上对Mybatis和Spring Jdbc实现了类似于JPA的轻量级插件支持。其中内置大量常用SQL执行的方法，可以非常方便的达到你想要的目的，相对复杂的SQL语句也得以支持，在常规的项目开发几乎做到不写DAO层，可以有效的提高项目开发的效率，让开发者更专注于业务代码的编写。 ###### 🚀特点: 零入侵, 多数据源, 动态Schema, 读写分离, 自动建表, 连表查询, 乐观锁, 分页, 支持Mybatis和Spring Jdbc ###### 💻环境: JDK7+, Mybatis3.2.4+, (Spring MVC 4.1.2+, Spring Boot 1.x, Spring Boot 2.x) ###### 💿数据库: Mysql, MariaDB, Oracle, Sqlserver2008+, PostgreSQL, DB2, Derby, Sqlite, HSQL, H2 ###### Sqlbean For Android请移步这里👉 [gitee](https://gitee.com/iJovi/vonce-sqlbean-android "vonce-sqlbean-android"), [github](https://github.com/Jovilam77/vonce-sqlbean-android "vonce-sqlbean-android") #### 简单上手 ###### 1.引入Maven依赖 cn.vonce vonce-sqlbean-spring 1.5.0 ###### 2.标注实体类 ```java @SqlTable("d_essay") //标识表名 public class Essay { @SqlId(type = IdType.SNOWFLAKE_ID_16) //标识id字段 //@SqlColumn("id") 常规情况下可不写 private Long id; //@SqlColumn("user_id" ) 常规情况下可不写 private String userId; //@SqlColumn("content" ) 常规情况下可不写 private String content; //@SqlColumn("creation_time" ) 常规情况下可不写 private Date creationTime; @SqlVersion //标识乐观锁字段 //@SqlColumn("update_time" ) 常规情况下可不写 private Date updateTime; /**省略get set方法*/ } ``` ###### 3.无需Dao层，Service层接口只需继承SqlBeanService<实体类, ID> ```java public interface EssayService extends SqlBeanService { //已内置大量常用查询、更新、删除、插入方法，这里可以写自己封装的方法 } ``` ###### 4.Service实现类只需继承MybatisSqlBeanServiceImpl<实体类, ID>和实现你的Service接口 ```java //使用Spring Jdbc的话将继承的父类改成SpringJdbcSqlBeanServiceImpl即可 @Service public class EssayServiceImpl extends MybatisSqlBeanServiceImpl implements EssayService { } ``` ###### 5.Controller层 ```java @RequestMapping("essay") @RestController public class EssayController { @Autowired private EssayService essayService; //查询 @GetMapping("select") public RS select() { //查询列表全部 List list = essayService.selectAll(); //查询列表根据条件查询方式一 list = essayService.selectByCondition("& > ?", SqlEssay.id, 20); //查询列表根据条件查询方式二推荐 list = essayService.selectByCondition(Wrapper.where(Cond.gt(SqlEssay.id, 10)).and(Cond.lt(SqlEssay.id, 20))); //查询单条根据id Essay essay = essayService.selectById(1L); //查询单条根据条件查询方式一 essay = essayService.selectOneByCondition("& = ?", SqlEssay.id, 1); //查询单条根据条件查询方式二推荐 essay = essayService.selectOneByCondition(Wrapper.where(Cond.eq(SqlEssay.id, 333))); //复杂查询 Select select = new Select(); //指定查询的字段 select.column(SqlEssay.id).column(SqlEssay.content); //指定查询的表可不写 //select.setTable(Essay.class); //看需求指定连表这里不演示 //select.join("",""); //id 大于 1 这里的id建议用SqlEssay.id 常量替代这里演示多种写法特意不写 select.where("id", 1, SqlOperator.GREATER_THAN); //并且内容等于222 这里的content建议用SqlEssay.content 常量替代这里演示多种写法特意不写 select.wAND("content", "222"); //条件也可用包装器复杂条件推荐使用 //select.setWhere(Wrapper.where(Cond.gt(SqlEssay.id, 1)).and(Cond.eq(SqlEssay.content, "222"))); //也可使用表达式如果这三种条件同时出现那么此方式优先级最高上面包装器次之 //select.setWhere("& = ? AND & = ?", SqlEssay.id, 1, SqlEssay.content, "222"); //根据id倒序 select.orderBy("id", SqlSort.DESC); //用于查询Map 多条结果时会报错 Map map = essayService.selectMap(select); //用于查询Map列表 List> mapList = essayService.selectMapList(select); //用于查询对象列表 list = essayService.select(select); return super.successHint("获取成功", list); //更多用法请查看下方详细文档... } //分页 @GetMapping("getList") public RS getList(HttpServletRequest request) { // 查询对象 Select select = new Select(); // 分页助手ReqPageHelper ReqPageHelper pageHelper = new ReqPageHelper<>(request); //分页查询 pageHelper.paging(select, essayService); //返回结果 return super.customHint(pageHelper.toResult("获取列表成功")); // 或者这样 // return super.customHint(new PageHelper(request).paging(new Select(),essayService).toResult("获取文章列表成功")); //又或者更简便的用法（不带统计和页数信息） //List list = essayService.selectByCondition(new Paging(0,10), Wrapper.where(Cond.gt(SqlEssay.id, 10)).and(Cond.lt(SqlEssay.id, 20))); //return super.successHint("获取成功", list); } //更新 @PostMapping("update") public RS update(Essay essay) { //根据bean内部id更新 long i = essayService.updateByBeanId(essay); //根据外部id更新参数3的true代表仅更新不为null字段参数4的true代表使用乐观锁 //i = essayService.updateById(essay,20,true,true); //根据条件更新参数2的true代表仅更新不为null字段参数3的true代表使用乐观锁 //i = essayService.updateByCondition(essay,true,true,Wrapper.where(Cond.gt(SqlEssay.id, 1)).and(Cond.eq(SqlEssay.content, "222"))); //更多用法请查看下方详细文档... if (i > 0) { return super.successHint("更新成功"); } return super.othersHint("更新失败"); } //删除 @PostMapping("deleteById") public RS deleteById(Integer[] id) { //根据id删除 long i = essayService.deleteById(id); //根据条件删除 //i = essayService.deleteByCondition(Wrapper.where(Cond.gt(SqlEssay.id, 1)).and(Cond.eq(SqlEssay.content, "222"))); //更多用法请查看下方详细文档... if (i > 0) { return super.successHint("删除成功"); } return super.othersHint("删除失败"); } //插入 @PostMapping("add") public RS add() { List essayList = new ArrayList<>(); for (int i = 0; i < 100; i++) { Essay essay = new Essay(i, "name" + i); essayList.add(essay); } essayService.insert(essayList); return successHint("成功"); } } // 更多用法请查看下方详细文档... ``` ##### 👇👇👇更多用法请查看下方文档👇👇👇 #### 文档说明 ###### [0️⃣. 注解详情与使用](doc/Annotation.md "注解详情与使用") ###### [1️⃣. Select](doc/Select.md "Select") ###### [2️⃣. Insert](doc/Insert.md "Insert") ###### [3️⃣. Delete](doc/Delete.md "Delete") ###### [4️⃣. Update](doc/Update.md "Update") ###### [5️⃣. 表操作相关](doc/Table.md "表操作相关") ###### [6️⃣. 分页查询](doc/Paging.md "分页查询") ###### [7️⃣. Service接口和实现类](doc/Interface.md "Service接口和实现类") ###### [8️⃣. SqlBean和SqlHelper](doc/SqlHelper.md "SqlBean和SqlHelper") ###### [9️⃣. Where条件和包装器](doc/Where.md "Where条件和包装器") ###### [🔟. 多数据源动态Schema读写分离相关配置](doc/DataSourceConfig.md "多数据源动态Schema读写分离相关配置")