MyBatis 环境搭建配置全过程【IDEA】

╰+攻爆jí腚メ 2023-09-24 13:29 88阅读 0赞

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

*   *  一、MyBatis 介绍
     *  二、MyBatis 环境搭建
     *   *  1.MyBatis 下载
         *  2.配置 jdk 版本
         *  3.创建 Maven 工程
         *  4.IDEA 连接数据库
         *  5.项目文件构架
         *  6.引入相关依赖
         *  7.命令行创建数据库
         *  8.数据库配置文件
         *  9.核心配置文件
     *  三、入门测试程序
     *   *  1.创建表准备数据
         *  2.创建 POJO 实体
         *  3.创建映射文件
         *  4.修改核心配置文件
         *  5.编写测试类

### 一、MyBatis 介绍 ###

MyBatis 是一个支持普通 SQL 查询、存储过程以及高级映射的持久层框架，它消除了几乎所有的 JDBC 代码和参数的手动设置以及对结果集的检索，使用简单的 XML 或注解进行配置和原始映射，将接口和 Java 的 POJO 映射成数据库中的记录，使得 Java 开发人员可以**使用面向对象的编程思想来操作数据库**。

针对 JDBC 编程的劣势，MyBatis 提供了以下解决方案，具体如下：

① 在 SqlMapConfig.xml 中配置数据连接池，使用连接池管理数据库链接；  
② MyBatis 将 SQL 语句配置在 MyBatis 的映射文件中，实现了与 Java 代码的分离；  
③ MyBatis 自动将 Java 对象映射至 SQL 语句，通过 Statement 中的 parameterType 定义输入参数的类型；  
④ MyBatis 自动将 SQL 执行结果映射至 Java 对象，通过 Statement 中的 resultType 定义输出结果的类型。

### 二、MyBatis 环境搭建 ###

#### 1.MyBatis 下载 ####

官方地址：`https://github.com/mybatis/mybatis-3`

（1）打开之后往下滑，找到 Download Latest 下载最新版本。

![在这里插入图片描述][18f6fd51bf7c4c67ad73350d5fca0ab0.png]  
（2）这里可以看到三个包，第一个是我们要的架包，后两个是不同系统下的源码，我们下载第一个架包。

![在这里插入图片描述][e4fdbebb1e424d27a27b62a8633ab54f.png]

#### 2.配置 jdk 版本 ####

File → Project Structure → Project，1处选择你的 jdk 版本，2 处版本与1一致，Apply。

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

#### 3.创建 Maven 工程 ####

（1）由于 IDEA 中集成了 Maven，所以我们就不需要下载了，直接使用 IDEA 默认的 Maven 进行项目构建。

（2）打开 IDEA 开发工具，单击 File → new → Project，选择 Maven，点击 Next。

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

（3）第一行给你的项目起一个名字吧，第二行选择项目要存放的位置，我这里项目的名字叫 MyProject，可以提前在桌面上创了一个文件夹 My 用来放项目文件。（当然位置自己决定）

![在这里插入图片描述][48b75ccf90ce4e6ca969dd1d53f93228.png_pic_center]  
`不要忘记点击 finish 完成！`

（4）如图创建成功后就是这个样子。

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

#### 4.IDEA 连接数据库 ####

① View → Tool Windows → DataBase → 屏幕右侧点加号 → DataSource → MySQL

![在这里插入图片描述][63688e789afb4ba18e3c11f2d6ea7d07.png]

② 填写以下内容

![在这里插入图片描述][3d46c407105d4ff8b1b3fe23754f09b4.png]

> Name 值随便起无所谓，填写你的 MySQL 用户名及密码，Database 处填数据库名，我们刚刚的数据库名叫 mybatis，下面URL路径不用管填了 Database 会自动生成。

③ 点击 Driver：MySQL → Go to driver，选择你的数据库 jar 包，这个包的位置要看你当初把 MySQL 安装在哪个地方了。

④ 点击下面的 Test Connection，是一个测试，如果下面不报错则代表连接成功，最后一步点击 Apply 应用，连接成功后会在 IDEA 右侧显示。

#### 5.项目文件构架 ####

下图是我的项目目录，全部都展开了，大家先按这个构架去创建各种包及文件，名字最好先跟我的一样，避免后面出错。

![在这里插入图片描述][cb404a059fba479cbdada95ba6b87b7c.png]

`项目需要创建的文件我都展开了，target 里面的不用你管是自动生成的！`

#### 6.引入相关依赖 ####

将以下依赖代码复制并粘贴到 pom.xml 文件中，什么都不用改，直接复制！

