1 引导

框架的概念在以前的博文中也有提到，此处简单说明下，框架实质是软件开发中的一套解决方案，不同的框架解决的是不同的问题。

1）使用框架的好处：框架封装了很多细节，开发者可以很简单的实现某些功能，提高开发效率；

2）框架解决了什么问题？

看下三层架构和SSM框架的对应关系，MyBatis框架是解决的持久层的问题，与数据库交互，进行增删改查操作的。

3）持久层技术解决方案有哪些？

JDBC技术：Connection、PreparedStatement、ResultSet；
Spring的JdbcTemplate：Spring对Jdbc的简单封装；
Apache的DBUtils，和Spring的JdbcTemplate类似，也是对Jdbc的简单封装；

以上都不是框架，JDBC是规范，后两者都只是工具类，是对规范的实现，没有系统的解决方案。

以前使用传统jdbc的步骤很多，操作繁杂，我们要实现一个需求的功能，从数据库表中查找一个结果，希望没有这么多繁杂的操作步骤，把焦点放在功能的实现上即可，实现高效率开发，MyBatis框架就是帮我们解决这些问题的。

2 MyBatis框架入门

MyBatis是一个基于Java的持久层框架，封装了jdbc操作的细节，开发者只需要关注sql语句本身，不需要关注注册驱动、创建连接、创建statement等过程，它使用了ORM思想实现了结果集封装。

注：ORM，Object Relational Mapping对象关系映射，就是把数据库表和实体类的属性对应起来，让我们可以操作实体类就可以操作数据库表。我们需要保证实体类属性和数据库表的字段名称保持一致，有一个好习惯；

2.1 MyBatis环境搭建

下面以一个案例形式一步步看下如何搭建MyBatis环境。

1）准备数据库，在本地数据库db4中新建一个user表，插入数据：

CREATE DATABASE db4;
USE db4;
CREATE TABLE USER (
	id INT(11) NOT NULL PRIMARY KEY AUTO_INCREMENT,
	username VARCHAR(32) NOT NULL COMMENT '用户名称',
	birthday DATETIME DEFAULT NULL COMMENT '生日',
	sex VARCHAR(1) DEFAULT NULL COMMENT '性别',
	address VARCHAR(256) DEFAULT NULL COMMENT '地址'
) ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT  INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) VALUES (1,'老王','2018-02-27 17:47:08','男','北京'),(2,'李四','2018-03-02 15:09:37','女','上海'),(3,'王五','2018-03-04 11:34:34','女','南京');

2）新建Maven工程，不使用模板，此处不展开了，需要回顾的可以看上一篇博文；

3）配置pom.xml文件，导入相关的jar包坐标：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.winter</groupId>
    <artifactId>19.mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>

        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

4）写一个User实体类，实现Serializable，数据库表对应

public class User implements Serializable {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;

    public Integer getId() {
        return id;
    }

