正文

Java开源框架MyBatis实用教程，快速上手数据库操作全解析

/0 浏览量
0504

引言

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

在本教程中，我们将从基础开始，逐步深入，带你快速上手 MyBatis，并学会如何进行数据库操作。

一、环境搭建

1.1 确定开发环境

在开始之前，请确保你的开发环境已经搭建好，包括以下内容：

  • Java Development Kit (JDK)
  • Integrated Development Environment (IDE)，如 IntelliJ IDEA 或 Eclipse
  • Maven 或 Gradle

1.2 创建Maven项目

使用 Maven 创建一个新项目，并添加以下依赖：

<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.26</version>
    </dependency>
</dependencies>

二、配置MyBatis

2.1 创建SqlSessionFactory

在 resources 目录下创建 mybatis-config.xml 文件，配置 SqlSessionFactory：

<?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/mydatabase"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2.2 创建Mapper接口

在 com.example.mapper 包下创建 UserMapper.java 接口：

package com.example.mapper;

public interface UserMapper {
    void insertUser(User user);
    User getUserById(int id);
}

2.3 创建Mapper XML

在 resources 目录下创建 com/example/mapper/UserMapper.xml 文件，配置 SQL 映射：

<?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">
    <insert id="insertUser" parameterType="User">
        INSERT INTO users (name, age) VALUES (#{name}, #{age})
    </insert>
    <select id="getUserById" resultType="User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

三、编写Java代码

3.1 创建实体类

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

package com.example.entity;

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

    // 省略getter和setter方法
}

3.2 创建MyBatis工具类

在 com.example.utils 包下创建 MyBatisUtil.java 工具类：

package com.example.utils;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisUtil.class.getClassLoader().getResourceAsStream("mybatis-config.xml"));
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static SqlSessionFactory getSqlSessionFactory() {
        return sqlSessionFactory;
    }
}

3.3 编写测试代码

在 com.example.test 包下创建 UserTest.java 测试类：

package com.example.test;

import com.example.entity.User;
import com.example.mapper.UserMapper;
import com.example.utils.MyBatisUtil;
import org.apache.ibatis.session.SqlSession;

public class UserTest {
    public static void main(String[] args) {
        try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            User user = new User();
            user.setName("张三");
            user.setAge(20);
            mapper.insertUser(user);
            session.commit();
            System.out.println("插入成功");

            User userById = mapper.getUserById(1);
            System.out.println("查询结果：" + userById);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

四、总结

通过本教程，你已成功搭建了 MyBatis 开发环境，并学会了如何进行数据库操作。在实际项目中，你可以根据需求调整配置和映射文件，实现更复杂的业务逻辑。

希望本教程能帮助你快速上手 MyBatis，祝你学习愉快！

-- 展开阅读全文 --