<dependencies>
    
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.5.2</version>
            </dependency>
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>8.0.11</version>
            </dependency>
            <dependency>
                <groupId>junit</groupId>
                <artifactId>junit</artifactId>
                <version>4.12</version>
                <scope>compile</scope>
            </dependency>
    
        </dependencies>
        <build>
            <resources>
                <resource>
                    <directory>src/main/java</directory>
                    <includes>
                        <include>**/*.properties</include>
                        <include>**/*.xml</include>
                    </includes>
                    <filtering>true</filtering>
                </resource>
            </resources>
        </build>

![在这里插入图片描述][1956d5737b684d0f8be962c8eba2ae43.png]

> 大约粘贴到这个位置，至于我的主题颜色为什么又换成白色的了，hhhhh因为电脑没电了，感JIO眼睛快X了~好了好了言归正传，听我的听我的，下一步赶快去创建一个数据库备用！

#### 7.命令行创建数据库 ####

命令行创建数据库：

create database mybatis;

![在这里插入图片描述][8910f890baf54792a53dd6a773ba80e9.png]

#### 8.数据库配置文件 ####

db.properties 文件就是数据库连接的配置文件，在该文件中配置相关参数。

mysql.driver=com.mysql.cj.jdbc.Driver
    mysql.username=root
    mysql.password=123456bb
    mysql.url=jdbc:mysql://localhost:3306/mybatis?serverTimezone=UTC&characterEncoding=utf8&useUnicode=true&useSSL=false

![在这里插入图片描述][fdc699cdc88e407ebbc2429b274d5bce.png]

> 先把我的代码全部复制上，需要你自己修改的地方有三个，1处是你的 MySQL 用户名，2处是你的 MySQL 密码，3处是数据库名，即 mybatis 这是我们刚才创建的那个数据库！

#### 9.核心配置文件 ####

刚刚创建的 MybatisConfig.xml 就是 Mybatis 的核心配置文件。

<?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>
        <properties resource="db.properties"/>
        <environments default="development">
            <environment id="development">
                <transactionManager type="JDBC"/>
                <dataSource type="POOLED">
                    
                    <property name="driver" value="${mysql.driver}"/>
                    
                    <property name="url" value="${mysql.url}"/>
                    <property name="username" value="${mysql.username}"/>
                    <property name="password" value="${mysql.password}"/>
                </dataSource>
            </environment>
        </environments>
    
        <mappers>
            
            <mapper resource="Mapper/UserMapper.xml"/>
        </mappers>
    
    </configuration>

> 如果你是跟着我的步骤一步一步来的，那么不需要修改任何地方，可以完全复制。

### 三、入门测试程序 ###

#### 1.创建表准备数据 ####

use mybatis;
    //创建表
    create table Users(
        uid int not null auto_increment primary key,
        uname varchar(10) not null,
        uage int not null
    );
    //插入数据
    insert into Users(uid,uname,uage) values(null,'张三',20),(null,'李四',18);

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

#### 2.创建 POJO 实体 ####

pojo 包下的 User 类，用于封装 User 对象的属性。

package com.tyut.pojo;
    
    public class User {
        
        private int uid;
        private String uname;
        private int uage;
    
        public int getUid() {
        
            return uid;
        }
    
        public void setUid(int uid) {
        
            this.uid = uid;
        }
    
        public String getUname() {
        
            return uname;
        }
    
        public void setUname(String uname) {
        
            this.uname = uname;
        }
    
        public int getUage() {
        
            return uage;
        }
        public void setUage(int uage) {
        
            this.uage = uage;
        }
    }

> 各变量名称与数据库里的保持一致，同样如果你是完全跟着我走的，那可以直接复制了！

#### 3.创建映射文件 ####

Mapper 文件夹下的 UserMapper.xml 文件即映射文件。

<!DOCTYPE mapper
            PUBLIC "-//mybatis.org//DTD mapper 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.tyut.pojo.User">
        <select id="findById" parameterType="int" resultType="com.tyut.pojo.User">
            select * from users where uid = #{id}
        </select>
    </mapper>

> 如果上面配置都是完整跟下来的话，可以直接复制我上面的代码粘贴到你的 UserMapper.xml 文件里，如果文件名或者数据库里面的表名等等不一样的话，可自行修改，注意路径写对。

每次新建一个实体类就要创建一个映射文件，由于创建映射文件不会提供头部声明，复制粘贴起来也很麻烦，所以这里我们可以通过创建一个映射文件模板的方式，新建映射文件。（当然不影响本项目，你可以不创建，只不过为了方便）

具体步骤，File → Settings → Editor → File and Code Templates → 加号

![在这里插入图片描述][95d218a1295b4930b251766d97e4aa8e.png]

复制我的代码进去：

