easymybatis是一个mybatis增强类库，目的为简化mybatis的开发，让开发更高效。

easymybatis的特性如下：

无需编写xml文件即可完成CRUD操作。
支持多表查询、聚合查询、分页查询（支持多种数据库）。
支持批量添加，指定字段批量添加。
支持Dao层访问控制，如某个dao只有查询功能，某个dao有crud功能等。
支持自定义sql，sql语句可以写在配置文件中，同样支持mybatis标签。
支持mysql，sqlserver，oracle，其它数据库扩展方便（增加一个模板文件即可）。
使用方式不变，与Spring集成只改了一处配置。
轻量级，无侵入性，可与传统mybatis用法共存。
没有修改框架源码(无插件)，采用动态代码生成实现功能。

架构组成

easymybatis的架构如下：

运行流程

easymybatis的运行流程图：

服务器启动的时候easymybatis负责扫描Dao.java。
扫描完成后解析出Dao.class以及实体类Entity.class。
代码生成组件根据Dao.class和Entity.class生成mapper文件内容，生成方式由velocity模板指定。
把mapper文件内容转化成Resource对象设置到SqlSessionFactory中。

快速开始

1 创建springboot项目

访问http://start.spring.io/ 生成一个springboot空项目，输入Group，Artifact点生成即可，如图：点击Generate Project，下载demo.zip

2 导入项目

将下载的demo.zip解压，然后导入项目。eclipse中右键 -> Import... -> Existing Maven Project，选择项目文件夹。导入到eclipse中后等待maven相关jar包下载。

3 添加maven依赖

jar包下载完成后，打开pom.xml，添加如下依赖：



	
  
   net.oschina.durcframework
  
	
  
   easymybatis-spring-boot-starter
  
	
  
   1.4.5
  

 

    
  
   org.springframework.boot
  
    
  
   spring-boot-starter-web
  

 

	
  
   mysql
  
	
  
   mysql-connector-java
  
	
  
   runtime

4 添加数据库配置

在application.properties中添加数据库配置

spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/stu?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull
spring.datasource.username=root
spring.datasource.password=root

5 添加Java文件

假设数据库中有张t_user表，DDL如下：

CREATE TABLE `t_user` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `username` varchar(255) DEFAULT NULL COMMENT '用户名',
  `state` tinyint(4) DEFAULT NULL COMMENT '状态',
  `isdel` bit(1) DEFAULT NULL COMMENT '是否删除',
  `remark` text COMMENT '备注',
  `add_time` datetime DEFAULT NULL COMMENT '添加时间',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户表';

我们加入对应的实体类和Dao:

TUser.java ：

@Table(name = "t_user")
public class TUser {	
	@Id
	@Column(name="id")
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	private Integer id;	// ID	
	private String username; // 用户名	
	private Byte state;	// 状态	
	private Boolean isdel;	// 是否删除	
	private String remark;	// 备注	
	private Date addTime;	// 添加时间
	
    // 省略 getter setter
}

实体类文件采用和hibernate相同的方式，您可以使用我们的代码生成工具生成 https://gitee.com/durcframework/easymybatis-generator

TUserDao.java :

public interface TUserDao extends CrudDao
   {
}

TUserDao继承CrudDao即可，这样这个Dao就拥有了CRUD功能。

6 添加测试用例

public class TUserDaoTest extends DemoApplicationTests {

	@Autowired
	TUserDao dao;

        @Test
	public void testInsert() {
		TUser user = new TUser();
		user.setIsdel(false);		
		user.setRemark("testInsert");		
		user.setUsername("张三");
		
		dao.save(user);
		
		System.out.println("添加后的主键:" + user.getId());		
	}
	
	@Test
	public void testGet() {
		TUser user = dao.get(3);
		System.out.println(user);                
	}

        @Test
	public void testUpdate() {
		TUser user = dao.get(3);
		user.setUsername("李四");		
		user.setIsdel(true);
		
		int i = dao.update(user);
		System.out.println("testUpdate --> " + i);
	}

        @Test
	public void testDel() {
		TUser user = new TUser();
		user.setId(3);
		int i = dao.del(user);
		System.out.println("del --> " + i);
	}
}

然后运行单元测试，运行成功后表示项目已经搭建完毕了。

更多例子可参考TUserDaoTest.java。重点关注Dao，Query对象即可。

如果您不想从头开始搭项目的话，这里有个搭建好的demo项目可以为您使用。

springboot
springmvc

两个版本，一个是基于springboot，一个是传统springmvc，推荐springboot。

easymybatisMybatis 增强类库