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

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

引用

CSDN

1.

https://blog.csdn.net/m0_52861684/article/details/127486698

本文将详细介绍如何在IntelliJ IDEA中搭建MyBatis环境，并通过一个简单的测试程序来验证环境配置是否正确。文章适合MyBatis初学者参考学习。

一、MyBatis 介绍

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

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

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

二、MyBatis 环境搭建

1. MyBatis 下载

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

（1）打开之后往下滑，找到Download Latest下载最新版本。
（2）这里可以看到三个包，第一个是我们要的架包，后两个是不同系统下的源码，我们下载第一个架包。

2. 配置 jdk 版本

File → Project Structure → Project，选择你的jdk版本，版本保持一致，点击Apply。

3. 创建 Maven 工程

（1）由于IDEA中集成了Maven，所以我们就不需要下载了，直接使用IDEA默认的Maven进行项目构建。
（2）打开IDEA开发工具，单击File → new → Project，选择Maven，点击Next。
（3）给你的项目起一个名字，选择项目要存放的位置。例如，项目的名字叫MyProject，可以在桌面上创建一个文件夹My用来放项目文件。（位置可以根据需要自行决定）
不要忘记点击finish完成！

4. IDEA 连接数据库

① View → Tool Windows → DataBase → 屏幕右侧点加号 → DataSource → MySQL
② 填写以下内容
Name值随便起无所谓，填写你的MySQL用户名及密码，Database处填数据库名，我们刚刚的数据库名叫mybatis，下面URL路径不用管填了Database会自动生成。
③ 点击Driver：MySQL → Go to driver，选择你的数据库jar包，这个包的位置要看你当初把MySQL安装在哪个地方了。
④ 点击下面的Test Connection，是一个测试，如果下面不报错则代表连接成功，最后一步点击Apply应用，连接成功后会在IDEA右侧显示。

5. 项目文件构架

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

项目需要创建的文件我都展开了，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>

7. 命令行创建数据库

命令行创建数据库：

create database mybatis;

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

先把我的代码全部复制上，需要你自己修改的地方有三个，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">
                <!--                JDBC 驱动-->
                <property name="driver" value="${mysql.driver}"/>
                <!--                url数据库的 JDBC URL地址。-->
                <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);

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 → 加号

复制我的代码进去：

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

别忘了Apply，下次需要可直接在选项卡中看到mapperxml！

4. 修改核心配置文件

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

<mappers>
    <!--配置xxxMapper.xml文件的位置-->
    <mapper resource="Mapper/UserMapper.xml"/>
</mappers>

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();
    }
}

运行结果：