dexcoder-dal 2.3.0发布，最方便易用的通用dal层

2016-1-18 22:29| 发布者: joejoe0332| 查看: 1627| 评论: 0|原作者: oschina|来自: oschina

摘要: 该通用dal是在开发过程中，对于简单封装的通用dao或数据访问层使用深感痛苦与不便，由此进行了整合和改进发展而来。如果你不喜欢用Hibernate、Mybaits这类ORM框架，喜欢Spring JdbcTemplate或DbUtils，那么可以试试 ...

该通用dal是在开发过程中，对于简单封装的通用dao或数据访问层使用深感痛苦与不便，由此进行了整合和改进发展而来。

如果你不喜欢用Hibernate、Mybaits这类ORM框架，喜欢Spring JdbcTemplate或DbUtils，那么可以试试这个封装的通用dal，这可能是目前封装的最方便易用的通用dal层了。

dexcoder-dal 2.3.0 更新说明：

实体类表名及属性名映射增加注解支持
增加更多的执行自定义sql方法
因为sql权限问题去掉使用TRUNCATE的deleteAll方法
修正使用注解时注解的属性名不遵循规范时get方法主键错误问题
修正水平拆分数据分表不根据主键拆分时update无法获取表名的问题
修改NameHandler类名为MappingHandler

配置动态数据源请看这里：在dexcoder-dal中使用动态数据源并设置读写分离

数据水平分表请看这里：在dexcoder-dal中实现分表数据水平拆分

dexcoder-dal的一些特性：

一个dao即可以搞定所有的实体类，不必再一个个建立跟实体对应的继承于类似BaseDao这类“通用dao”了。
各类方法参数除了Entity外，支持更强大的Criteria方式。
sql的where条件支持一些复杂的条件，如=、!=、or、in、not in甚至是执行函数。
允许在查询时指定使用哪个字段进行排序，可以指定多个进行组合升降序自由排序。
支持在查询时指定返回字段的白名单和黑名单，可以指定只返回某些字段或不返回某些字段。
select查询时支持函数，count()、max()、to_char()、甚至是distinct,理论上都可以支持。
方便强大的分页功能，无须额外操作，二三行代码搞定分页，自动判断数据库，无须指定。
可以使用{}和[]完成一些特殊的操作，{}中的代码将原生执行，[]中的代码会进行命名转换，一般fieldName转columnName。
支持执行自定义sql。
支持使用类似mybatis的方式执行自定义sql。
支持读写分离和动态数据源。
对于数据分表水平拆分支持友好。

使用dexcoder-dal，maven坐标

1

2

3

4

5

<dependency>
    <groupId>com.dexcoder</groupId>
    <artifactId>dexcoder-dal-spring</artifactId>
    <version>${version}</version>
</dependency>

几个示例

select

1

2

3

4

5

6

7

//白名单、in、括号、or、asc、desc
//最终sql：SELECT LOGIN_NAME FROM USER WHERE USER_TYPE in (?,?) and ( LOGIN_NAME =  ? or EMAIL =  ? ) and PASSWORD =  ? and  (USER_AGE = ? OR USER_AGE = ? OR USER_AGE = ?)  ORDER BY USER_ID ASC,USER_AGE DESC
Criteria criteria = Criteria.select(User.class).include("loginName")
        .where("userType","in", new Object[] { "1", "2" }).begin().and("loginName", new Object[] { "javaer" })
        .or("email", new Object[] { "javaer@live.com" }).end().and("password", new Object[] { "123456" })
        .and("userAge", new Object[] { 18, 19, 20 }).asc("userId").desc("userAge");
List<User> users = jdbcDao.queryList(criteria);

update

user.setPassword("abcdef");
//方式一 为null的属性值将被忽略
jdbcDao.update(user);
 
//方式二 为null的属性值将更新到数据库
jdbcDao.update(user,false);
 
//方式三 criteria 这里的email设为null也将被更新
Criteria criteria = Criteria.update(User.class).set("password", "update222").set("email",null)
    .where("userId", new Object[] { 56L, 57L, 58L });
jdbcDao.update(criteria);

分页

//进行分页，只需要增加这行，查询方式上没有任何区别
PageControl.performPage(user);
jdbcDao.queryList(user);
//分页后数据由PageControl中获取
Pager pager = PageControl.getPager();
//列表
List<User> users = pager.getList(User.class);
//总记录数
int itemsTotal = pager.getItemsTotal();

执行函数

//max()
Criteria criteria = Criteria.select(User.class).addSelectFunc("max([userId])");
Long userId = jdbcDao.queryForObject(criteria);
 
//count()
Criteria criteria = Criteria.select(User.class).addSelectFunc("count(*)");
Long count = jdbcDao.queryForObject(criteria);
 
//distinct
Criteria criteria = Criteria.select(User.class).addSelectFunc("distinct [loginName]");
List<Map<String, Object>> mapList = jdbcDao.queryForList(criteria);
 
//where中
Criteria criteria = Criteria.select(User.class).where("[gmtCreate]", ">",
    new Object[] { "str_to_date('2015-10-1','%Y-%m-%d')" });
List<User> userList = jdbcDao.queryList(criteria);