MyBatis的入门

1、Mybatis的简介和特性

2、环境配置及其注意事项

2.1、注意事项

本文示例，开发环境

IDE：idea 2019.2

构建工具：maven 3.8.6

 MySQL版本：MySQL 8

MyBatis版本：MyBatis 3.5.7

MySQL不同版本的注意事项：

1、驱动类driver-class-name

MySQL 5版本使用jdbc5驱动，驱动类使用：com.mysql.jdbc.Driver

MySQL 8版本使用jdbc8驱动，驱动类使用：com.mysql.cj.jdbc.Driver

2  连接地址url

MySQL 5版本的url： jdbc:mysql://localhost:3306/ssm

MySQL 8版本的url：jdbc:mysql://localhost:3306/ssm?characterEncoding=utf8&useSSL=false&serverTimezone=UTC&rewriteBatchedStatements=true

ps 这里有个小插曲：最近在折腾虚拟机的时候，关闭了很多服务（守护进程）的开机自启动，我本地的mysql80服务也被禁用了，

于是我用客户端工具连接的时候，报了一个 2003 连接不上的错误。这里打开windows服务管理，把mysql80服务启动就好了

2.2 Mybaits 环境搭建步骤

1）创建Maven工程

2）引入依赖文件 

参考连接： https://mvnrepository.com/

pom中引入mybatis依赖

    org.mybatis
    mybatis
    3.5.7

引入mysql 连接驱动 （根据自己的数据库版本，选择合适的驱动版本）

这里注意一下，新的驱动依赖 maven gav坐标内容与旧版本的有所变动，别写错了

    com.mysql
    mysql-connector-j
    8.0.31

3）创建mybatis 核心配置文件

关于配置文件 ，mapper.xml （映射文件）的书写 具体 我们可以参考官网，还支持中文翻译：

mybatis – MyBatis 3 | 简介

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring 之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息 核心配置文件存放的位置是src/main/resources目录下。

4）创建mapper接口

我们在用原生的JDBC 实现数据库与业务代码交互的时候，用到一个ORM 设计理念，即对象关系映射 。

对象：Java的实体类对象

关系：关系型数据库

映射：二者之间的对应关系

ORM的核心 是为了解决 软件设计是面向对象的，而关系型数据库是一个数学概念，ORM可以将两者原本不匹配的思想进行中继，统一。

简单来说，就是将关系数据库的表，转换成开发过程中，更容易理解、处理的对象，（有时我们也将表中查出的信息，封装成一个对象，或JSON）

mybatis也是ORM框架，它的工作机制也是依赖于此。

MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要 提供实现类。

public interface UserMapper {

    /**
     * 添加用户信息
     */
    int insertUser();
}

5）创建映射文件

1、映射文件的命名规则： 表所对应的实体类的类名+Mapper.xml

例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml

因此一个映射文件对应一个实体类，对应一张表的操作

MyBatis映射文件用于编写SQL，访问以及操作表中的数据 MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2、 MyBatis中可以面向接口操作数据，要保证两个一致：

a、mapper接口的全类名和映射文件的命名空间（namespace）保持一致

b、mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

具体如下图：

    
        insert into t_user values(null,'admin','123456',23,'男','[email protected]')
    

6）通过Junit 进行测试

在官网的入门案例中，我们能看到如下描述：mybatis – MyBatis 3 | 入门

从 XML 中构建 SqlSessionFactory
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。

从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。 但也可以使用任意的输入流（InputStream）实例，比如用文件路径字符串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类，它包含一些实用方法，使得从类路径或其它位置加载资源文件更加容易。

我们照葫芦画瓢：

import com.alex.mybatis.mapper.UserMapper;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;

/**
 * @Title:
 * @Description: TODO
 * @author: Alex
 * @Version:
 * @date 2023-01-24-22:24
 */
public class MbTest {

    @Test
    public  void test1(){
        InputStream is=null;
        try {
            //读取MyBatis的核心配置文件
             is = Resources.getResourceAsStream("mybatis-config.xml"); //mybatis-config.xml
            //创建SqlSessionFactoryBuilder对象
            //通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory，生产SqlSession对象
            SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
            //创建SqlSession对象，此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
            //SqlSession sqlSession = sqlSessionFactory.openSession();
            //创建SqlSession对象，此时通过SqlSession对象所操作的sql都会自动提交
            SqlSession sqlSession = sessionFactory.openSession(true);
            //通过代理模式创建UserMapper接口的代理实现类对象
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            //调用UserMapper接口中的方法，就可以根据UserMapper的全类名匹配元素文件，通过调用的方法名匹配
           // 映射文件中的SQL标签，并执行标签中的SQL语句
            int result = mapper.insertUser();
            //sqlSession.commit();

            System.out.println("数据库中 "+result+" 行 改动");
        } catch (IOException e) {
            throw new RuntimeException(e);
        }finally {
            //不用执行 sqlsession 关闭，
            try {
                if(is!=null){
                    is.close(); 
                }
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
    }
}

关于sqlSession关闭的情况 请看这篇文章：http://t.csdn.cn/RmWot

SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的 会话） SqlSessionFactory：是“生产”SqlSession的“工厂”。

工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象。

注意事项：

1）pom文件打包方式 不能写成 pom 

jar

原因：maven打包方式有三种，pom，jar和war。当选择了打包方式为pom时，意味着该工程是个聚合工程，而这个工程也就是个父工程，只用来做依赖版本管理和模块管理，并不会涉及到源码，所以maven不会将resources下的文件编译到classes路径下。所以将打包方式换成jar，才能编译成功！

2）mybatis-config.xml配置文件 要注意mapper映射的书写，注意引入单个和引入一个包的标签是不一样的。

3）Sql 语法一定要写对

打印结果：

查看数据库变化：

代码地址: GitHub - Chai-Feng/git-demo01