Mybatis快速入门

Mybatis

简介

中文文档:https://mybatis.org/mybatis-3/zh/index.html

什么是Mybatis?

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

持久化

数据持久化：就是将程序的数据在持久状态和瞬时状态转化的过程，持久化方式有：数据库(jdbc), io文件
持久化的意义:内存有断电即失的情况，有一些对象，需要长久存储。内存太贵。

持久层

完成持久化工作的代码块，如：Dao层、Service层、Controller层…他们的界限十分明显。

---

为什么需要Mybatis?

帮助程序员方便地将数据存储到数据库中，可以简化传统的JDBC代码。

优点

• 简单易学
• 灵活
• sql和代码的分离，提高了可维护性
• 提供映射标签，支持对象和数据库的orm字段关系映射
• 提供对象关系映射标签，支持对象关系组件维护
• 提供XML标签，支持动态编写sql
• 使用的多

---

如何获得Mybatis?

依赖

<dependency>
    <groupId>org.mybatisgroupId>
    <artifactId>mybatisartifactId>
    <version>3.5.13version>
dependency>

源码

Github中Mybatis源码：https://www.githubs.cn/projects/8205602-mybatis-3

---

第一个Mybatis程序

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

环境搭建

数据库准备

CREATE DATABASE `mybatis`;

USE `mybatis`;

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

INSERT INTO `user`(`id`, `name`, `pwd`)VALUES
(1, 'khan', '1234'),
(2, 'louis', '123'),
(3, 'Alex', '1234')

新建项目

1、创建一个maven项目，补充目录结构。

导入mybatis

2、导入相关依赖

<dependencies>
    <dependency>
        <groupId>junitgroupId>
        <artifactId>junitartifactId>
        <version>3.8.1version>
        <scope>testscope>
    dependency>
    <dependency>
        <groupId>mysqlgroupId>
        <artifactId>mysql-connector-javaartifactId>
        <version>8.0.32version>
    dependency>
    
    <dependency>
        <groupId>org.mybatisgroupId>
        <artifactId>mybatisartifactId>
        <version>3.5.13version>
    dependency>
dependencies>

编写程序

3、配置核心配置文件，命名为mybatis-config.xml

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&useUnicode=true&characterEncoding=UTF-8}"/>
                <property name="username" value="${root}"/>
                <property name="password" value="${zkpk}"/>
            dataSource>
        environment>
    environments>
    
    <mappers>
        <mapper resource="com/louis/dao/UserMapper.xml"/>
    mappers>
configuration>

4、编写mybatis工具类

package com.louis.utils;

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 java.io.IOException;
import java.io.InputStream;

/**
 * @author XRY
 * @date 2023年05月24日10:16
 */
public class MybatisUtils {
    private  static SqlSessionFactory sqlSessionFactory;
    static{
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
    //有了SqlSessionFactory,我们就可以从中获得SqlSession的实例
    //SqlSession完全包含了面向数据库执行sql命令所需要的所有方法
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

5、编写代码

①实体类

package com.louis.pojo;

/**
 * @author XRY
 * @date 2023年05月24日10:28
 */
public class User {
    private Integer id;
    private String name;
    private String pwd;

    public User() {
    }

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

    public Integer getId() {
        return id;
    }

    public void setId(Integer 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 + '\'' +
                '}';
    }
}

②dao层

//dao接口
package com.louis.dao;

import com.louis.pojo.User;

import java.util.List;

public interface UserDao {
    List<User> getUserList();
}

//dao接口实现类由原来的UserDaoImpl转为Mapper配置文件

DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.louis.dao.UserDao">

    <select id="getUserList" resultType="com.louis.pojo.User">
--id就相当于重写了原来的接口
        select * from mybatis.user;
    select>
mapper>

测试

6、测试

package com.louis.dao;

import com.louis.pojo.User;
import com.louis.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

/**
 * @author XRY
 * @date 2023年05月24日19:00
 */
public class UserDaoTest {
    @Test
    public void test(){
        //获得sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //执行sql
        //方式一：getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList = userDao.getUserList();
        //        List userList = sqlSession.selectList("com.louis.dao.UserDao.getUserList");
        for (User user : userList) {
            System.out.println(user);
        }
        //关闭sqlSession
        sqlSession.close();
    }
}

问题及解决方式

1、注意：在运行的时候如果出现UserMapper.xml找不到的情况，这是因为maven的过滤机制导致的，我们只需要在pom.xml文件中添加如下配置：

<build>
<resources>
    <resource>
        <directory>src/main/resourcesdirectory>
        <includes>
            <include>**/*.propertiesinclude>
            <include>**/*.xmlinclude>
        includes>
        <filtering>truefiltering>
    resource>
    <resource>
        <directory>src/main/javadirectory>
        <includes>
            <include>**/*.propertiesinclude>
            <include>**/*.xmlinclude>
        includes>
        <filtering>truefiltering>
    resource>
resources>
build>

2、如果出现ava.lang.ClassNotFoundException: Cannot find class: ${com.mysql.cj.jdbc.Driver}的错误可以将${}删除

命名空间(Namespaces)

在之前版本的 MyBatis 中，命名空间（Namespaces）的作用并不大，是可选的。 但现在，随着命名空间越发重要，你必须指定命名空间。

命名空间的作用

• 利用更长的全限定名来将不同的语句隔离开来。
• 实现了接口绑定。即使暂时用不到接口绑定，也应该遵循这里的规定，只要将命名空间置于合适的 Java 包命名空间之中，代码会变得更加整洁，也有利于你更方便地使用 MyBatis。

命名解析

为了减少输入量，MyBatis 对所有具有名称的配置元素（包括语句，结果映射，缓存等）使用了如下的命名解析规则。

全限定名（比如 “com.mypackage.MyMapper.selectAllThings）:将被直接用于查找及使用。
短名称（比如 “selectAllThings”）:如果全局唯一也可以作为一个单独的引用。 如果不唯一，有两个或两个以上的相同名称（比如 “com.foo.selectAllThings” 和 “com.bar.selectAllThings”），那么使用时就会产生“短名称不唯一”的错误，这种情况下就必须使用全限定名。