MyBatis快速入门（转）

目前网上关于各个框架的教程纷繁杂乱，而且大多是直接复制粘贴书中晦涩难懂的语句，看到最后也一片雾水，实则对新人不甚友好。今天有幸阅读到该博客中的教程，全为博主个人理解、排版美观、代码清晰、通俗易懂，由于博主的博客常常存在打不开的情况，遂转载与大家分享，也希望大家能多支持这样优秀的原创作品！
博文原地址：http://codingxiaxw.cn/2016/11/06/31-mybatis快速入门/

正文：

首先我要明确告诉大家的是MyBatis是一个java持久层框架，以前我们都是用jdbc来将我们的java程序与数据库相连接，而MyBatis是对jdbc的一个封装。

1.MyBatis框架的引入

我们来看看传统的编程方式中使用jdbc的问题:

• 1.数据库连接频繁的创建和关闭，缺点:浪费数据库的资源，影响操作效率。解决方法:使用数据库连接池如c3p0.
• 2.sql语句是硬编码(不利用系统维护)，如果需求变更需要修改sql，这时候就需要修改java代码，然后需要重新编译，系统不易维护。解决方法:将sql语句统一配置在文件中。这样以后修改sql时就不需要修改java代码了。
• 3.我们通过preparedStatement对象向占位符设置参数，存在硬编码(参数位置、参数)问题，系统不易维护。解决方法:将sql中的占位符及对应的参数类型配置在配置文件中，能够自动输入的映射。
• 4.遍历查询结果集存在硬编码(列名)。解决方法:自动进行sql查询结果向java对象的映射(输出映射)。 为了解决这些问题，所以出现了MyBatis框架。

2.MyBatis介绍

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis，实质上Mybatis对ibatis进行一些改进。 目前mybatis在github上托管。

MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

MyBatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

3.MyBatis架构

如下图:

接下来我将通过对一张用户表进行增、删、改、查带你快速入门MyBatis。

4.MyBatis快速入门

4.1准备开发环境

1.创建测试项目，普通java项目或是web项目都可。

2.导入jar包:mybatis-3.1.1.jar(低于这个版本的jar包需要导入很多依赖包)和mysql-connection-java

3.创建数据库和相应的表,SQL脚本如下:

   create database mybatis;
    
    use mybatis;
    
    create table user(
    id int primary key auto_increment,
    username varchar(50),
    birthday date,
    sex varchar(20),
    address carchar(50)
    );
    
    insert into user values(null,'xxw','1996-10-17','male',null);
    
    insert into user values(null,'wyr','1997-04-24','female',null);

到此，环境配置就告一段落。

4 .2使用MyBatis查询表中数据(通过id查询)

1.添加Mybatis的配置文件SqlMapConfig.xml

在src目录下创建一个SqlMapConfig.xml文件(文件名称随便起),内容如下:

2.定义表所需要的实体类User.java

代码如下:

public class User
{
   	private int id;
   	private String username;
   	private Date birthday;
   	private String sex;
   	private String address;

   	public int getId() {
       	return id;
   	}

   	public void setId(int id)
   	{
   		this.id = id;
   	}

   	public String getUsername() {
       	return username;
   	}

   	public void setUsername(String username) {
       	this.username = username;
   	}

   	public Date getBirthday(){
       	return birthday;
   	}

   	public void setBirthday(Date birthday) {
       	this.birthday = birthday;
   	}

   	public String getSex() {
       	return sex;
   	}

   	public void setSex(String sex) {
       	this.sex = sex;
   	}

   	public String getAddress(){
       	return address;
   	}

   	public void setAddress(String address) {
       	this.address = address;
   	}

   	@Override
   	public String toString() {
       	return "domain.User{" +
               "id=" + id +
               ", username='" + username + '\'' +
               ", birthday=" + birthday +
               ", sex='" + sex + '\'' +
               ", address='" + address + '\'' +
               '}';
   	}
   }

3.定义操作user表的sql映射文件User.xml

这里我们没将文件命名为userMapper.xml，后面我们会改。

User.xml文件内容如下:

