正文

轻松入门MyBatis：从搭建环境到项目实践全解析

/0 浏览量
0529

引言

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。在本文中，我们将从搭建环境开始，逐步深入到 MyBatis 的项目实践，帮助读者轻松入门。

一、MyBatis 简介

MyBatis 是一个半ORM（对象关系映射）框架，它将 SQL 映射成 Java 对象，从而简化了数据库操作。MyBatis 的核心是 SQL 映射文件，它定义了 SQL 语句与 Java 对象之间的映射关系。

二、搭建 MyBatis 环境

1. 准备开发工具

首先，我们需要准备开发工具。这里推荐使用 IntelliJ IDEA 或 Eclipse 作为开发环境。

2. 添加依赖

在项目的 pom.xml 文件中添加以下依赖：

<dependencies>
    <!-- MyBatis 依赖 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <!-- MySQL 驱动依赖 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
    <!-- 数据库连接池依赖 -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.2.6</version>
    </dependency>
</dependencies>

3. 配置数据库连接

在 application.properties 文件中配置数据库连接信息：

# 数据库连接信息
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root

三、创建 MyBatis 映射文件

在项目的 src/main/resources 目录下创建 mapper 目录，用于存放 MyBatis 映射文件。例如，创建一个 UserMapper.xml 文件：

<?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.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

四、编写 MyBatis 接口

在项目的 src/main/java 目录下创建 com.example.mapper 包，并创建 UserMapper 接口：

package com.example.mapper;

import com.example.entity.User;

public interface UserMapper {
    User selectById(Integer id);
}

五、MyBatis 配置

在 src/main/resources 目录下创建 mybatis-config.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>
    <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_db?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>
</configuration>

六、项目实践

1. 创建实体类

在 com.example.entity 包下创建 User 类：

package com.example.entity;

public class User {
    private Integer id;
    private String name;
    private Integer age;

    // 省略 getter 和 setter 方法
}

2. 创建 MyBatis 映射文件

修改 UserMapper.xml 文件，添加实体类与数据库表的映射关系：

<!-- 省略其他内容 -->

<resultMap id="UserResultMap" type="com.example.entity.User">
    <id property="id" column="id"/>
    <result property="name" column="name"/>
    <result property="age" column="age"/>
</resultMap>

<select id="selectById" resultMap="UserResultMap">
    SELECT * FROM user WHERE id = #{id}
</select>

3. 使用 MyBatis

在 com.example.mapper 包下创建 UserMapperTest 类，测试 MyBatis：

package com.example.mapper;

import com.example.entity.User;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class UserMapperTest {
    public static void main(String[] args) {
        try {
            // 创建 SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
                    Resources.getResourceAsStream("mybatis-config.xml"));

            // 获取 SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();

            // 创建 UserMapper
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

            // 查询用户信息
            User user = userMapper.selectById(1);
            System.out.println(user.getName() + ", " + user.getAge());

            // 关闭 SqlSession
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行 UserMapperTest 类，输出结果如下：

张三, 20

至此，我们已成功使用 MyBatis 查询数据库中的用户信息。

总结

本文从搭建 MyBatis 环境开始，逐步深入到 MyBatis 的项目实践，帮助读者轻松入门。希望读者通过本文的学习，能够熟练掌握 MyBatis 的使用方法。在实际项目中，MyBatis 可以大大简化数据库操作，提高开发效率。

-- 展开阅读全文 --