<!DOCTYPE mapper
            PUBLIC "-//mybatis.org//DTD mapper 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <mapper namespace="com.tyut.pojo.User">
    </mapper>

![在这里插入图片描述][9f7e98c77bba46408bb39c24eb3ec537.png_pic_center]  
`别忘了 Apply，下次需要可直接在选项卡中看到 mapperxml！`

#### 4.修改核心配置文件 ####

继续打开我们前面已经创建好的 MybatisConfig.xml 文件，现在我们给它配置文件路径，至于刚刚为什么没有配置，是因为这个路径就是映射文件所在的位置，所以我们先把映射文件编写完再返回来给 MybatisConfig.xml 设置路径。

![在这里插入图片描述][222f78e221b444cdbbe2c6a159a0b57d.png]

#### 5.编写测试类 ####

测试类在Test下的 UserTest 中。

package com.tyut.Test;
    import com.tyut.pojo.User;
    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.Reader;
    import java.io.IOException;
    
    public class UserTest {
        
        @Test
        public void userFindByTest() {
        
            String resources = "MybatisConfig.xml";
            Reader reader = null;
            try {
        
                reader = Resources.getResourceAsReader(resources);
            }catch (IOException e) {
        
                e.printStackTrace();
            }
            SqlSessionFactory sqlMapper = new SqlSessionFactoryBuilder().build(reader);
            SqlSession session = sqlMapper.openSession();
            User user = session.selectOne("findById",1);
            System.out.println("姓名\t年龄");
            System.out.println(user.getUname()+"\t"+user.getUage());
            session.close();
        }
    }

运行结果：

![在这里插入图片描述][0f80f54dde644e28add8aefd213adc64.png]

[18f6fd51bf7c4c67ad73350d5fca0ab0.png]: https://img-blog.csdnimg.cn/18f6fd51bf7c4c67ad73350d5fca0ab0.png
[e4fdbebb1e424d27a27b62a8633ab54f.png]: https://img-blog.csdnimg.cn/e4fdbebb1e424d27a27b62a8633ab54f.png
[fe08bf543b6a4c1bbd077ece40a92a56.png_pic_center]: https://img-blog.csdnimg.cn/fe08bf543b6a4c1bbd077ece40a92a56.png#pic_center
[44dc110e368c411c84597cf0d02d3edd.png_pic_center]: https://img-blog.csdnimg.cn/44dc110e368c411c84597cf0d02d3edd.png#pic_center
[48b75ccf90ce4e6ca969dd1d53f93228.png_pic_center]: https://img-blog.csdnimg.cn/48b75ccf90ce4e6ca969dd1d53f93228.png#pic_center
[107780ec92234d15b42d42b196d81ed2.png_pic_center]: https://img-blog.csdnimg.cn/107780ec92234d15b42d42b196d81ed2.png#pic_center
[63688e789afb4ba18e3c11f2d6ea7d07.png]: https://img-blog.csdnimg.cn/63688e789afb4ba18e3c11f2d6ea7d07.png
[3d46c407105d4ff8b1b3fe23754f09b4.png]: https://img-blog.csdnimg.cn/3d46c407105d4ff8b1b3fe23754f09b4.png
[cb404a059fba479cbdada95ba6b87b7c.png]: https://img-blog.csdnimg.cn/cb404a059fba479cbdada95ba6b87b7c.png
[1956d5737b684d0f8be962c8eba2ae43.png]: https://img-blog.csdnimg.cn/1956d5737b684d0f8be962c8eba2ae43.png
[8910f890baf54792a53dd6a773ba80e9.png]: https://img-blog.csdnimg.cn/8910f890baf54792a53dd6a773ba80e9.png
[fdc699cdc88e407ebbc2429b274d5bce.png]: https://img-blog.csdnimg.cn/fdc699cdc88e407ebbc2429b274d5bce.png
[604200352eca418084f5d3984679e466.png_pic_center]: https://img-blog.csdnimg.cn/604200352eca418084f5d3984679e466.png#pic_center
[95d218a1295b4930b251766d97e4aa8e.png]: https://img-blog.csdnimg.cn/95d218a1295b4930b251766d97e4aa8e.png
[9f7e98c77bba46408bb39c24eb3ec537.png_pic_center]: https://img-blog.csdnimg.cn/9f7e98c77bba46408bb39c24eb3ec537.png#pic_center
[222f78e221b444cdbbe2c6a159a0b57d.png]: https://img-blog.csdnimg.cn/222f78e221b444cdbbe2c6a159a0b57d.png
[0f80f54dde644e28add8aefd213adc64.png]: https://img-blog.csdnimg.cn/0f80f54dde644e28add8aefd213adc64.png