在User.xml中写SQL语句，在参数处使用占位符#{}，应该注意的是大括号{}中传入的数据应该与User.java中的属性对应，文件中各个属性的解释见图中注释处。

4.在SqlMapConfig文件中注册User.xml文件

在SqlMapConfig.xml中添加一个<mappers></mappers>字段，并在里面传入User.xml文件路径。

整体结构如下:

5.接下来我们便可以借助上面MyBatis架构图来编写测试类了

注意，我是借助junit.jar包来编写的测试类。输出结果如下:

上面我们是通过id来对表进行查询，接下来我要讲讲如何通过姓名来模糊查询表。

4.3使用MyBatis根据用户名模糊查询用户信息

1.需要在User.xml文件中添加如下字段:

此时，我们在传入参数的地方不再使用占位符#{}而是使用${}，二者区别如下:

• #{}:1.表示一个占位符，向占位符输入参数，mybatis自动进行java类型和jdbc类型的转换。2.程序员不需要考虑参数的类型，比如：传入字符串，mybatis最终拼接好的sql就是参数两边加单引号。3.#{}接收pojo(Plain
  Old Java Object Java数据对象)数据，可以使用OGNL(就是el表达式)解析出pojo的属性值。
• ${}:1.表示sql的拼接，通过${}接收参数，将参数的内容不加任何修饰拼接在sql中。2.${}也可以接收pojo数据，可以使用OGNL解析出pojo的属性值。3.缺点:不能防止sql注入。

2.测试类代码如下:

注意，此时我们通过name查询出来的语句为多条，故此时我们应该选择调用sqlSession对象的selectList()方法返回多条记录，输出我们查询到的第一条记录即可。若使用selectOne()方法，当返回的记录为多条时就会发生异常。

这样我们便完成了查询时将sql结果输出映射到Java对象中。那如何将Java对象输入映射到sql语句中，接下来我们就来讲通过MyBatis实现增、删、改数据库。

4.4使用MyBatis向表中插入一条记录

1.在User.xml中添加如下字段:

貌似关键字为value和values都可以…

2.编写测试类:

此时查看数据库:

发现数据已被插入。

扩展:主键返回:

在测试类中，我们没有给User对象的id属性设置值，所以我们在测试类中尝试输出User对象的id时会输出id=0，但是该对象通过输入映射在数据库中是有对应的id值的(因为我们为该字段设置了自增长属性)。那么我们想输出该对象在记录中的id时，又该怎么做呢？只需在User.xml文件中的标签中添加标签即可,属性解释见图:

此时我们在测试类中便可输出该User对象插入在表中的记录id值了。

这里我们由于在建表时设置了id字段为自增长，采用自增长的形式生成主键，所以我们在传入User对象的id属性时可以将该属性设置为null。那么当我们使用uuid生成主键时又该怎么做呢？

只需在User.xml中添加如下字段:

属性值”before”的意思表示在执行插入操作时，会先调用uuid()函数生成uuid得到主键，然后将主键设置到User对象中，再将User对象插入到数据库。所以此时我们在测试类中也可以不对User的id属性进行设置值。

4.5使用MyBatis实现删除表中数据

接下来的操作就很轻松了，因为跟上述操作差不多。

1.在User.xml文件中添加如下字段:

2.编写测试类:

运行程序后便可发现数据库中的该数据已被删除。

4.6使用MyBatis实现更新表中数据

1.在User.xml文件中添加如下字段:

2.编写测试类:

运行程序后便可发现数据库中的该数据已被更新。

5.MyBatis开发流程小结

写过上述代码，我们便可以对MyBatis的开发流程进行一下总结了，流程如下:

• 1.编写SqlMapConfig.xml
• 2.编写mapper.xml(每个字段定义一个statement)
• 3.编程通过配置文件创建SqlSessionFactory
• 4.通过SqlSessionFactory获取SqlSession对象。
• 5.通过SqlSession操作数据库。(如果执行添加、更新、删除需要调用SqlSession.commit())
• 6.SqlSesion使用完成要关闭。

关于MyBatis配置的一些优化及高级知识请见我后面的文章。