快速搭建第一个Mybatis程序

一时失言乱红尘 2023-09-30 11:03 14阅读 0赞

####  ####

*  一、简介
 *   *  1.初识Mybatis
     *  2.持久化
     *  3.持久层
     *  4.为什么需要Mybatis
 *  二、第一个Mybatis程序
 *   *  1.搭建环境
     *  2.创建一个新模块
     *  3.编写代码
     *  4.Junit测试
 *  三、可能遇到的问题

## 一、简介 ##

以Mybatis3.5.7为例  
环境：

*  jdk8.0
 *  Mysql8.0
 *  maven3.8.4
 *  IDEA

回顾:

*  JDBC
 *  Mysql
 *  Java基础
 *  Maven
 *  Junit

### 1.初识Mybatis ###

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_12_color_FFFFFF_t_70_g_se_x_16]

*  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。所以要找Mybatis得去Github

怎么获得Mybatis?

*  maven仓库

<dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>

*  搜搜jar包的坐标网站[https://mvnrepository.com/][https_mvnrepository.com]
 *  Github: [https://github.com/mybatis/mybatis-3/releases][https_github.com_mybatis_mybatis-3_releases]
 *  Mybatis中文文档:[https://mybatis.net.cn/index.html][https_mybatis.net.cn_index.html]
 *  ![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16]

### 2.持久化 ###

数据持久化

*  持久化就是把程序的数据在持久状态和瞬时状态转化的过程
 *  内存：断电后数据就消失了
 *  数据库(jdbc),IO文件持久化

为什么需要持久化

*  内存断电后数据就丢失了，有一些对象我们不能让他丢掉
 *  内存太贵了

### 3.持久层 ###

Dao层，Service层，Controller层

*  完成持久化工作的代码块
 *  层的界限十分明显
 *  每个层的任务很明确，各司其职
 *  关于三层架构，大家可以看这篇博客，讲解得很清楚[SSM，三层结构，MVC三者的说明及关系(很全面)][SSM_MVC]

### 4.为什么需要Mybatis ###

*  帮助程序员把数据存入到数据库中
 *  方便
 *  传统的JDBC代码太复杂了，框架可以简化操作，自动化。
 *  不使用Mybatis也可以，更容易上手。
 *  优点:
    
     *  sql和代码分类，提高可维护性
     *  提供映射标签，支持对象与数据库的orm字段关系映射
     *  ORM是对象关系映射的意思  
        O ------ object就是 java对象  
        R -------relational 关系型数据  
        M -------mappering 映射
     *  提供哦那个对象关系映射标签，支持对象关系组建维护
     *  提供xml标签，支持编写动态sql

## 二、第一个Mybatis程序 ##

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

### 1.搭建环境 ###

先提供一个数据库和用来操作的表  
新建项目  
1.File->new Project 新建maven项目  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 1]

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 2]  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 3]  
下面这一堆代码是构建maven项目以后，自带的

<?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.kuang</groupId>
        <artifactId>Mybatis-study</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <properties>
            <maven.compiler.source>8</maven.compiler.source>
            <maven.compiler.target>8</maven.compiler.target>
        </properties>
    
    </project>

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 4]

2.删除src,这样就可以当成父工程了  
3.导入maven依赖  
第一次加入依赖的时候，项目会爆红，记得重新加载项目，这样就不会爆红了

<dependencies>
    
            
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>8.0.16</version>
            </dependency>
    
            
            
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.7</version>
            </dependency>
    
            
            
            <dependency>
                <groupId>org.junit.jupiter</groupId>
                <artifactId>junit-jupiter-api</artifactId>
                <version>5.8.2</version>
                <scope>test</scope>
            </dependency>
    
        </dependencies>

### 2.创建一个新模块 ###

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 5]  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 6]  
父项目的pox.xml就会多出来这样的代码

<modules>
            <module>mybatis-01</module>
            <module>mybatis-01</module>
            <module>mybatis-01</module>
        </modules>

*  编写mybatis核心配置文件  
    ![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_12_color_FFFFFF_t_70_g_se_x_16 1]  
    把下面的代码拷贝到刚刚新建的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="development">
            <environment id="development">
                <transactionManager type="JDBC"/>
                <dataSource type="POOLED">
                    <property name="driver" value="${driver}"/>
                    <property name="url" value="${url}"/>
                    <property name="username" value="${username}"/>
                    <property name="password" value="${password}"/>
                </dataSource>
            </environment>
        </environments>
        <mappers>
            <mapper resource="org/mybatis/example/BlogMapper.xml"/>
        </mappers>
    </configuration>

上面那一个从官网复制过来的，相当于是一个模板，但是里面具体的信息需要我们自己去设置，比如说我们要连接的数据库的用户名，密码等信息需要手动配置  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 7]

<?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="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?serverTimezone=Asia/Shanghai&useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
                    <property name="username" value="root"/>
                    <property name="password" value="a87684009."/>
    
                </dataSource>
            </environment>
            <environment id="test">
                <transactionManager type="JDBC"/>
    
                <dataSource type="POOLED">
                    <property name="driver" value="${driver}"/>
                    <property name="url" value="${url}"/>
                    <property name="username" value="${username}"/>
                    <property name="password" value="${password}"/>
                </dataSource>
            </environment>
        </environments>
    
    
        <mappers>
            <mapper resource="com/kuang/dao/UserMapper.xml"/>
        </mappers>
    </configuration>

### 3.编写代码 ###

*  编写mybatis工具类

