dexcoder-assistants: dexcoder快速开发工具包，dexcoder-assistant的开源部分

#Dexcoder快速开发工具包，目前主要有以下功能组件：

基于Spring JdbcTemplate的通用dao
比Apache BeanUtils更强大高效的Bean转换工具类

##基于Spring JdbcTemplate的通用dao使用说明

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

该通用dao是在使用过程中，针对常规的泛型dao经常遇到的一些不便问题进行了改进。命名上遵循了约定优于配置的原则，典型约定如下：

表名约定 USER_INFO表实体类名为UserInfo。
字段名约定 USER_NAME实体类中属性名为userName。
主键名约定 USER_INFO表主键名为USER_INFO_ID，同理实体类中属性名为userInfoId。
Oracle序列名约定 USER_INFO表对应的主键序列名为SEQ_USER_INFO

当然，这些你可以在扩展中改变它，但不建议这么做，这本身就是一个良好的规范。

目前除了具有常规泛型dao的功能外还具有如下特性：

一个dao可以操作所有的实体类，不必再一个个建立跟实体对应的继承于类似BaseDao这类“通用dao”了。
各类方法参数支持Entity和Criteria两种方式。
sql的where条件支持不等于(column != value)、等于多个值(column = value1 or column = value2)和in的方式(column in (value1,value2,...))。
允许在查询时指定使用哪个字段进行排序，可以指定多个进行组合升降序自由排序。
支持在查询时指定返回字段的白名单和黑名单，可以指定只返回某些字段或不返回某个大字段。
方便强大的分页功能，无须额外操作，二三行代码搞定分页，自动判断数据库，无须指定。

要在项目中使用通用dao十分简单，只需要在spring的配置文件中声明如下bean：

<bean id="jdbcDao" class="com.dexcoder.assistant.persistence.JdbcDaoImpl"> <property name="jdbcTemplate" ref="jdbcTemplate"/> </bean> <!--需要分页时声明--> <bean id="pageControl" class="com.dexcoder.assistant.interceptor.PageControl"/>

接下来就可以注入到您的Service或者其它类中使用了。

##下面是一些常用的方法示例，这里的Entity对象为User，对于任何的Entity都是一样的.

先来看一下User对象及它继承的Pageable

public class User extends Pageable {
	private Long    userId;
	private String  userName;
	private Integer userAge;
	private Date    gmtCreate;
	private Date    gmtModify;
	//......
}

Pageable对象，用来保存页码、每页条数信息以支持分页

public class Pageable implements Serializable {
	/** 每页显示条数 */
	protected int             itemsPerPage     = 20;
	/** 当前页码 */
	protected int             curPage          = 1;
	
	//......
}

都是普通的JavaBean对象，下面来看看如何进行具体的增删改查，每种操作都演示了Entity和Criteria两种方式。

###insert操作 public void insert() { User user = new User(); user.setUserName("liyd"); user.setUserAge(20); user.setGmtCreate(new Date()); Long id = jdbcDao.insert(user); System.out.println(id); }

public void insert2() {
	Criteria criteria = Criteria.create(User.class).set("userName", "liyd22")
		.set("userAge", 22).set("gmtCreate", new Date());
	Long id = jdbcDao.insert(criteria);
	System.out.println(id);
}

###save操作，和insert的区别在于不处理主键，由调用者指定 public void save() { user.setUserId(-123L); jdbcDao.save(user); }

public void save2() {
    Criteria criteria = Criteria.create(User.class).set("userId", -122L)
        .set("userName", "liyd22").set("userAge", 22).set("gmtCreate", new Date())
        .set("gmtModify", new Date());
    jdbcDao.save(criteria);
}

###update操作 public void update() { user.setUserId(34L); user.setUserName("liyd34"); user.setGmtCreate(null); user.setGmtModify(new Date()); jdbcDao.update(user); }

public void update2() {
    //这里where条件userId传入了多个值，会生成in语句
    Criteria criteria = Criteria.create(User.class).set("userName", "liydCriteria")
        .set("userAge", "18").where("userId", new Object[] { 34L, 33L, 32L });
    jdbcDao.update(criteria);
}

###get操作 public void get1() { //根据主键 User u = jdbcDao.get(User.class, 23L); }

public void get2() {
    //criteria，主要用来指定字段白名单、黑名单等
    Criteria criteria = Criteria.create(User.class).include("userName");
    User u = jdbcDao.get(criteria, 23L);
}

