MyBatis框架

0.学习目标

了解框架
框架能解决的问题
熟悉软件开发模式分层
MyBatis框架的基础使用(基于XML,基于注解)

1.什么是框架

框架（Framework）是整个或部分系统的可重用设计，表现为一组抽象构件及构件实例间交互的方法;另一种定义认为，框架是可被应用开发者定制的应用骨架。前者是从应用方面而后者是从目的方面给出的定义。简而言之，框架其实就是某种应用的半成品，就是一组组件，供你选用完成你自己的系统。简单说就是使用别人搭好的舞台，你来做表演。而且，框架一般是成熟的，不断升级的软件。

1.1 框架要解决的问题

框架要解决的最重要的一个问题是技术整合的问题，在J2EE的框架中，有着各种各样的技术，不同的软件企业需要从J2EE中选择不同的技术，这就使得软件企业最终的应用依赖于这些技术，技术自身的复杂性和技术风险性将会直接对应用造成冲击。而应用是软件企业的核心，是竞争力的关键所在，因此应该将应用自身的设计和具体的实现技术解耦。这样，软件企业的研发将集中在应用的设计上，而不是具体的技术实现，技术实现是应用的底层支撑，它不应该直接对应用产生影响。

框架一般处在低层应用平台（如 J2EE）和高层业务逻辑之间的中间层。

1.2 软件开发的分层重要性

框架的重要性在于它实现了部分功能，并且能够很好的将低层应用平台和高层业务逻辑进行了缓和。为了实现软件工程中的“高内聚、低耦合”。把问题划分开来各个解决，易于控制，易于延展，易于分配资源。我们常见的 MVC 软件设计思想就是很好的分层思想。

通过分层更好的实现了各个部分的职责，在每一层将再细化出不同的框架，分别解决各层关注的问题。

1.2.1 分层开发下的常见框架

常见的JavaEE开发框架：

解决数据的持久化问题的框架
作为持久层的框架，还有一个封装程度更高的框架就是Hibernate，但这个框架因为各种原因目前在国内的流行程度下降太多，现在公司开发也越来越少使用。目前使用 Spring Data 来实现数据持久化也是一种趋势。
解决Web层问题的MVC框架
解决技术整合问题的框架
## 1.3 MyBatis框架概述

mybatis 是一个优秀的基于 java 的持久层框架，它内部封装了 jdbc，使开发者只需要关注 sql 语句本身，而不需要花费精力去处理加载驱动、创建连接、创建 statement 等繁杂的过程。

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

采用 ORM(对象关系映射) 思想解决了实体和数据库映射的问题，对 jdbc 进行了封装，屏蔽了 jdbc api 底层访问细节，使我们不用与 jdbc api 打交道，就可以完成对数据库的持久化操作。为了我们能够更好掌握框架运行的内部过程，并且有更好的体验，下面我们将从自定义 Mybatis 框架开始来学习框架。此时我们将会体验框架从无到有的过程体验，也能够很好的综合前面阶段所学的基础。

1.3.1 jdbc原生代码的回顾

public static void main(String[] args) {
   
        Connection connection = null;
        PreparedStatement preparedStatement = null;
        ResultSet resultSet = null;
        try {
   
            //加载数据库驱动
            Class.forName("com.mysql.jdbc.Driver");
            //通过驱动管理类获取数据库链接
            connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "root");
            //定义 sql 语句 ?表示占位符
            String sql = "select * from user where username = ?";
            //获取预处理 statement
            preparedStatement = connection.prepareStatement(sql);
            //设置参数，第一个参数为 sql 语句中参数的序号（从 1 开始），第二个参数为设置的参数值
            preparedStatement.setString(1, "王五");
            //向数据库发出 sql 执行查询，查询出结果集
            resultSet = preparedStatement.executeQuery();
            //遍历查询结果集
            while (resultSet.next()) {
   
                System.out.println(resultSet.getString("id") +resultSet.getString("username"));
            }

        } catch (Exception e) {
   
            e.printStackTrace();
        } finally {
   
            //释放资源
            if (resultSet != null) {
   
                try {
   
                    resultSet.close();
                } catch (SQLException e) {
   
                    e.printStackTrace();
                }
            }
            if (preparedStatement != null) {
   
                try {
   
                    preparedStatement.close();
                } catch (SQLException e) {
   
                    e.printStackTrace();
                }
            }
            if (connection != null) {
   
                try {
   
                    connection.close();
                } catch (SQLException e) {
   
                    // TODO Auto-generated catch block
                    e.printStackTrace();
                }
            }
        }
    }