//工厂模式
    //sqlSessionFactory---->sqlSession
    public class MybatisUtils {
        
        public static SqlSessionFactory sqlSessionFactory;
    
        static {
        
    
            try {
        
                //读取配置文件
                //下面三句话是固定的
                //使用Mybatis第一步:获取sqlSessionFactory对象
                String resource = "mybatis-config.xml";
                InputStream inputStream = Resources.getResourceAsStream(resource);
                SqlSessionFactory build = new SqlSessionFactoryBuilder().build(inputStream);
            } catch (IOException e) {
        
                e.printStackTrace();
            }
        }
    
        /**
         * 既然有了SqlSessionFactory,顾名思义，我们就可以从中获取SqlSession的实例了
         * SqlSession完全包含了面向数据库执行sql命令所需要的所有方法
         */
        public static SqlSession getSqlSession() {
        
            SqlSession sqlSession = sqlSessionFactory.openSession();
            return  sqlSession;
        }
    
    
    }

*  实体类(domain,pojo,domain)每一个类都和数据库中的一张表相关联

package com.kuang.pojo;
    
    /**实体类
     * @author zengyihong
     * @create 2022--03--28 17:14
     */
    public class User {
        
     private int id;
     private String username;
     private String password;
    
     public User() {
        
     }
    
     public User(int id, String username, String password) {
        
      this.id = id;
      this.username = username;
      this.password = password;
     }
    
     public int getId() {
        
      return id;
     }
    
     public void setId(int id) {
        
      this.id = id;
     }
    
     public String getUsername() {
        
      return username;
     }
    
     public void setUsername(String username) {
        
      this.username = username;
     }
    
     public String getPassword() {
        
      return password;
     }
    
     public void setPassword(String password) {
        
      this.password = password;
     }
    
     @Override
     public String toString() {
        
      return "User{" +
              "id=" + id +
              ", username='" + username + '\'' +
              ", password='" + password + '\'' +
              '}';
     }
    }

*  DAO接口(对数据库表的CRUD操作，对user表的操作就对应一个userDao)

package com.kuang.dao;
    
    import com.kuang.pojo.User;
    
    import java.util.List;
    
    /**这个类用来操作数据库中对象的实体
     * @author zengyihong
     * @create 2022--03--28 17:16
     */
    //dao等价于mapper
    public interface UserDao {
        
        List<User> getUserList();
    }

*  接口实现类由原来的UserDaoImpl转换成为一个Mapper配置文件

<?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.kuang.dao.UserDao">
    
        <select id="getUserList"  resultType="com.kuang.pojo.User">
            select  * from mybatis.user
        </select>
    
    </mapper>

可能大家看到上面那些有点懵，那我们就来复习一下 ，具体的大家可以看我博客中JDBC的内容，里面有关于分层的讲解。

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 8]  
![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 9]

### 4.Junit测试 ###

package com.kuang.dao;
    
    import com.kuang.pojo.User;
    import com.kuang.utils.MybatisUtils;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.jupiter.api.Test;
    
    import java.util.List;
    
    /**
     * @author zengyihong
     * @create 2022--03--29 9:55
     */
    public class UserDaoTest {
        
        @Test
        public void test(){
        
    //        SqlSession
    //                第一步：获得SqlSession对象
            SqlSession sqlSession = MybatisUtils.getSqlSession();
            //方式一：执行SQL getMapper
            UserDao mapper = sqlSession.getMapper(UserDao.class);
            List<User> userList = mapper.getUserList();
            for (User user:userList){
        
                System.out.println(user);
            }
            //关闭SqlSession
    
            sqlSession.close();
    
        }
    
    }

![在这里插入图片描述][watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 10]

## 三、可能遇到的问题 ##

1.配置文件没有注册  
2.绑定接口错误  
3.方法名错误  
4.返回类型错误  
5.maven导出资源错误  
在pox.xml中，加入下面代码即可

<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>

[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_12_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/18c51bcab2014f62a80d8bec3850deec.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_12,color_FFFFFF,t_70,g_se,x_16
[https_mvnrepository.com]: https://mvnrepository.com/
[https_github.com_mybatis_mybatis-3_releases]: https://github.com/mybatis/mybatis-3/releases
[https_mybatis.net.cn_index.html]: https://mybatis.net.cn/index.html
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/09419b66af874f01bdeb612bd91815dc.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[SSM_MVC]: https://blog.csdn.net/Tranne/article/details/109022923
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/8a573ef9dad340669e4dc74ac45cd291.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 2]: https://img-blog.csdnimg.cn/0081060f105a4267af5fdf1e5bc9260b.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 3]: https://img-blog.csdnimg.cn/d8693a00e08d4fd384fa1ea93e4614b9.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 4]: https://img-blog.csdnimg.cn/94fafa1d12ad4fbd90c895042060ab86.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 5]: https://img-blog.csdnimg.cn/4727a3aab0bc4420989a41b813fae2f7.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 6]: https://img-blog.csdnimg.cn/c74ba0041ce440ae98a5969ed0da5950.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_12_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/3f40f3b9133944d386efd4771a0e9118.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_12,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 7]: https://img-blog.csdnimg.cn/155c57e32e184261be4b5a39bb848800.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 8]: https://img-blog.csdnimg.cn/ddd8dcf95bd941d8b4e9c13073e80ce1.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 9]: https://img-blog.csdnimg.cn/8dabf9eae54c45ddb073469ab3160403.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw_size_20_color_FFFFFF_t_70_g_se_x_16 10]: https://img-blog.csdnimg.cn/306fa92db87848a8b5b53f08d22bd64f.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBASmF2YeeahOWtpuS5oOS5i-i3rw==,size_20,color_FFFFFF,t_70,g_se,x_16