正文

Java开源框架MyBatis快速入门：从搭建到实战应用指南

/0 浏览量
0728

引言

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

在这个指南中，我们将从搭建 MyBatis 环境开始，逐步深入到如何使用 MyBatis 进行数据库操作，最后通过一个实战案例来巩固所学知识。

搭建MyBatis环境

1. 环境准备

  • Java Development Kit (JDK): 确保安装了 JDK 1.8 或更高版本。
  • IDE: 选择一个合适的 IDE，如 IntelliJ IDEA 或 Eclipse。
  • 数据库: 选择一个数据库，如 MySQL 或 PostgreSQL。

2. 添加依赖

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

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

3. 配置数据库连接

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

# 数据库连接信息
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_db?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

MyBatis核心概念

1. Mapper接口

Mapper 接口定义了数据库操作的 SQL 语句，MyBatis 会根据接口的方法名和参数类型自动生成对应的 SQL 语句。

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

2. Mapper XML

Mapper XML 文件定义了 SQL 语句和结果映射，与 Mapper 接口相对应。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <update id="update">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
</mapper>

3. 配置文件

MyBatis 配置文件 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?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

实战应用

1. 创建实体类

创建一个 User 实体类，用于表示数据库中的用户表。

public class User {
    private Integer id;
    private String name;
    private Integer age;
    // 省略 getter 和 setter 方法
}

2. 编写Mapper接口

根据实体类和数据库表结构，编写 UserMapper 接口。

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

3. 编写Mapper XML

根据 Mapper 接口，编写对应的 Mapper XML 文件。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <update id="update">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
</mapper>

4. 测试

在测试类中，使用 MyBatis 的 SqlSessionFactoryBuilder 创建 SqlSessionFactory，然后通过 SqlSession 执行数据库操作。

public class MyBatisTest {
    public static void main(String[] args) throws IOException {
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.selectById(1);
            System.out.println(user.getName());
            user.setName("张三");
            userMapper.update(user);
            sqlSession.commit();
        }
    }
}

总结

通过本文的介绍，相信你已经对 MyBatis 有了一定的了解。MyBatis 可以帮助你简化数据库操作，提高开发效率。在实际项目中，你可以根据自己的需求进行配置和扩展，充分发挥 MyBatis 的优势。

-- 展开阅读全文 --