# uncode-dal-all **Repository Path**: uncode/uncode-dal-all ## Basic Information - **Project Name**: uncode-dal-all - **Description**: Uncode-DAL是 Java 通用数据访问组件，基于mybatis、spring jdbc、hibernate等ORM框架开发，同时支持基于多数据源的读写分离、主备切换、故障转移，自动恢复、负载均衡、缓存等。可以大大提高开发速度。 - **Primary Language**: Java - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: http://www.uncode.cn - **GVP Project**: No ## Statistics - **Stars**: 329 - **Forks**: 162 - **Created**: 2015-01-13 - **Last Updated**: 2024-11-19 ## Categories & Tags **Categories**: database-dev **Tags**: None ## README uncode-dal =========== 本着不重复造轮子的原则，基于mybatis、spring jdbc、hibernate、mongo等ORM的通用数据访问层，支持基于datasource的读写分离、主备自动切换和故障转移，支持简单的负载均衡。 ## 功能概述 * 基于mybatis、spring jdbc、hibernate等各大orm框架实现通用dal层功能，并可以与已有项目完全兼容。同时也可以在已经实现的orm框架之间任意切换，不需要对代码作任何改动。 * 实现dal层cache，可以自由设置过期时间。 * 实现基于多数据源(datasource)的读写分离、主备切换、故障转移、恢复检测和负载均衡 * 使用该组件必须遵循以下规则： * 在使用DTO时，字段名称与数据库表字段一致，也可以不使用任何DTO类。 * 不支持连表查询，主要是单表操作，如果需要连表请与原生orm框架配合使用。 * sql默认主键字段为id，nosql默认主键字段为_id。 * 支持工具生成dto和service类 ## 使用场景 随着nosql等新方案的出现，关系型数据库更多的被用在业务数据存储中，对于一些像报表等复杂数据处理的工作大部分公司已经不再使用关系型数据库，而对于业务数据90%以上是不需要连表查询等复杂操作的，该组件设计目标是将这90%的工作量变成零，避免重复工作，提高开发速度。使用该组件后将不再需要mybatis的自动生成，spring jdbc的sql语句，hibernate的各种注解，因为组件可以忙你处理。同时该组件只是基于orm框架对所有单表操作的提取和封装，最终还是由相应的orm框架完成持久化工作，所以不会代替orm的工作。因此论你的项目是新项目，还是老项目都可以使用，不会对原有业务生产任何影响，只是使你的操作更加便利，不再需要无数dao类，只要在需要的service中注入即可。组件需要遵循一定的COC规则，所以存在一定的使用限制，请大家注意。 ## 作用示图 ![输入图片说明](http://git.oschina.net/uploads/images/2017/0317/183101_220dfaf8_277761.png "在这里输入图片标题") ## maven 下载最近版本请到release列表：http://git.oschina.net/uncode/uncode-dal-all/releases ### 1 mybatis cn.uncode uncode-dal 1.0.3 cn.uncode uncode-dal-mybatis 1.0.3 ### 2 spring jdbc cn.uncode uncode-dal 1.0.3 cn.uncode uncode-dal-spring-jdbc 1.0.3 ### 3 mongo cn.uncode uncode-dal 1.0.3 cn.uncode uncode-dal-mongo 1.0.3 ## 自动生成工具 ![输入图片说明](http://git.oschina.net/uploads/images/2017/0221/190939_07e2bee1_277761.jpeg "在这里输入图片标题") ![输入图片说明](http://git.oschina.net/uploads/images/2017/0221/191820_c0d8683b_277761.jpeg "在这里输入图片标题") ## spring集成 动态数据源可以自动处理故障转移和恢复检测，读写分离时多个读库采用随机获取。缓存可以自定义实现，可以统一开启或关闭，方便在开发环境使用。 ### 1 DataSource配置 可以使用任意数据库连接池组件，建议使用Druid。配置Fastser-DAL动态数据源，将自动实现读写分离、主备自动切换和故障转移等，建议使用。使用Fastser-DAL动态数据源后，在spring jdbc/mybatis配置中将所有的ref="dataSource"换成ref="dynamicDataSource"即可。 ### 2 Spring jdbc 实现配置 ### 3 Mybatis 实现配置 ### 4 MongoDB 实现配置 ## 与原生框架配合使用 该组件只处理所有单表操作，对于连表等复杂操作可以使用原生框架，以达到在满足所有功能的前提下提高开发效率，降低成本。 ### 1 Spring jdbc JdbcTemplate jdbcTemplate = (JdbcTemplate)baseDAL.getTemplate(); ### 2 Mybatis ### 3 MongoDB MongoDB mongoDB = (MongoDB)baseDAL.getTemplate(); ## API ### 1 列表查询 fields需要显示的字段，queryCriteria查询条件，seconds缓存时间 QueryResult selectByCriteria(List fields, QueryCriteria queryCriteria); QueryResult selectByCriteria(String[] fields, QueryCriteria queryCriteria); QueryResult selectByCriteria(List fields, QueryCriteria queryCriteria, int seconds); QueryResult selectByCriteria(String[] fields, QueryCriteria queryCriteria, int seconds); QueryResult selectByCriteria(QueryCriteria queryCriteria); QueryResult selectByCriteria(QueryCriteria queryCriteria, int seconds); QueryResult selectPageByCriteria(List fields, QueryCriteria queryCriteria); QueryResult selectPageByCriteria(String[] fields, QueryCriteria queryCriteria); QueryResult selectPageByCriteria(List fields, QueryCriteria queryCriteria, int seconds); QueryResult selectPageByCriteria(String[] fields, QueryCriteria queryCriteria, int seconds); QueryResult selectPageByCriteria(QueryCriteria queryCriteria); QueryResult selectPageByCriteria(QueryCriteria queryCriteria, int seconds); ### 2 统计查询 queryCriteria查询条件，seconds缓存时间 int countByCriteria(QueryCriteria queryCriteria); int countByCriteria(QueryCriteria queryCriteria, int seconds); ### 3 主键查询 Object带主键对象实体，fields需要显示的字段，queryCriteria查询条件，seconds缓存时间，clazz对象实例类型，id对象主键 QueryResult selectByPrimaryKey(Object obj); QueryResult selectByPrimaryKey(Object obj, int seconds); QueryResult selectByPrimaryKey(List fields, Object obj); QueryResult selectByPrimaryKey(String[] fields, Object obj); QueryResult selectByPrimaryKey(List fields, Object obj, int seconds); QueryResult selectByPrimaryKey(String[] fields, Object obj, int seconds); QueryResult selectByPrimaryKey(String[] fields, String database, Object obj, int seconds); QueryResult selectByPrimaryKey(Class clazz, Object id); QueryResult selectByPrimaryKey(String table, Object id); QueryResult selectByPrimaryKey(Class clazz, Object id, int seconds); QueryResult selectByPrimaryKey(String table, Object id, int seconds); QueryResult selectByPrimaryKey(List fields, Class clazz, Object id); QueryResult selectByPrimaryKey(List fields, String table, Object id); QueryResult selectByPrimaryKey(List fields, Class clazz, Object id, int seconds); QueryResult selectByPrimaryKey(List fields, String table, Object id, int seconds); ### 4 插入 Object带主键对象实体 Object insert(Object obj); Object insert(String table, Map obj); Object insert(String database, String table, Map obj); void asynInsert(Object obj); void asynInsert(String table, Map obj); void asynInsert(String database, String table, Map obj); ### 5 更新 Object带主键对象实体，queryCriteria查询条件 int updateByCriteria(Object obj, QueryCriteria queryCriteria); int updateByPrimaryKey(Object obj); int updateByPrimaryKey(String table, Map obj); int updateByPrimaryKey(String database, String table, Map obj); ### 6 删除 Object带主键对象实体，queryCriteria查询条件，clazz对象实例类型，id对象主键 int deleteByPrimaryKey(Object obj); int deleteByPrimaryKey(String table, Map obj); int deleteByPrimaryKey(Class clazz, Object id); int deleteByPrimaryKey(String table, Object id); int deleteByPrimaryKey(String database, String table, Object id); int deleteByCriteria(QueryCriteria queryCriteria); ### 7 其他操作 database数据名称，tableName表名称 void reloadTable(String tableName); void clearCache(String tableName); void reloadTable(String database, String tableName); void clearCache(String database, String tableName); ### 8 QueryCriteria方法 //排序，如：id desc, name setOrderByClause(String orderByClause) //去重 setDistinct(boolean distinct) //只查询一条 ssetSelectOne(boolean selectOne) //第几页，首页为1 setPageSize(int pageSize) //设置表名 setTable(String table) //设置数据库名称，一般不需要设置 setDatabase(String database) //使用乐观锁时设置版本，只用于更新操作 setVersion(Object version) //根据DTO对象类型设置名表，此时DTO类名必须与表名一致 setTable(Class clazz) ### 9 Criteria方法 Criteria append(Condition condition, String filed, Object value) Criteria append(String filed, Object value) Criteria append(String sql) andColumnIsNull(String column) andColumnIsNotNull(String column) andColumnEqualTo(String column, Object value) andColumnNotEqualTo(String column, Object value) andColumnGreaterThan(String column, Object value) andColumnGreaterThanOrEqualTo(String column, Object value) andColumnLessThan(String column, Object value) andColumnLessThanOrEqualTo(String column, Object value) andColumnIn(String column, List values) andColumnNotIn(String column, List values) andColumnLike(String column, Object value) andColumnNotLike(String column, Object value) andColumnBetween(String column, Object value1, Object value2) andColumnNotBetween(String column, Object value1, Object value2) ### 10 QueryResult方法 //单条数据以map获取 Map get() //单条数据以map获取,并使用别名替换原来字段 Map getWithAliasName(Map aliasName) //单条数据以map获取,并隐藏不需要显示的字段 Map get(List hiddenFields) //单条数据以map获取,隐藏不需要显示的字段,使用别名替换原来字段 Map getWithAliasName(List hiddenFields, Map aliasName) //多条数据以list获取 List> getList() //多条数据以list获取,并隐藏不需要显示的字段 List> getList(List hiddenFields) //多条数据以list获取,并使用别名替换原来字段 List> getList(Map aliasName) //多条数据以list获取,隐藏不需要显示的字段,使用别名替换原来字段 List> getList(List hiddenFields, Map aliasName) //单条数据转为对象 T as(Class beanClass) //多条数据转为对象 List asList(Class beanClass) //获取分页信息 Map getPage() ## 使用示例 ### 1 User表结构 CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT, `name` varchar(20) DEFAULT NULL COMMENT '用户名', `pwd` varchar(50) DEFAULT NULL '密码' `email` varchar(30) DEFAULT NULL '邮箱', `status` int(11) DEFAULT '0' COMMENT '1正常0禁用', `age` int(11) DEFAULT NULL '年龄', PRIMARY KEY (`id`), UNIQUE KEY `unique_user_userName` (`userName`) ) ENGINE=MyISAM AUTO_INCREMENT=167 DEFAULT CHARSET=utf8; ### 2 User.class对象 import java.io.Serializable; @Table(name="tb_user") public class User implements Serializable { private static final long serialVersionUID = 4799201163494761002L; public static final String ID = "id"; public static final String NAME = "name"; public static final String PWD = "pwd"; public static final String EMAIL = "email"; public static final String STATUS = "status"; public static final String AGE = "age"; private int id; @Field(name="fd_name") private String name; private String pwd; private String email; private int status; private int age; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getPwd() { return pwd; } public void setPwd(String pwd) { this.pwd = pwd; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } public int getStatus() { return status; } public void setStatus(int status) { this.status = status; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } } ### 3 BaseDal注入 * 注解方式 import cn.uncode.dal.core.BaseDAL; @Service public class UserService implements IUserService{ @Autowired private BaseDAL baseDAL; ..... ｝ * XML方式 ### 4 无DTO示例 * 列表查询 * 示例1 //创建查询对象 QueryCriteria queryCriteria = new QueryCriteria(); //没有DTO对象时可以直接设置表名 //queryCriteria.setTable("user"); //创建条件封装对象 Criteria critera = queryCriteria.createCriteria(); //设置条件 critera.append(Condition.GREATER_THAN, "age", 18).append("status", 1); //critera.andColumnGreaterThan(“age”, 18); //critera.andColumnEqualTo("status", 1); //查询所有字段并缓存 QueryResult result = baseDAL.selectByCriteria(queryCriteria); //查询部分字段缓存60称 QueryResult result = baseDAL.selectByCriteria(new String[]{"name","pwd"},queryCriteria, 60); List> users = result.getList(); //也可以转成对应的DTO列表 List users = result.asList(User.class); * 示例2 //创建查询对象 QueryCriteria queryCriteria = new QueryCriteria(); //设置查询表，这样设置时类名必须与表名一致 queryCriteria.setTable(“user”); //设置分页 queryCriteria.setPageIndex(1); queryCriteria.setPageSize(20); //设置排序 queryCriteria.setOrderByClause("age desc"); //分页查询并缓存60称 QueryResult result = baseDAL.selectPageByCriteria(queryCriteria, 60); List> list = result.getList(); Map page = result.getPage(); * 主键查询 * 示例1 Map user = new HashMap(); user.put("id", 1); //缓存20秒 QueryResult result = baseDAL.selectByPrimaryKey(user, 20); user = result.get(); //也可以传为DTO对象 User dto = result.as(User.class); * 示例2 //显示部分字段，不使用缓存 QueryResult result = baseDAL.selectByPrimaryKey(new String[]{"name","pwd"｝，"user", 1，BaseDal.NO_CAHCE); Map user = result.get(); * 示例3 //不使用DTO对象，直接传表名 QueryResult result = baseDAL.selectByPrimaryKey(”user“, 1，BaseDal.NO_CAHCE); Map user = result.get(); * 示例4 //联合主键查询 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable(“user”); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo("name", "uncode-dal"); critera.andColumnEqualTo("pwd", "uncode-dal-mybatis"); queryCriteria.setSelectOne(true); QueryResult result = baseDAL.selectByCriteria(queryCriteria); Map user = result.get(); * 插入 * 示例1 Map user = new HashMap(); user.put("name", "uncode"); user.put("pwd", faster"); //第一个参数为表名 int result = baseDAL.insert("user", user); * 更新 * 示例1 Map user = new HashMap(); user.put("name", "uncode-dal-mybatis"); user.setName("uncode-dal-mybatis"); QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable("user"); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo("name", "uncode"); int result = baseDAL.updateByCriteria(user, queryCriteria); * 示例2 Map user = new HashMap(); user.put("email", "ywj_316@qq.com"); user.put("id", 1); //第一个参数为表名，user中必须包括所有主键字段 int result = baseDAL.updateByPrimaryKey("user", user); * 示例3 Map user = new HashMap(); //设置为null user.put("email", null); user.put("id", 1); //第一个参数为表名，user中必须包括所有主键字段 int result = baseDAL.updateByPrimaryKey("user", user); * 示例4 Map user = new HashMap(); //设置函数 user.put("email", "=concat('11','22')"); user.put("age", "=age+1"); user.put("id", 1); //第一个参数为表名，user中必须包括所有主键字段 int result = baseDAL.updateByPrimaryKey("user", user); * 删除 * 示例1 Map user = new HashMap(); user.put("email", "ywj_316@qq.com"); user.put("id", 1); //user中必须包括所有主键字段 int result = baseDAL.deleteByPrimaryKey("user", user); * 示例2 //第一个参数为表名 int result = baseDAL.deleteByPrimaryKey(“user”, 165); * 示例3 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable("user"); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo("name", "uncode"); int result = baseDAL.deleteByCriteria(queryCriteria); * 其他操作 * 示例1 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable("user"); Criteria critera = queryCriteria.createCriteria(); critera.andColumnGreaterThan("age", 18); critera.andColumnEqualTo("status", 1); //数量统计 int result = baseDAL.countByCriteria(queryCriteria); ### 5 使用DTO示例 * 列表查询 * 示例1 //创建查询对象 QueryCriteria queryCriteria = new QueryCriteria(); //设置查询表，这样设置时类名必须与表名一致 queryCriteria.setTable(User.class); //创建条件封装对象 Criteria critera = queryCriteria.createCriteria(); //设置条件 critera.append(Condition.GREATER_THAN, "age", 18).append("status", 1); //critera.andColumnGreaterThan(User.AGE, 18); //critera.andColumnEqualTo(User.STATUS, 1); //查询所有字段并缓存 QueryResult result = baseDAL.selectByCriteria(queryCriteria); //查询部分字段不缓存 QueryResult result = baseDAL.selectByCriteria(new String[]{"name","pwd"},queryCriteria, BaseDal.NO_CACHE); List users = result.asList(User.class); * 示例2 //创建查询对象 QueryCriteria queryCriteria = new QueryCriteria(); //设置查询表，这样设置时类名必须与表名一致 queryCriteria.setTable(User.class); //设置分页 queryCriteria.setPageIndex(1); queryCriteria.setPageSize(20); //设置排序 queryCriteria.setOrderByClause(User.AGE+" desc"); //分页查询并缓存60称 QueryResult result = baseDAL.selectPageByCriteria(queryCriteria, 60); List users = result.asList(User.class); Map page = result.getPage(); * 主键查询 * 示例1 User user = new User(); user.setId(1); //缓存20秒,有多个主键时必须全部设值 QueryResult result = baseDAL.selectByPrimaryKey(user, 20); user = result.as(User.class); * 示例2 //显示部分字段，不使用缓存 QueryResult result = baseDAL.selectByPrimaryKey(new String[]{"name","pwd"｝，User.class, 1，BaseDal.NO_CAHCE); User user = result.as(User.class); * 示例3 //联合主键也可以使用这种方式查询 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable(User.class); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo(User.NAME, "uncode-dal"); critera.andColumnEqualTo(User.PWD, "uncode-dal-mybatis"); queryCriteria.setSelectOne(true); QueryResult result = baseDAL.selectByCriteria(queryCriteria); User user = result.as(User.class); * 插入 * 示例1 User user = new User(); user.setName("uncode"); user.setPwd("faster"); int result = baseDAL.insert(user); * 更新 * 示例1 User user = new User(); user.setName("uncode-dal-mybatis"); QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable(User.class); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo(User.NAME, "uncode"); int result = baseDAL.updateByCriteria(user, queryCriteria); * 示例2 User user = new User(); user.setEmail("ywj_316@qq.com"); user.setId(1); //user中必须设值所有主键字段 int result = baseDAL.updateByPrimaryKey(user); * 删除 * 示例1 User user = new User(); user.setId(1); //user中必须设值所有主键字段 int result = baseDAL.deleteByPrimaryKey(user); * 示例2 int result = baseDAL.deleteByPrimaryKey(User.class, 165); * 示例3 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable(User.class); Criteria critera = queryCriteria.createCriteria(); critera.andColumnEqualTo(User.NAME, "uncode"); int result = baseDAL.deleteByCriteria(queryCriteria); * 其他操作 * 示例1 QueryCriteria queryCriteria = new QueryCriteria(); queryCriteria.setTable(User.class); Criteria critera = queryCriteria.createCriteria(); critera.andColumnGreaterThan(User.AGE, 18); critera.andColumnEqualTo(User.STATUS, 1); //数量统计 int result = baseDAL.countByCriteria(queryCriteria); ## 版权 作者：冶卫军（ywj_316@qq.com,微信:yeweijun） 技术支持QQ群：47306892 Copyright 2013 www.uncode.cn