###delete操作 public void delete() { //会把不为空的属性做为where条件 User u = new User(); u.setUserName("selfly"); u.setUserAge(16); jdbcDao.delete(u); }

public void delete2() {
    //where条件使用了or
    Criteria criteria = Criteria.create(User.class).where("userName", new Object[] { "liyd2" })
        .or("userAge", new Object[]{64});
    jdbcDao.delete(criteria);
}

public void delete3() {
    //根据主键
    jdbcDao.delete(User.class, 25L);
}

###列表查询操作 public void queryList1() { //以不为空的属性作为查询条件 User u = new User(); u.setUserName("liyd"); List users = jdbcDao.queryList(u); }

public void queryList2() {
    //Criteria方式
    Criteria criteria = Criteria.create(User.class).exclude("userId")
        .where("userName", new Object[]{"liyd"});
    List<User> users = jdbcDao.queryList(criteria);
}

public void queryList3() {
    //使用了like，可以换成!=、in、not in等
    Criteria criteria = Criteria.create(User.class).where("userName", "like",
        new Object[] { "%liyd%" });
    user.setUserAge(16);
    //这里entity跟criteria方式混合使用了，建议少用
    List<User> users = jdbcDao.queryList(user, criteria.include("userId"));
}

public void queryList4() {
    //不指定条件即查询出所有
    List<User> users = jdbcDao.queryList(Criteria.create(User.class));
}

###count记录数查询，除了返回值不一样外，其它和列表查询一致 public void queryCount() { user.setUserName("liyd"); int count = jdbcDao.queryCount(user); }

public void queryCount2() {
    Criteria criteria = Criteria.create(User.class).where("userName", new Object[] { "liyd" })
        .or("userAge", new Object[]{27});
    int count = jdbcDao.queryCount(criteria);
}

###查询单个结果 public void querySingleResult() { user = jdbcDao.querySingleResult(user); }

public void querySingleResult2() {
    Criteria criteria = Criteria.create(User.class).where("userName", new Object[] { "liyd" })
        .and("userId", new Object[]{23L});
    User u = jdbcDao.querySingleResult(criteria);
}

###指定字段白名单，在任何查询方法中都可以使用 public void get(){ //将只返回userName Criteria criteria = Criteria.create(User.class).include("userName"); User u = jdbcDao.get(criteria, 23L); }

###指定字段黑名单，在任何查询方法中都可以使用 public void get4(){ //将不返回userName Criteria criteria = Criteria.create(User.class).exclude("userName"); User u = jdbcDao.get(criteria, 23L); }

###指定排序 public void queryList() { //指定多个排序字段，asc、desc Criteria criteria = Criteria.create(User.class).exclude("userId") .where("userName", new Object[]{"liyd"}).asc("userId").desc("userAge"); List users = jdbcDao.queryList(criteria); }

###分页 public void queryList1() { //进行分页 PageControl.performPage(user); //分页后该方法即返回null，由PageControl中获取 jdbcDao.queryList(user); Pager pager = PageControl.getPager(); //列表 List users = pager.getList(User.class); //总记录数 int itemsTotal = pager.getItemsTotal(); }

public void queryList2() {
	//直接传入页码和每页条数
	PageControl.performPage(1, 10);
	//使用Criteria方式，并指定排序字段方式为asc
	Criteria criteria = Criteria.create(User.class).include("userName", "userId")
		.where("userName", new Object[]{"liyd"}).asc("userId");
	jdbcDao.queryList(criteria);
	Pager pager = PageControl.getPager();
}

###一些说明

JdbcDao在声明时可以根据需要注入其它几个参数：

nameHandler 默认使用DefaultNameHandler，即遵守上面的约定优于配置，如果需要自定义可以实现该接口。
rowMapperClass 默认使用了spring的BeanPropertyRowMapper.newInstance(clazz),需要自定义可以自行实现，标准spring的RowMapper实现即可。
dialect 默认为自增类主键如MySql，其它类型请指定数据库如oracle

##相关链接

对应的实现思路及步骤：http://www.dexcoder.com/blog/series/56.shtml

某些详细信息可能需要阅读第一个版本：http://www.dexcoder.com/blog/series/32.shtml

作者QQ： 341470

作者邮箱： javaer@live.com

交流QQ群： 32261424

minghai / dexcoder-assistants

简介

发行版

贡献者

近期动态

minghai / dexcoder-assistants .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

minghai / dexcoder-assistants