3 Star 22 Fork 3

selfly / sonsure-dumper

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

Sonsure-Dumper

简单、快速、易用的jdbc持久化操作层。

** 最近更新:4.3.0 **

  • commons工具包合并
  • 增加flyable模块
  • Select增加类级别泛型支持
  • include、exclude更改为addColumn、dropColumn
  • 修复在h2下的自增主键报错问题
  • 测试模块集成spring boot管理依赖版本
  • 部分代码优化

示例

//根据主键获取
User user = jdbcDao.get(User.class, 177);

//查询所有列表
List<User> users = jdbcDao.find(User.class);

//查询分页列表
Page<User> page = jdbcDao.pageResult(user);

//会根据user对象中不为null的属性做为条件查询
long count = jdbcDao.findCount(user);

//会根据user对象中不为null的属性做为条件查询 没有数据时返回null,超过一条时会抛出异常
User user = jdbcDao.singleResult(user);

//超过一条时取第一条,有经过分页处理,全表查取第一条也不用担心返回数据过多
User user = jdbcDao.firstResult(user);

//会根据主键策略自动处理主键,如果实体对象中设置了主键值则不再处理
//返回的主键值类型根据生成的主键不同可自行转换
Long id = (Long)jdbcDao.executeInsert(user);

//根据主键更新实体对象
jdbcDao.executeUpdate(user);

//根据主键删除实体对象
jdbcDao.executeDelete(User.class, 1800081L);

//SQL: update User set user_age = user_age + 1 where user_info_id = 17
jdbcDao.update(User.class)
        .set("{{userAge}}", "userAge+1")
        .where("userInfoId", 17L)
        .execute();

//SQL: select user_age, count(*) num from user_info group by user_age order by num desc limit 0,10
Page<Object> page = jdbcDao.selectFrom(UserInfo.class).addColumn("userAge,count(*) Num")
        .groupBy(UserInfo::getUserAge()) //4.0版开始属性推荐使用lambda方式,防止拼错
        .orderBy("Num").desc()
        .paginate(1, 10)
        .isCount(false)
        .pageMapResult();

特点

  • 省去各类dao或baseDao,甚至不需要声明或注入dao
  • 学习成本低,api跟sql高度一致,会sql即会使用
  • 条件设置支持各类符号,=、!=、or、in、not in甚至是执行函数
  • 允许指定排序字段,可以指定多个组合升降自由排序
  • 支持显示指定或排除某个字段,以及添加额外的函数类字段,只取想要的数据
  • 内置分页功能,自动进行分页处理无需再写分页代码
  • 可以使用{{}}符号完成一些特殊的sql,例如user_age = user_age + 1这种不适合传参的情况
  • 支持native方式执行自定义sql
  • 支持整合Mybatis,以Mybatis的方式书写sql
  • 易扩展,各组件如主键生成器、分页器、命令构建器(sql/hql等)、持久化实现等均可扩展或重写

组件本质上也只是封装了一个通用dao,只不过更加方便易用。当发现组件缺少某项功能或不能满足需求时仍可以用本来原生的方式执行,完全无影响。

使用

添加依赖,默认使用Spring Jdbc实现,可更换成自己想要的实现:

<dependency>
    <groupId>com.sonsure</groupId>
    <artifactId>sonsure-dumper-springjdbc</artifactId>
    <version>${version}</version>
</dependency>

声明Bean,更多参数详见相关配置文档:

<bean id="jdbcDao" class="com.sonsure.dumper.springjdbc.persist.SpringJdbcDaoTemplateImpl">
    <property name="dataSource" ref="dataSource"/>
</bean>

传统注入方式使用JdbcDao:

//不管哪个实体对象都使用该JdbcDao就可以
@Autowired
private JdbcDao jdbcDao;

jdbcDao.get(User.class, 177);

相关文档

说明文档中可能会有xml方式配置或JavaConfig方式配置,两种方式效果是一样的,可根据情况自行转换。

参与贡献

github:https://github.com/selfly/sonsure-dumper
gitee: https://gitee.com/selfly/sonsure-dumper

  1. Fork 本项目
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request

空文件

简介

简单、快速、方便、易用的jdbc持久化操作层 展开 收起
Java
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/selfly/sonsure-dumper.git
git@gitee.com:selfly/sonsure-dumper.git
selfly
sonsure-dumper
sonsure-dumper
master

搜索帮助