title: MyBatis之快速入门
tags: MyBatis
categories: MyBatis

若图片无法显示，请前往我的博客查看，相应文章链接：http://codingxiaxw.cn/2016/11/06/31-mybatis%E5%BF%AB%E9%80%9F%E5%85%A5%E9%97%A8/

首先我要明确告诉大家的是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架构

如下图:

image

接下来我将通过对一张用户表进行增、删、改、查带你快速入门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文件(文件名称随便起),内容如下:

image

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文件内容如下:
[图片上传失败...(image-3d2fb0-1526286009084)]

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

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

image

整体结构如下:

image

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

image

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

image

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

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

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

[图片上传失败...(image-df9150-1526286009084)]

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

• #{}: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.测试类代码如下:

image

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

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

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

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

image

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

2.编写测试类:

image

此时查看数据库:

image

发现数据已被插入。

扩展:主键返回:

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

image

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

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

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

image

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

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

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

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

image

2.编写测试类:

[图片上传失败...(image-e22b9b-1526286009084)]

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

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

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

image

2.编写测试类:

[图片上传失败...(image-671c1a-1526286009084)]

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

5.MyBatis开发流程小结

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

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

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

2018.3.19更

欢迎加入我的Java交流1群:659957958。群里目前已有1800人，每天都非常活跃，但为了筛选掉那些不怀好意的朋友进来搞破坏，所以目前入群方式已改成了付费方式，你只需要支付9块钱，即可获取到群文件中的所有干货以及群里面各位前辈们的疑惑解答；为了鼓励良好风气的发展，让每个新人提出的问题都得到解决，所以我将得到的入群收费收入都以红包的形式发放到那些主动给新手们解决疑惑的朋友手中。在这里，我们除了谈技术，还谈生活、谈理想；在这里，我们为你的学习方向指明方向，为你以后的求职道路提供指路明灯；在这里，我们把所有好用的干货都与你分享。还在等什么，快加入我们吧！

2018.4.21更:如果群1已满或者无法加入，请加Java学习交流2群：305335626 。群2作为群1的附属群，除了日常的技术交流、资料分享、学习方向指明外，还会在每年互联网的秋春招时节在群内发布大量的互联网内推方式，话不多说，快上车吧！

6.联系

If you have some questions after you see this article,you can tell your doubts in the comments area or you can find some info by clicking these links.

• Blog@codingXiaxw's blog

• Weibo@codingXiaxw

• Zhihu@codingXiaxw

• Github@codingXiaxw