我们之前使用上述jdbc原始方法(未经封装)实现的查询数据库表记录的操作。

那么使用上述的方式作为数据库的访问，会出现哪些问题呢？

1.3.2 jdbc问题分析

数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库链接池可解决此问题。
Sql 语句在代码中硬编码，造成代码不易维护，实际应用 sql 变化的可能较大，sql 变动需要改变 java 代码。
使用 preparedStatement 向占位符号传参数存在硬编码，因为 sql 语句的 where 条件不一定，可能多也可能少，修改 sql 还要修改代码，系统不易维护。
对结果集解析存在硬编码（查询列名），sql 变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成 pojo 对象解析比较方便。

2. MyBatis框架快速入门【一】(基于XML)

通过之前的一个阶段性学习，现在我们已经有了扎实的Java基础

那么下面就来动手操作，体验一下MyBatis的魅力

2.1 搭建MyBatis环境

2.1.1 创建Maven工程

创建mybatis01的工程，工程信息如下

Groupid:com.bianyi

ArtifactId:mybatis01

Packing:jar

2.1.2 添加maven坐标

在 pom.xml 文件中添加 Mybatis3.4.5 的坐标，如下：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.10</version>
        <scope>test</scope>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
        <scope>runtime</scope>
    </dependency>
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.12</version>
    </dependency>
</dependencies>

2.1.3 编写User实体类

/** * * <p>Title: User</p> * <p>Description: 用户的实体类</p> */
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 + "]";
    }
}

2.1.4 编写持久层接口 IUserDao

IUserDao 接口就是我们的持久层接口（也可以写成 UserDao 或者 UserMapper）,具体代码如下：

/** * * <p>Title: IUserDao</p> * <p>Description: 用户的持久层操作</p> */
public interface IUserDao {
   
    /** * 查询所有用户 * @return */
    List<User> findAll();
}

2.1.5 编写持久层接口的映射文件 IUserDao.xml

要求：

创建位置：必须和持久层接口在相同的包中。

名称：必须以持久层接口命名文件名，扩展名是.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.bianyi.dao.IUserDao">
    <!-- 配置查询所有操作 -->
    <select id="findAll" resultType="com.bianyi.domain.User">
    select * from user
    </select>
</mapper>

2.1.6 编写SqlMapConfig.xml配置文件

<?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">
<configuration>
    <!-- 配置 mybatis 的环境 -->
    <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/test"/>
                <property name="username" value="root"/>
                <property name="password" value="1234"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 告知 mybatis 映射配置的位置 -->
    <mappers>
    	<mapper resource="com/bianyi/dao/IUserDao.xml"/>
    </mappers>
</configuration>

2.1.7 编写测试类

/** * * <p>Title: MybatisTest</p> * <p>Description: 测试 mybatis 的环境</p> */
public class MybatisTest {
   
	public static void main(String[] args)throws Exception {
   
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建 SqlSessionFactory 的构建者对象
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        //3.使用构建者创建工厂对象 SqlSessionFactory
        SqlSessionFactory factory = builder.build(in);
        //4.使用 SqlSessionFactory 生产 SqlSession 对象
        SqlSession session = factory.openSession();
        //5.使用 SqlSession 创建 dao 接口的代理对象
        IUserDao userDao = session.getMapper(IUserDao.class);
        //6.使用代理对象执行查询所有方法
        List<User> users = userDao.findAll();
        for(User user : users) {
   
        System.out.println(user);
        }
        //7.释放资源
        session.close();
        in.close();
    }
}

2.2 小结

通过快速入门示例，我们发现使用 mybatis 是非常容易的一件事情，因为只需要编写 Dao 接口并且按照 mybatis 要求编写两个配置文件，就可以实现功能。远比我们之前的 jdbc 方便多了。（我们使用注解之后，将变得更为简单，只需要编写一个 mybatis 配置文件就够了。）

但是，这里面包含了许多细节，比如为什么会有工厂对象（SqlSessionFactory）,为什么有了工厂之后还要有构建者对象（SqlSessionFactoryBuilder），为什么 IUserDao.xml 在创建时有位置和文件名的要求等等。

3. MyBatis框架快速入门【二】(基于注解)

3.1 在持久层接口中添加注解

基于注解的方式，我们使用上一个工程进行改造

同样是创建一个工程