什么是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。
  • iBATIS一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects(DAOs)。

如何获取mybatis

maven

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.11</version>
</dependency>

maven

github

github

持久化

数据持久化就是将内存中的数据模型转换为存储模型,以及将存储模型转换为内存中的数据模型的统称. 数据模型可以是任何数据结构或对象模型,存储模型可以是关系模型、XML、二进制流等。cmp和Hibernate只是对象模型到关系模型之间转换的不同实现。

持久化(Persistence),即把数据(如内存中的对象)保存到可永久保存的存储设备中(如磁盘)。持久化的主要应用是将内存中的对象存储在数据库中,或者存储在磁盘文件中、XML数据文件中等等。

持久化是将程序数据在持久状态和瞬时状态间转换的机制。

JDBC就是一种持久化机制。文件IO也是一种持久化机制。

持久层 (POJO)

Dao层,Service层,Controller层。。。

持久层的工作:就是把数据或者信息保存到存储设备中.

持久层的意义:把操作存储备的工作封装起来以便于代码的复用.

持久化的主要的应用是将内存中的对象存储在关系的数据库中或者存储在磁盘中.XML数据文件汇总.

所谓的持久层就是把数据可以永久保持的存储到设备中,不像放到内存中那样断电就消失,一般来说,持久层为直接的理解就是对数据库的各种操作,如CRUD(增加,删除,修改,查询),更新等操作

持久层,就是把持久的动作封装成一个独立的层,这是为了降低功能代码之间的关联.创建一个更清晰的抽象,提高代码的内聚力,降低代码的耦合度,提高可维护性和复用性.

Mybatis 架构图

架构图

特点:

  • 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件。易于学习,易于使用。通过文档和源代码,可以比较完全的掌握它的设计思路和实现。

  • 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。

  • 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。

  • 提供映射标签,支持对象与数据库的ORM字段关系映射。

  • 提供对象关系映射标签,支持对象关系组建维护。

  • 提供xml标签,支持编写动态sql。

第一个mybatis 程序

创建maven项目 引入dependency

<?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>com.depressiom</groupId>
    <artifactId>mybatis_01</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>

    <dependencies>
        <!-- https://mvnrepository.com/artifact/junit/junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>

        <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.31</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.11</version>
        </dependency>

    </dependencies>
</project>

从 XML 中构建 SqlSessionFactory --> mybatis-config.xml

<?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">
    <!--    development开发环境 可多个环境   -->
        <environment id="development">
            <!--     事务管理       -->
            <transactionManager type="JDBC"/>
            <!--     数据库相关的       -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <!-- useSSL=true 安全链接   useUnicode=true Unicode码  &amp; 转义 & 多个参数    -->
                <property name="url" value="jdbc:mysql://localhost:3306/blog?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
<!--  每一个mapper 都需要在mybatis核心配置文件中注册  -->
    <mappers>
        <mapper resource="com/depressiom/Dao/BlogAdminMapper.xml"/>
    </mappers>
</configuration>

创建mybatis工具类

package com.depressiom.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;

/**
 * @ClassName MybatisUtils
 * @Description mybatis工具类
 * @Date 2022/11/28
 * @Author depressiom
 */
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        // 获取SqlSession
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
     * SqlSession 提供了在数据库执行 SQL 命令所需的所有方法
     */
    private static SqlSession getsqlSession(){
        return sqlSessionFactory.openSession();
    }
}

mybatis实体类

package com.depressiom.Pojo;

/**
 * @ClassName BlogAdmin
 * @Description 实体类
 * @Date 2022/11/28
 * @Author depressiom
 */
public class BlogAdmin {
    private int id;
    private String name;
    private String  password;

    public BlogAdmin() {
    }

