在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称:uncode-dal-all开源软件地址:https://gitee.com/uncode/uncode-dal-all开源软件介绍:uncode-dal本着不重复造轮子的原则,基于mybatis、spring jdbc、hibernate、mongo等ORM的通用数据访问层,支持基于datasource的读写分离、主备自动切换和故障转移,支持简单的负载均衡。 功能概述
使用场景随着nosql等新方案的出现,关系型数据库更多的被用在业务数据存储中,对于一些像报表等复杂数据处理的工作大部分公司已经不再使用关系型数据库,而对于业务数据90%以上是不需要连表查询等复杂操作的,该组件设计目标是将这90%的工作量变成零,避免重复工作,提高开发速度。使用该组件后将不再需要mybatis的自动生成,spring jdbc的sql语句,hibernate的各种注解,因为组件可以忙你处理。同时该组件只是基于orm框架对所有单表操作的提取和封装,最终还是由相应的orm框架完成持久化工作,所以不会代替orm的工作。因此论你的项目是新项目,还是老项目都可以使用,不会对原有业务生产任何影响,只是使你的操作更加便利,不再需要无数dao类,只要在需要的service中注入即可。组件需要遵循一定的COC规则,所以存在一定的使用限制,请大家注意。 作用示图maven下载最近版本请到release列表:http://git.oschina.net/uncode/uncode-dal-all/releases 1 mybatis <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal-mybatis</artifactId> <version>1.0.3</version> </dependency> 2 spring jdbc <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal-spring-jdbc</artifactId> <version>1.0.3</version> </dependency> 3 mongo <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>cn.uncode</groupId> <artifactId>uncode-dal-mongo</artifactId> <version>1.0.3</version> </dependency> 自动生成工具spring集成动态数据源可以自动处理故障转移和恢复检测,读写分离时多个读库采用随机获取。缓存可以自定义实现,可以统一开启或关闭,方便在开发环境使用。 1 DataSource配置可以使用任意数据库连接池组件,建议使用Druid。配置Fastser-DAL动态数据源,将自动实现读写分离、主备自动切换和故障转移等,建议使用。使用Fastser-DAL动态数据源后,在spring jdbc/mybatis配置中将所有的ref="dataSource"换成ref="dynamicDataSource"即可。 <!--可选,动态数据源配置 --> <bean id="dynamicDataSource" class="cn.uncode.dal.datasource.DynamicDataSource"> <!-- 从数据库配置,用于读操作,目前负载均衡机制为随机取一个 --> <property name="slaveDataSources"> <map key-type="java.lang.String"> <entry key="readDataSourceOne" value-ref="dataSource3"/> <entry key="readDataSourceTwo" value-ref="dataSource4"/> </map> </property> <!-- 主数据库配置 --> <property name="masterDataSource" ref="dataSource1" /> <!-- 备数据库配置 --> <property name="standbyDataSource" ref="dataSource2" /> </bean> <!--可选,使用动态数据源读写分离时必选 --> <bean id="transactionManager" class="cn.uncode.dal.jdbc.datasource.DataSourceTransactionManager"> <property name="dataSource" ref="dataSource" /> </bean> <!-- 可选,Spring事务 --> <tx:annotation-driven transaction-manager="transactionManager" /> 2 Spring jdbc 实现配置 <!-- 可选,缓存默认实现,集群时建议使用分布式缓存自定义实现 --> <bean id="dalCache" class="cn.uncode.dal.cache.impl.ConcurrentMapCache"></bean> <!-- 配置缓存 --> <bean id="cacheManager" class="cn.uncode.dal.cache.support.SimpleCacheManager"> <property name="cache" ref="dalCache"></property> </bean> <!-- 配置数据源解析器 --> <bean id="resolveDatabase" class="cn.uncode.dal.descriptor.db.impl.SimpleResolveDatabase"> <property name="dataSource" ref="dataSource" /> <property name="cacheManager" ref="cacheManager" /> </bean> <!-- spring jdbc实现配置 --> <bean id="commonJdbcSupport" class="cn.uncode.dal.spring.jdbc.CommonJdbcSupport"> <property name="dataSource" ref="dataSource" /> </bean> <bean id="baseDAL" class="cn.uncode.dal.spring.jdbc.SpringJDBCDAL"> <property name="cacheManager" ref="cacheManager" /> <property name="commonJdbcSupport" ref="commonJdbcSupport" /> <property name="resolveDatabase" ref="resolveDatabase" /> <!-- 可选,配置全局不使用缓存,默认为true --> <property name="useCache" value="false" /> <!-- 可选,乐观锁,如果配置该项并且表中存在字段名为ver的字段,则该表可使用乐观锁机制 --> <property name="version" value="ver" /> </bean> 3 Mybatis 实现配置 <!-- 可选,缓存默认实现,集群时建议使用分布式缓存自定义实现 --> <bean id="dalCache" class="cn.uncode.dal.cache.impl.ConcurrentMapCache"></bean> <!-- 配置缓存 --> <bean id="cacheManager" class="cn.uncode.dal.cache.support.SimpleCacheManager"> <property name="cache" ref="dalCache"></property> </bean> <!-- 配置数据源解析器 --> <bean id="resolveDatabase" class="cn.uncode.dal.descriptor.db.impl.SimpleResolveDatabase"> <property name="dataSource" ref="dataSource" /> <property name="cacheManager" ref="cacheManager" /> </bean> <!-- mybatis实现配置 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> </bean> <bean id="commonMapper" class="org.mybatis.spring.mapper.MapperFactoryBean"> <property name="sqlSessionFactory" ref="sqlSessionFactory" /> <property name="mapperInterface" value="cn.uncode.dal.mybatis.CommonMapper" /> </bean> <bean id="baseDAL" class="cn.uncode.dal.mybatis.MybatisDAL"> <property name="cacheManager" ref="cacheManager" /> <property name="commonMapper" ref="commonMapper" /> <property name="resolveDatabase" ref="resolveDatabase" /> <!-- 可选,配置全局不使用缓存,默认为true --> <property name="useCache" value="false" /> <!-- 可选,乐观锁,如果配置该项并且表中存在字段名为ver的字段,则该表可使用乐观锁机制 --> <property name="version" value="ver" /> </bean> 4 MongoDB 实现配置 <!-- 可选,缓存默认实现,集群时建议使用分布式缓存自定义实现 --> <bean id="dalCache" class="cn.uncode.dal.cache.impl.ConcurrentMapCache"></bean> <!-- 可选,配置缓存 --> <bean id="cacheManager" class="cn.uncode.dal.cache.support.SimpleCacheManager"> <property name="cache" ref="dalCache"></property> </bean> <!-- mongo实现配置 --> <bean id="mongoDataBase" class="cn.uncode.dal.mongo.MongoDataBase"> <property name="host" value="172.16.30.98" /> <property name="port" value="27017" /> <property name="db" value="test" /> <property name="username" value="xiaocong" /> <property name="password" value="xiaocong" /> </bean> <!-- 注意,mongo3.x请使用cn.uncode.dal.mongo.Mongo3DAL --> <bean id="mongoDAL" class="cn.uncode.dal.mongo.MongoDAL"> <property name="database" ref="mongoDataBase"></property> <!-- 可选,配置全局不使用缓存,默认为true --> <property name="useCache" value="false" /> </bean> 与原生框架配合使用该组件只处理所有单表操作,对于连表等复杂操作可以使用原生框架,以达到在满足所有功能的前提下提高开发效率,降低成本。 1 Spring jdbcJdbcTemplate jdbcTemplate = (JdbcTemplate)baseDAL.getTemplate(); 2 Mybatis<!-- 将原来的SqlSessionFactory配置修改如下 --><bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> <property name="configLocation" value="classpath:mybatis.xml"></property> <property name="mapperLocations" value="classpath:/cn/uncode/mapper/*Mapper.xml" /></bean> <!-- 扫描注入Dao --><bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="cn.uncode.mapper" /></bean> 3 MongoDBMongoDB mongoDB = (MongoDB)baseDAL.getTemplate(); API1 列表查询fields需要显示的字段,queryCriteria查询条件,seconds缓存时间 QueryResult selectByCriteria(List<String> fields, QueryCriteria queryCriteria); QueryResult selectByCriteria(String[] fields, QueryCriteria queryCriteria); QueryResult selectByCriteria(List<String> 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<String> fields, QueryCriteria queryCriteria); QueryResult selectPageByCriteria(String[] fields, QueryCriteria queryCriteria); QueryResult selectPageByCriteria(List<String> 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<String> fields, Object obj); QueryResult selectByPrimaryKey(String[] fields, Object obj); QueryResult selectByPrimaryKey(List<String> 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<String> fields, Class<?> clazz, Object id); QueryResult selectByPrimaryKey(List<String> fields, String table, Object id); QueryResult selectByPrimaryKey(List<String> fields, Class<?> clazz, Object id, int seconds); QueryResult selectByPrimaryKey(List<String> fields, String table, Object id, int seconds); 4 插入Object带主键对象实体 Object insert(Object obj); Object insert(String table, Map<String, Object> obj); Object insert(String database, String table, Map<String, Object> obj); void asynInsert(Object obj); void asynInsert(String table, Map<String, Object> obj); void asynInsert(String database, String table, Map<String, Object> obj); 5 更新Object带主键对象实体,queryCriteria查询条件 int updateByCriteria(Object obj, QueryCriteria queryCriteria); int updateByPrimaryKey(Object obj); int updateByPrimaryKey(String table, Map<String, Object> obj); int updateByPrimaryKey(String database, String table, Map<String, Object> obj); 6 删除Object带主键对象实体,queryCriteria查询条件,clazz对象实例类型,id对象主键 int deleteByPrimaryKey(Object obj); int deleteByPrimaryKey(String table, Map<String, Object> 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<Object> values) andColumnNotIn(String column, List<Object> 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<String, Object> get() //单条数据以map获取,并使用别名替换原来字段 Map<String, Object> getWithAliasName(Map<String, String> aliasName) //单条数据以map获取,并隐藏不需要显示的字段 Map<String, Object> get(List<String> hiddenFields) //单条数据以map获取,隐藏不需要显示的字段,使用别名替换原来字段 Map<String, Object> getWithAliasName(List<String> hiddenFields, Map<String, String> aliasName) //多条数据以list获取 List<Map<String, Object>> getList() //多条数据以list获取,并隐藏不需要显示的字段 List<Map<String, Object>> getList(List<String> hiddenFields) //多条数据以list获取,并使用别名替换原来字段 List<Map<String, Object>> getList(Map<String, String> aliasName) //多条数据以list获取,隐藏不需要显示的字段,使用别名替换原来字段 List<Map<String, Object>> getList(List<String> hiddenFields, Map<String, String> aliasName) //单条数据转为对象 <T> T as(Class<T> beanClass) //多条数据转为对象 <T> List<T> asList(Class<T> beanClass) //获取分页信息 Map<String, Object> 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注入
4 无DTO示例
5 使用DTO示例
版权作者:冶卫军([email protected],微信:yeweijun) 技术支持QQ群:47306892 Copyright 2013 www.uncode.cn |
请发表评论