Mybatis从入门到精通系列 01 —— 快速入门

偏执的太偏执、 2023-10-11 15:32 42阅读 0赞

本文是 mybatis 从入门到精通系列的第一篇，本文将讲解 mybatis 概述、传统jdbc中存在的问题以及基础入门案例的搭建。

![在这里插入图片描述][20210413143119930.png_pic_center]

--------------------

#### 文章目录 ####

*   *  一、Mybatis概述
     *  二、传统 jdbc 回顾与问题分析
     *  三、Mybaits 入门案例
     *   *  3.1 环境搭建
         *  3.2 入门案例编写
     *  四、注意事项

--------------------

### 一、Mybatis概述 ###

mybaits 是一个持久层框架，用 java 编写的，它封装了 jdbc 操作的很多细节，使开发者 **只需要关注sql语句** 的本身，而无需关注注册驱动，创建链接等繁杂过程。  
  mybatis 通过 xml 或注解的方式将要执行的各种 statement 配置起来，并通过 java 对象和 statement 中 sql 的动态参数进行映射生成最终执行的 sql 语句，最后由 mybatis 框架执行 sql 并将结果映射为 java 对象并返回。

采用 **ORM** 思想解决了实体和数据库映射的问题，对 jdbc 进行了封装，屏蔽了 jdbc api 底层访问细节，使我们不用与 jdbc api 打交道，就可以完成对数据库的持久化操作。

--------------------

### 二、传统 jdbc 回顾与问题分析 ###

传统 jdbc 回顾：

public static void main(String[] args) {
        
            Connection connection = null;
            PreparedStatement preparedStatement = null;
            ResultSet resultSet = null;
            try {
        
                //加载数据库驱动
                Class.forName("com.mysql.jdbc.Driver");
                //通过驱动管理类获取数据库链接
                connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8","root", "root");
                //定义 sql 语句 ?表示占位符
                String sql = "select * from user where username = ?";
                //获取预处理 statement
                preparedStatement = connection.prepareStatement(sql);
                //设置参数，第一个参数为 sql 语句中参数的序号（从 1 开始），第二个参数为设置的参数值
                preparedStatement.setString(1, "王五");
                //向数据库发出 sql 执行查询，查询出结果集
                resultSet = preparedStatement.executeQuery();
                //遍历查询结果集
                while(resultSet.next()){
        
                    System.out.println(resultSet.getString("id")+""+resultSet.getString("username"));
                }
            } catch (Exception e) {
        
                e.printStackTrace();
            }finally{
        
                //释放资源
                if(resultSet!=null){
        
                    try {
        
                        resultSet.close();
                    } catch (SQLException e) {
        
                        e.printStackTrace();
                    }
                }
                if(preparedStatement!=null){
        
                    try {
        
                        preparedStatement.close();
                    } catch (SQLException e) {
        
                        e.printStackTrace();
                    }
                }
                if(connection!=null){
        
                    try {
        
                        connection.close();
                    } catch (SQLException e) {
        
                        e.printStackTrace();
                    }
                }
            }
        }

--------------------

jdbc 问题分析：

1.  数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库链接池可解决此问题。
2.  Sql 语句在代码中硬编码，造成代码不易维护，实际应用 sql 变化的可能较大，sql 变动需要改变 java代码。
3.  使用 preparedStatement 向占有位符号传参数存在硬编码，因为 sql 语句的 where 条件不一定，可能多也可能少，修改 sql 还要修改代码，系统不易维护。
4.  对结果集解析存在硬编码（查询列名），sql 变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成 pojo 对象解析比较方便。

--------------------

### 三、Mybaits 入门案例 ###

**案例工程目录结构：**  
![在这里插入图片描述][20210417210621113.png_pic_left]

#### 3.1 环境搭建 ####

**步骤：**

1.  创建数据库
2.  创建maven工程并导入坐标
3.  创建实体类和Dao的接口
4.  创建mybatis的主配置文件 SqlMapConfig.xml
5.  创建映射配置文件 IUerDao.xml

--------------------

1、创建数据库：

首先在 mysql 中创建数据库，这里我们命名为 mybatisdb。创建好数据库之后，接下来我们创建 user 表，并添加如下图中的 5 条属性，注意设置 id 自增。  
![在这里插入图片描述][20210417213810931.png_pic_left]

--------------------

2、创建maven工程并导入坐标：

Idea 中点击 File → New → Project  
![在这里插入图片描述][20210413151051491.png_pic_left]  
在下面界面点击 Maven → Next（当然也可以勾选 Create from archetype， 然后选中方式2中的框中的选项）

**方式1：**  
![在这里插入图片描述][20210413151322359.png_pic_left]  
**方式2：**  
![在这里插入图片描述][20210414145234640.png_pic_left]

**当然选择方式2构建 maven 工程不会有 test 目录，用于日常学习和测试建议选择方式1**。

在以下界面输入项目名称，以及选择项目位置，完成创建。  
  groupId 一般分为多个段，这里我是两段，第一段为域，第二段为公司名称。域又分为 org、com、cn 等等许多，其中 org 为非营利组织，com 为商业组织。举个 apache 公司的 tomcat 项目例子：groupId 是 org.apache，它的域是org（因为 tomcat 是非营利项目），公司名称是 apache，artigactId 是 tomcat。此外，artifactId 和 项目名称是同一个。

