正文

从零开始：掌握Java开源框架MyBatis的实战指南

/0 浏览量
0412

引言

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。在这个指南中，我们将从零开始，逐步深入地了解 MyBatis 的核心概念，并通过实战案例来掌握它的使用。

第一部分：MyBatis 简介

1.1 什么是 MyBatis？

MyBatis 是一个支持定制化 SQL、存储过程以及高级映射的持久层框架。它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。

1.2 MyBatis 的优势

  • 简化数据库操作：通过使用 MyBatis，可以减少编写繁琐的 JDBC 代码。
  • 支持自定义 SQL：允许开发者编写复杂的 SQL 语句，实现复杂的数据库操作。
  • 高级映射：支持复杂的关联映射，如一对多、多对多等。
  • 易于集成：MyBatis 可以与任何 JDBC 兼容的数据源一起使用。

第二部分：环境搭建

2.1 创建项目

首先，我们需要创建一个 Java 项目。这里我们使用 Maven 来管理项目依赖。

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>mybatis-example</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <!-- MyBatis 依赖 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
        <!-- 数据库驱动依赖 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.26</version>
        </dependency>
    </dependencies>
</project>

2.2 配置数据源

在 src/main/resources 目录下创建 mybatis-config.xml 文件，配置数据源。

<?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/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
</configuration>

第三部分：编写映射文件

3.1 创建 Mapper 接口

在 src/main/java 目录下创建一个接口，例如 UserMapper.java。

package com.example.mapper;

import com.example.entity.User;

public interface UserMapper {
    User findUserById(int id);
}

3.2 创建映射文件

在 src/main/resources 目录下创建一个 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="findUserById" resultType="com.example.entity.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

第四部分：使用 MyBatis

4.1 配置 SQLSessionFactory

在 src/main/java 目录下创建一个类，例如 MyBatisUtil.java。

package com.example.util;

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

import java.io.InputStream;

public class MyBatisUtil {
    public static SqlSessionFactory getSqlSessionFactory() throws Exception {
        String resource = "mybatis-config.xml";
        InputStream inputStream = MyBatisUtil.class.getClassLoader().getResourceAsStream(resource);
        return new SqlSessionFactoryBuilder().build(inputStream);
    }
}

4.2 使用 MyBatis

在主程序中，我们可以这样使用 MyBatis：

package com.example;

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

public class Main {
    public static void main(String[] args) {
        try {
            SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
            SqlSession sqlSession = sqlSessionFactory.openSession();
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.findUserById(1);
            System.out.println("User: " + user);
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

第五部分：总结

通过本指南，我们学习了 MyBatis 的基本概念、环境搭建、映射文件编写以及使用方法。MyBatis 是一个功能强大且易于使用的框架，可以帮助我们简化数据库操作，提高开发效率。在实际项目中，我们可以根据需求进一步学习和掌握 MyBatis 的更多高级特性。

-- 展开阅读全文 --