Mybatis 学习

1、什么是Mybatis?

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。
MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
MyBatis本是apache的一个开源项目iBatis，2010年这个项目由apache software foundation迁移到了google code，并且改名为MyBatis。2013年11月迁移到Github。

2、Mybatis的优点

简单易学
灵活
解除sql与程序代码的耦合
提供映射标签，支持对象与数据库的ORM字段关系映射
提供对象关系映射标签，支持对象关系组建维护
提供xml标签，支持编写动态sql

3、搭建Mybatis项目

思路：搭建环境-->导入Mybatis-->编写代码-->测试

3.1、搭建数据库

环境：Mysql5.7+SQLyog

命令行启动及登录：

net mysql start
mysql -u root -p

数据表创建及数据插入：

CREATE DATABASE Mybatis;

USE Mybatis;

CREATE TABLE `user`(
	`id` INT(20) NOT NULL,
	`name` VARCHAR(30) DEFAULT NULL,
	`pwd` VARCHAR(30) DEFAULT NULL,
	PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8;

INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'赵磊',123456),
(2,'张三',124563),
(3,'李四',128766)

数据库连接intellij idea

3.2、新建Maven项目

3.3、导入Mybatis相关包以及依赖

<!--导入依赖-->
  <dependencies>
          <!-- mybatis驱动 -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.5.2</version>
    </dependency>
      
    <!--mysql依赖-->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>8.0.25</version>
    </dependency>

	<!-- junit驱动 -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>

  </dependencies>

3.4、编写核心配置文件

查看Mybatis中文文档文档

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-config.dtd">
<!--核心配置-->
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;usseUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

3.5、查看帮助文档编写Mybatis工具类

public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static{
        try{
            //使用Mybatis的第一步：获取SqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        }
        catch(IOException e){
            e.printStackTrace();
        }
    }
    //既然有了SqlSessionFactory，我们就可以从中获取SqlSession的实例了。
    //SqlSession完全包含了面向数据库执行SQL命令所需的方法。
    public static SqlSession getSqlSession(){
        SqlSession sqlSession=sqlSessionFactory.openSession();
        return sqlSession;
    }
}

3.6、编写实体类

public class User {
    private int id;       //与数据库中的id名称一致
    private String name;    //与数据库中的name名称一致
    private String pwd;     //与数据库中的pwd名称一致

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = pwd;
    }

    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 getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }

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

3.7、编写Mapper接口

package com.zhaolei.dao;
import com.zhaolei.pojo.User;
import java.util.List;
public interface UserMapper {
    List<User> getUserList();
}

3.8、编写Mapper.xml文件

namespace十分重要，通过绑定com.zhaolei.dao.UserMapper，来实现Mapper接口，是一种映射关系，不能出错！！！

resultType返回类型要与id对应的方法的返回值类型一致

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

<mapper namespace="com.zhaolei.dao.UserMapper">
    <select id="getUserList" resultType="com.zhaolei.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

3.9、编写测试类

public class UserMapperTest {

    @Test
    public void test(){
        //第一步：获得SqlSession对象
        SqlSession sqlSession= MybatisUtils.getSqlSession();
		
        //第二步：获取数据库的内容
        UserMapper userMapper =sqlSession.getMapper(UserMapper.class);
        List<User> userList= userMapper.getUserList();

        for (User user : userList) {
            System.out.println(user);
        }
		// 关闭数据库
        sqlSession.close();

    }
}

3.10、遇见的问题

问题：

分析：是因为没有找到UserMapper.xml这个配置文件；原因是由于Maven他的约定大于配置，所以我们所写的配置文件，有可能无法被导出或者生效

解决方案：在pom.xml文件中加入，如下代码即可：

<!--在build中配置resources，来防止我们资源导出失败的问题-->
    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>false</filtering>
            </resource>
        </resources>
    </build>

再次刷新Maven，重新运行测试代码即可：

问题2：

分析：错误原因是少了slf4j-nop.jar slf4j-simple.jar， slf4j-log4j12.jar，slf4j-jdk14.jar或 logback-classic.jar中的其中一个jar包，加上去就行（只能是一个，多了就会有冲突）。

解决方案：

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>1.7.25</version>
  <scope>compile</scope>
</dependency>