[借鉴博客：https://blog.csdn.net/qq\_30137611/article/details/76762070][https_blog.csdn.net_qq_30137611_article_details_76762070]  
![在这里插入图片描述][20210413151929311.png_pic_left]

--------------------

POM文件导入坐标：

<dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.6</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.12</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13</version>
        </dependency>
    </dependencies>

--------------------

3、创建实体类和Dao的接口

实体类：

/**
     * 用户的实体类
     */
    public class User {
        
        private Integer id;
        private String username;
        private Date birthday;
        private String sex;
        private String address;
    
        public Integer getId() {
        
            return id;
        }
    
        public void setId(Integer id) {
        
            this.id = id;
        }
    
        public String getUsername() {
        
            return username;
        }
    
        public void setUsername(String username) {
        
            this.username = username;
        }
    
        public Date getBirthday() {
        
            return birthday;
        }
    
        public void setBirthday(Date birthday) {
        
            this.birthday = birthday;
        }
    
        public String getSex() {
        
            return sex;
        }
    
        public void setSex(String sex) {
        
            this.sex = sex;
        }
    
        public String getAddress() {
        
            return address;
        }
    
        public void setAddress(String address) {
        
            this.address = address;
        }
    
        @Override
        public String toString() {
        
            return "User{" +
                    "id=" + id +
                    ", username='" + username + '\'' +
                    ", birthday=" + birthday +
                    ", sex='" + sex + '\'' +
                    ", address='" + address + '\'' +
                    '}';
        }
    }

Dao的接口：

/**
     * 用户的持久层  接口
     */
    public interface IUserDao {
        
        /**
         * 查询操作
         */
        List<User> findAll();
    }

--------------------

4、创建 mybatis 的主配置文件 SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE configuration
            PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-config.dtd">
    
    
    <configuration>
        
        <environments default="mysql">
            
            <environment id="mysql">
                
                <transactionManager type="JDBC"/>
                
                <dataSource type="POOLED">
                    
                    <property name="driver" value="com.mysql.jdbc.Driver"/>
                    <property name="url" value="jdbc:mysql://localhost:3306/mybatisdb"/>
                    <property name="username" value="root"/>
                    <property name="password" value="000000"/>
                </dataSource>
            </environment>
        </environments>
    
        
        <mappers>
            <mapper resource="com/itheima/dao/IUserDao.xml"/>
        </mappers>
    </configuration>

--------------------

5、创建映射配置文件 IUerDao.xml

**要求：**

1.  创建位置：必须和持久层接口在相同的包中。（idea种是在resources文件夹下创建相同的目录结构）
2.  **名称：必须以持久层接口名称命名文件名，扩展名是.xml**  
    ![在这里插入图片描述][20210415105111933.png_pic_left]

<?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">
    <mapper namespace="com.itheima.dao.IUserDao">
        
        <select id="findAll" resultType="com.itheima.domain.User">
            select *from user;
        </select>
    </mapper>

--------------------

#### 3.2 入门案例编写 ####

public class MybatisTest {
        
        /**
         * 入门案例
         */
        public static void main(String[] args) throws Exception {
        
            //1.读取配置文件
            InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
            
            //2.创建SqlSessionFactory工厂
            SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
            SqlSessionFactory factory = builder.build(in);
    
            //3.使用工厂生产SqlSession对象
            SqlSession sqlSession = factory.openSession();
    
            //4.使用SqlSession创建Dao接口的代理对象
            IUserDao userDao = sqlSession.getMapper(IUserDao.class);
    
            //5.使用代理对象执行方法
            List<User> users = userDao.findAll();
            for (User user:users) {
        
                System.out.println(user);
            }
    
            //6.释放资源
            sqlSession.close();
            in.close();
        }
    }

控制台打印结果：  
![在这里插入图片描述][20210415110143921.png_pic_left]

--------------------

### 四、注意事项 ###

1.  IUserDao 和 IUserMapper 一样的。
2.  在idea中创建目录的时候，包在创建的过程中xx.xx.xxx具有层级结构，**resources 目录在创建的时候，不具有层级结构。**
3.  mybatis的映射配置文件位置 **必须** 和 dao 接口的包结构相同
4.  **映射配置文件 IUerDao.xml 的 mapper 标签 namespace 属性的取值必须是 dao 接口的全限定类名**
5.  **映射配置文件 IUerDao.xml 的操作配置(select)， id属性的取值必须是dao接口的方法名**

*  遵从 3、4、5 之后， 在开发中就无需再写dao的实现类

--------------------

本文借鉴了黑马教程的课堂笔记，后续将会陆续更新 mybatis 底层原理的讲解，如果大家对文章内容还存在一些疑问，欢迎大家在评论区留言哦~

[20210413143119930.png_pic_center]: https://img-blog.csdnimg.cn/20210413143119930.png#pic_center
[20210417210621113.png_pic_left]: https://img-blog.csdnimg.cn/20210417210621113.png#pic_left
[20210417213810931.png_pic_left]: https://img-blog.csdnimg.cn/20210417213810931.png?#pic_left
[20210413151051491.png_pic_left]: https://img-blog.csdnimg.cn/20210413151051491.png?#pic_left
[20210413151322359.png_pic_left]: https://img-blog.csdnimg.cn/20210413151322359.png?#pic_left
[20210414145234640.png_pic_left]: https://img-blog.csdnimg.cn/20210414145234640.png?#pic_left
[https_blog.csdn.net_qq_30137611_article_details_76762070]: https://blog.csdn.net/qq_30137611/article/details/76762070
[20210413151929311.png_pic_left]: https://img-blog.csdnimg.cn/20210413151929311.png?#pic_left
[20210415105111933.png_pic_left]: https://img-blog.csdnimg.cn/20210415105111933.png?#pic_left
[20210415110143921.png_pic_left]: https://img-blog.csdnimg.cn/20210415110143921.png?#pic_left