    public void setId(Integer 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 "User{" +
                "id=" + id +
                ", username='" + username + ''' +
                ", birthday=" + birthday +
                ", sex='" + sex + ''' +
                ", address='" + address + ''' +
                '}';
    }
}

5）写一个User的持久层接口

//User的持久层接口
public interface UserDao {
    List<User> findAll();
}

至此，准备工作OK了，下面看下MyBatis的环境。

6）在resources包下新建SqlMapConfig.xml文件作为MyBatis的主配置文件，其中做两件事：

配置MySQL的环境：事务类型、连接池、四个基本信息（驱动、url、用户名、密码）；
指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件；

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<!--mybatis的主配置文件 -->
<configuration>
    <!--配置环境 -->
    <environments default="mysql">
        <!--配置mysql环境 -->
        <environment id="mysql">
            <!--配置事务类型 -->
            <transactionManager type="JDBC"></transactionManager>
            <!--配置数据源（连接池） -->
            <dataSource type="POOLED">
                <!--配置连接数据库的四个基本信息 -->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/db4"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件 -->
    <mappers>
        <mapper resource="com/winter/dao/UserDao.xml"></mapper>
    </mappers>
</configuration>

7）新建每个dao的独立配置文件，注意三件事：

在resources包下新建com.winter.dao三级包（mybatis映射配置文件必须和dao接口的包结构相同），命名为UserDao.xml，和SqlMapConfig.xml中指定的名字要一致；
mapper标签下的namespace属性要是UserDao接口的全限定类名；
操作配置（select标签中配置sql语句）中id属性要与UserDao接口中的方法名字一致；

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.winter.dao.UserDao">
    <!--配置查询所有 -->
    <select id="findAll">
        select * from user
    </select>
</mapper>

映射配置文件中的限制很多，这么做的好处是什么呢？我们不需要再写dao的实现类了！（上述的独立配置文件还有点小问题，你发现了吗？没有的话继续阅读下文：））

完成以上后，工程目录结构如下：

2.2 MyBatis入门案例实战

2.2.1 MyBatis读取数据库的入门案例实战

在上一节环境搭建的基础上，我们看下如何使用MyBatis，使用的步骤是怎样的，可以总结为如下几个步骤：

1）读取配置文件；
2）创建SqlSessionFactory工厂；
3）使用工厂生产SqlSession对象；
4）使用SqlSession创建Dao接口的代理对象；
5）使用代理对象执行方法；
6）释放资源。

在src.test.java.com.winter.test包下新建一个测试类MyBatisTest.java:

public class MyBatisTest {
    //MyBatis入门案例
    @Test
    public  void test() throws Exception{
        //1、读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2、创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3、使用工厂生产SqlSession对象
        SqlSession session = factory.openSession();
        //4、使用SqlSession创建Dao接口的代理对象
        UserDao userDao = session.getMapper(UserDao.class);
        //5、使用代理对象执行方法
        List<User> users = userDao.findAll();
        for (User user : users) {
            System.out.println(user);
        }
        //6、释放资源
        session.close();
        in.close();
    }
}

【运行测试】：发现如下异常问题出现：

### Error querying database. Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'com.winter.dao.UserDao.findAll'. It's likely that neither a Result Type nor a Result Map was specified.

我们在UserDao.xml里面写了sql查询语句，但是MyBatis不知道查询结果要封装到哪里去，所以要在UserDao.xml中对应提供另一个指定的对象类型，修正后的UserDao.xml如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.winter.dao.UserDao">
    <!--配置查询所有 -->
    <select id="findAll" resultType="com.winter.domain.User">
        select * from user
    </select>
</mapper>

再次运行测试OK：

【小插曲——调试问题】：开始MyBatisTest中使用public static void main(String[] args)方法测试，但是运行时始终报错：

Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.0.0:exec (default-cli) on project 19.mybatis: Command execution failed.

网上查找各种解决方法，如项目的java版本配置和JDK要一致等等，最后都没解决，怀疑是Maven支持的JDK版本问题，我的是14.0.1，最后通过junit解决，@Test注解运行就可以了。

2.2.2 入门案例设计模式分析

基于上述案例，分析下设计模式。

1）读取配置文件

不建议使用绝对路径，或相对路径，不够灵活，实际项目中多使用以下两种：

使用类加载器，它只能读取类路径的配置文件；
使用ServletContext对象的getRealPath()；

2）创建SqlSessionFactory工厂

MyBatis使用了构建者模式，把对象的创建细节隐藏，使用者直接调用方法即可获取对象。像我们自己盖厂房一样，不是事事亲为，我们找个包工队，告诉需求，给钱即可：

SqlSessionFactoryBuilder类似于包工队；
in类似于我们给的钱；

3）创建SqlSession对象

使用了工厂模式，降低了类之间的依赖关系

4）创建dao接口的代理对象

使用了代理模式，不修改源码的基础上对已有方法增强；

2.2.3 MaBatis基于注解的入门案例

以上基于xml的实现方式是不是感觉有些麻烦，映射配置文件有很多要对应的关系，下面来看下比较简单的方式，使用注解，相比于xml，主要改变在于：

移除UserDao.xml，在dao接口的方法上使用@Select注解，并且指定SQL语句；
在SqlMapConfig.xml中的mapper配置时，使用class属性指定dao接口的全限定类名。

【UserDao接口】：

public interface UserDao {
    @Select("select * from user")
    List<User> findAll();
}

【SqlMapConfig.xml中mapper配置】：

    <!--指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件
        若使用注解配置，应该使用class属性指定被注解的dao全限定类名
     -->
    <mappers>
        <mapper class="com.winter.dao.UserDao"></mapper>
    </mappers>

【注意】：实际MyBatis也是支持写dao实现类的，但是实际开发中追求的理念就是越简单越好，无论是xml还是注解形式，一般都是不写dao实现类。

———————————————————————————————————

本文为博主原创文章，转载请注明出处！