    public BlogAdmin(int id, String name, String password) {
        this.id = id;
        this.name = name;
        this.password = password;
    }

    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 getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

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

mybatis 实体操作接口

package com.depressiom.Dao;

import com.depressiom.Pojo.BlogAdmin;

import java.util.List;

/**
 * @ClassName BlogAdminDao
 * @Description 实体操作接口
 * @Date 2022/11/28
 * @Author depressiom
 */
public interface BlogAdminDao {
    List<BlogAdmin> getAdminList();
}

MyBatis 提供的所有特性都可以利用基于 XML 的映射语言来实现 Mapper

<?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">
<!--namespace=》会绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.depressiom.Dao.BlogAdminDao">
    <!-- select查询,id对应方法名称   -->
    <select id="getAdminList" resultType="com.depressiom.Pojo.BlogAdmin">
        select * from mybatis.blog_admin
    </select>
</mapper>

junit 测试

package com.depressiom.Dao;

import com.depressiom.Pojo.BlogAdmin;
import com.depressiom.Utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

/**
 * @ClassName BlogAdminDaoTest
 * @Description 测试
 * @Date 2022/11/28
 * @Author depressiom
 */
public class BlogAdminDaoTest {
    @Test
    public void test(){
        // 1. 获取 SqlSession 对象
        SqlSession sqlSession = MybatisUtils.getsqlSession();

        // 2. 执行SQL 方式一 getMapper
        // 2.1 通过类对象获取mappler
        //BlogAdminDao adminDao =  sqlSession.getMapper(BlogAdminDao.class);
        //List<BlogAdmin> adminList = adminDao.getAdminList();

        // 3.方式二
        List<BlogAdmin> adminList = sqlSession.selectList("com.depressiom.Dao.BlogAdminDao.getAdminList");

        for (BlogAdmin blogAdmin : adminList) {
            System.out.println(blogAdmin);
        }

        // 3. 关闭SqlSession
        sqlSession.close();
    }
}


报错1 Type interface com.depressiom.Dao.BlogAdminDao is not known to the MapperRegistry.

报错

解决方案:

mybatis 核心配置文件进行mapper注册

<!--  每一个mapper 都需要在mybatis核心配置文件中注册  -->
    <mappers>
        <mapper resource="com/depressiom/Dao/BlogAdminMapper.xml"/>
    </mappers>

报错2 maven文件过滤 The error may exist in com/depressiom/Dao/BlogAdminMapper.xml

报错2

<!-- 解决Maven资源失败问题   -->
    <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>true</filtering>
            </resource>
        </resources>
    </build>

报错3 获取 SqlSession 对象 不能获取,测试失败

报错3

解决方案:

经过各种排查之后,mapper.xml 因为注释带中文导致报错

<?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.depressiom.Dao.BlogAdminDao">
    <select id="getAdminList" resultType="com.depressiom.Pojo.BlogAdmin">
        select * from blog_admin
    </select>
</mapper>

运行成功

运行成功

增删改需要提交事务

BlogAdminMapper.java

package com.depressiom.Dao;

import com.depressiom.Pojo.BlogAdmin;

import java.util.List;

/**
 * @ClassName BlogAdminMapper
 * @Description 实体操作接口
 * @Date 2022/11/28
 * @Author depressiom
 */
public interface BlogAdminMapper {
    List<BlogAdmin> getAdminList();
    // 根据id查询
    BlogAdmin getAdminId(int id);

    //insert into
    int addBlogAdmin(BlogAdmin admin);
}

BlogAdminMapper.xml

<?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.depressiom.Dao.BlogAdminMapper">
    <select id="getAdminList" resultType="com.depressiom.Pojo.BlogAdmin">
        select * from blog_admin
    </select>

    <select id="getAdminId" parameterType="int" resultType="com.depressiom.Pojo.BlogAdmin">
        select * from blog_admin where id = #{id}
    </select>
    <!-- Properties of the object type can be retrieved directly 对象类型的属性可以直接取出来-->
    <insert id="addBlogAdmin" parameterType="com.depressiom.Pojo.BlogAdmin">
        insert into blog_admin (id,name,password) value (#{id},#{name},#{password});
    </insert>
</mapper>

BlogAdminMapperTest.java

package com.depressiom.Dao;

import com.depressiom.Pojo.BlogAdmin;
import com.depressiom.Utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

/**
 * @ClassName BlogAdminMapperTest
 * @Description 测试
 * @Date 2022/11/28
 * @Author depressiom
 */
public class BlogAdminMapperTest {
    @Test
    public void test(){
        // 1. 获取 SqlSession 对象
        SqlSession sqlSession = MybatisUtils.getsqlSession();

        // 2. 执行SQL 方式一 getMapper
        // 2.1 通过类对象获取mappler
        //BlogAdminMapper adminDao =  sqlSession.getMapper(BlogAdminMapper.class);
        //List<BlogAdmin> adminList = adminDao.getAdminList();

        // 3.方式二
        List<BlogAdmin> adminList = sqlSession.selectList("com.depressiom.Dao.BlogAdminMapper.getAdminList");

        for (BlogAdmin blogAdmin : adminList) {
            System.out.println(blogAdmin);
        }

        // 3. 关闭SqlSession
        sqlSession.close();
    }

    @Test
    public void TestgetAdminid(){
        // 1. 获取 SqlSession 对象
        SqlSession sqlSession = MybatisUtils.getsqlSession();
        BlogAdminMapper mapper =  sqlSession.getMapper(BlogAdminMapper.class);
        BlogAdmin admin = mapper.getAdminId(1);
        System.out.println(admin);
        // 3. 关闭SqlSession
        sqlSession.close();
    }

    @Test
    /**
     * 增删改 需要进行提交事务
     */
    public void addBlogAdmin(){
        // 1. 获取 SqlSession 对象
        SqlSession sqlSession = MybatisUtils.getsqlSession();
        BlogAdminMapper mapper =  sqlSession.getMapper(BlogAdminMapper.class);
        int res = mapper.addBlogAdmin(new BlogAdmin(3,"depressiom","123456"));
        if(res > 0){
            System.out.println("插入成功");
        }
        sqlSession.commit();
        // 3. 关闭SqlSession
        sqlSession.close();
    }
}

增

posted on 2022-11-24 15:11  depressiom  阅读(22)  评论(0编辑  收藏  举报