Mybatis学习记录-01

一、框架概述

1. 什么是框架？

• 什么是框架
  框架（Framework）是整个或部分系统的可重用设计，表现为一组抽象构件及构件实例间交互的方法;另一种 定义认为，框架是可被应用开发者定制的应用骨架。前者是从应用方面而后者是从目的方面给出的定义。
• 框架要解决的问题
  框架要解决的最重要的一个问题是技术整合的问题。框架一般处在低层应用平台（如 J2EE）和高层业务逻辑之间的中间层。框架的重要性在于它实现了部分功能，并且能够很好的将低层应用平台和高层业务逻辑进行了缓和。
• 使用框架的好处
  框架封装了很多的细节，使开发者可以使用极简的方式实现功能,大大提高开发效率。

2. Mybatis框架概述

• MyBatis简介
  • mybatis是一个优秀的基于java的持久层框架，它内部封装了jdbc，使开发者只需要关注 sql语句本身， 而不需要花费精力去处理加载驱动、创建连接、创建 statement 等繁杂的过程。
  • mybatis通过xml 或注解的方式将要执行的各种statement配置起来，并通过java对象和statement 中 sql 的动态参数进行映射生成最终执行的 sql 语句，最后由 mybatis 框架执行 sql 并将结果映射为 java 对象并 返回。
  • 采用 ORM 思想解决了实体和数据库映射的问题，对 jdbc进行了封装，屏蔽了 jdbc api 底层访问细节，使我 们不用与 jdbc api 打交道，就可以完成对数据库的持久化操作。
• MyBatis的功能架构
  • API接口层：提供给外部使用的接口API，开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。
  • 数据处理层：负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。
  • 基础支撑层：负责最基础的功能支撑，包括连接管理、事务管理、配置加载和缓存处理，这些都是共用的东西，将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑。
• MyBatis的优缺点
  1. 优点：
     • 简单易学，灵活
     • 解除sql与程序代码的耦合
     • 提供xml标签，支持编写动态sql
  2. 缺点：
     • 编写sql语句时工作量大，尤其是字段多，关联表多时，更是如此。
     • sql语句依赖于数据库，导致数据库移植性差

二、快速入门

1. 开发准备

1.1. 创建maven工程并添加坐标

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

<?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>cn.hyz</groupId>
    <artifactId>Mybatis_day01_01</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <!-- 导入依赖 -->
    <dependencies>
        <!-- mybatis -->
        <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>
        <!-- JUnit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
        </dependency>
    </dependencies>
</project>

1.2. 创建数据库和表

-- 创建数据库
CREATE DATABASE IF NOT EXISTS mybatis CHARACTER SET utf8;
-- 创建数据表
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `id` int(11) NOT NULL auto_increment,
  `username` varchar(32) NOT NULL COMMENT '用户名称',
  `birthday` datetime default NULL COMMENT '生日',
  `sex` char(1) default NULL COMMENT '性别',
  `address` varchar(256) default NULL COMMENT '地址',
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-- 添加记录
insert  into `user`(`id`,`username`,`birthday`,`sex`,`address`) values (41,'老王','2018-02-27 17:47:08','男','北京'),(42,'小二王','2018-03-02 15:09:37','女','北京金燕龙'),(43,'小二王','2018-03-04 11:34:34','女','北京金燕龙'),(45,'传智播客','2018-03-04 12:04:06','男','北京金燕龙'),(46,'老王','2018-03-07 17:37:26','男','北京'),(48,'小马宝莉','2018-03-08 11:44:00','女','北京修正');

1.3. 创建实体类(实体类属性名和数据库字段名保持一致)

import java.io.Serializable;
import java.util.Date;

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 + '\'' +
                '}';
    }
}

1.4. 创建实体类的持久层接口(mapper或dao)

public interface UserDao {
    /**
     * 查询所有
     * @return
     */
    List<User> findAll();
}

1.5. 编写接口映射文件(UserMapper.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="cn.hyz.dao.UserDao">

    <!-- 配置查询所有 -->
    <select id="findAll" resultType="cn.hyz.domain.User">
        select * from user
    </select>
</mapper>

1.6. 编写Mybatis主配置文件(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">
<!-- mybatis的主配置文件 -->
<configuration>
    <!-- 配置环境 -->
    <environments default="mysql">
        <!-- 配置mysql的环境 -->
        <environment id="mysql">
            <!-- 配置事务类型 -->
            <transactionManager type="JDBC"/>
            <!-- 配置数据源(连接池) -->
            <dataSource type="POOLED">
                <!-- 配置连接数据库的4个基本信息 -->
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="数据库密码"/>
            </dataSource>
        </environment>
    </environments>
<!-- 指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件 -->
    <mappers>
        <mapper resource="cn/hyz/dao/UserDao.xml"/>
    </mappers>
</configuration>

1.7.测试

编写一个Mybatis的测试类，测试上述查询所有的方法，这里直接使用main方法测试：

• 第一步：读取配置文件
• 第二步：创建SqlSessionFactory工厂
• 第三步：创建SqlSession
• 第四步：创建Dao接口的代理对象
• 第五步：执行dao中的方法
• 第六步：释放资源

/**
 * 查询所有，入门案例
 */
public class MybatisTest {
    /**
     * 查询所有
     * @param args
     */
    public static void main(String[] args) 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();
    }
}

• 特别注意:
  • Mybatis中，持久层的接口类名称和映射文件叫Mapper，所以UserMapper和UserDao一样。
  • 映射配置文件的mapper标签namespace属性的取值必须是mapper接口的全限定类名。
  • 映射配置文件的操作配置，id属性的取值必须是mapper接口的方法名。

3. 基于注解的方法

• mybatis基于注解的入门案例
  把IUserDao.xml移除，在dao接口的方法上使用@Select注解，并且指定SQL语句。同时需要在SqlMapConfig.xml中的mapper配置时，使用class属性指定dao接口的全限定类名

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

/**
 * 用户持久层接口
 */
public interface UserDao {
    /**
     * 查询所有
     * @return
     */
     @Select("select * from user")
    List<User> findAll();
}

3.2. 修改SqlMapConfig.xml

<!-- 告知 mybatis 映射配置的位置 -->
<mappers>
<mapper class="com.itheima.dao.UserDao"/>
</mappers>

• 特别注意：
  • 在使用基于注解的Mybatis时，请移除xml的映射配置(UserDao.xml) 。

3.3. 测试类代码分析

四、注意事项

• 搭建环境时
  1. 创建IUserDao.xml 和 IUserDao.java时名称是为了和我们之前的知识保持一致。在Mybatis中它把持久层的操作接口名称和映射文件也叫做：Mapper。所以：IUserDao 和 IUserMapper是一样的
  2. mybatis的映射配置文件位置必须和dao接口的包结构相同
  3. 映射配置文件的mapper标签namespace属性的取值必须是dao接口的全限定类名
• 在测试代码中
  1. 不要忘记在映射配置中告知MyBatis要封装到哪个实体类中
  2. 配置的方式：指定实体类的全限定类名