Mybatis01-初识Mybatis

一、简介

1. 什么是Mybatis?
   MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

2. Mybatis框架
   1、在我们学习Java基础的时候我们那时候学的是通过jdbc来操作数据库，但是操作的代码是否的繁琐，不利于现实的开发。dbutils虽然进一步把jdbc进行了封装，但是进行数据库操作时还是不是太利于实际开发，也就是开发效率还不够高，也就是说它实际上还是一个工具类并不是一个框架。
   2、Mybatis框架就是把我们以前的数据库底层操作都进行了封装，让我们从繁琐的底层代码中解脱出来。让我们在dao层进行数据库操作时只要专注于sql语句的编写，从而大大节省了开发时间，减少了开发成本。

二、Mybatis环境配置

1. 导入依赖

• 导入mysql的驱动，这是在进行数据库操作的时候必须要导入的依赖。

 <!--mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>

• 导入Mybatis的依赖

<!--Mybatis-->
<dependency>
     <groupId>org.mybatis</groupId>
     <artifactId>mybatis</artifactId>
     <version>3.5.2</version>
 </dependency>

• 配置防止Maven把一些必要的配置文件进行过滤掉，如果不配置的话就有可能会出现无法读取到某些配置文件的情况。

<!--在父工程或者每个子模块的pom.xml配置文件中添加以下配置 。-->
    <build>
        <!--配置打包时不过滤非java文件开始  -->
        <!--说明，在进行模块化开发打jar包时，maven会将非java文件过滤掉，
        xml,properties配置文件等，但是这些文件又是必需的，
        使用此配置可以在打包时将不会过滤这些必需的配置文件。
        -->
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
        <!--配置打包时不过滤非java文件结束 -->
    </build>

2、Mybatis主配置文件

• nvironment 元素体中包含了事务管理和连接池的配置。其中定义事务管理的标签是transactionManager，一般事务管理的方式我们都会设置为JDBC，从这里可以看出，其实Mybatis的实质还是JDBC。定义连接池的标签为dataSource，可以根据实际需求定义不同的连接池方式。

environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <!--需要在url中设置时区，否则会报时区错误-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;ueUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=GMT%2B8" />
                <property name="username" value="root"/>
                <property name="password" value="989617"/>
            </dataSource>
        </environment>
    </environments>

• mappers 元素则包含了一组映射器（mapper），这些映射器的 XML 映射文件包含了 SQL 代码和映射定义信息。

 <!--每一个mapper都需要在核心配置文件中进行注册-->
    <!--方式一（推荐使用）-->
   <!-- <mappers>
        <mapper resource="com\my\domain\UserMapper.xml"/>
    </mappers>-->
    <!--
    方式二：使用class文件绑定注册
    每一个Mapper.XML都需要在Mybatis核心配置文件中注册！-->
    <mappers>
        <mapper class="com.my.dao.UserMapper"/>
    </mappers>
    <!--注意点：
    - 接口和他的Mapper配置文件必须同名！
    - 接口和他的Mapper配置文件必须在同一个包下！-->
    <!--方式三：使用扫描包进行注入绑定
    每一个Mapper.XML都需要在Mybatis核心配置文件中注册！
    <mappers>
        <package name="com.kuang.dao"/>
    </mappers>
    注意点：
    - 接口和他的Mapper配置文件必须同名！
    - 接口和他的Mapper配置文件必须在同一个包下！
    -->

3、Mybatis的Mapper文件配置

• 注意：mapper标签的namespace绑定一个对应的Dao/Mapper接口的全类名。

<?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">
<!--namespace绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.my.dao.UserMapper">

    <select id="findAll" resultType="com.my.pojo.User">
        select * from m_user
    </select>

</mapper>

4、实体类

• 注意：实体类中的属性一定要对应相应的表中的列名一致。否则将无法进行自动注入。

package com.my.pojo;


public class User {

    private int id;
    private String name;
    private String psd;

    public int getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPsd() {
        return psd;
    }

    public void setPsd(String psd) {
        this.psd = psd;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", psd='" + psd + '\'' +
                '}';
    }
}

5、dao层接口

package com.my.dao;

import com.my.pojo.User;

import java.util.List;

public interface UserMapper {

    List<User> findAll();
}

• 到这Mybatis的基本配置就已经完成了，现在来写一个测试类进行测试。

三、测试

• 首先要读取主配置文件

 //1、读取配置文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

• 创建SqlSessionFactory工厂，通过SqlSessionFactoryBuilder这个类进行创建 SqlSessionFactory工厂，这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。

//2、创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        SqlSessionFactory build = sqlSessionFactoryBuilder.build(is);

• 使用工厂生产sqlsession对象

 //3、使用工厂生产sqlsession对象
        SqlSession sqlSession = build.openSession();

• 使用sqlsession创建dao接口的代理对象

 //4、使用sqlsession创建dao接口的代理对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

• 使用代理对象执行方法

//5、使用代理对象执行方法
        List<User> all = mapper.findAll();
        for (User user:all) {
            System.out.println(user);
        }

• 释放资源，每次运行完都要记得释放资源，这是一个好习惯，避免造成资源浪费。

//6、释放资源
        sqlSession.close();
        is.close();

• 完整代码

@Test
    public void test01() throws IOException {
        //1、读取配置文件
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        //2、创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        SqlSessionFactory build = sqlSessionFactoryBuilder.build(is);
        //3、使用工厂生产sqlsession对象
        SqlSession sqlSession = build.openSession();
        //4、使用sqlsession创建dao接口的代理对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //5、使用代理对象执行方法
        List<User> all = mapper.findAll();
        for (User user:all) {
            System.out.println(user);
        }
        //6、释放资源
        sqlSession.close();
        is.close();
    }

• 测试结果

log4j:WARN No appenders could be found for logger (org.apache.ibatis.logging.LogFactory).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
User{id=1, name='张三', psd='123'}
User{id=2, name='李四', psd='123'}
User{id=3, name='李四', psd='123'}
User{id=4, name='李四', psd='123'}
User{id=5, name='李四', psd='123'}
User{id=8, name='张三', psd='888'}