正文

Java开源框架MyBatis入门必备：高效SQL映射，实战教程一网打尽

/0 浏览量
0702

MyBatis是一款优秀的持久层框架，它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis可以通过简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，简单的Java对象）映射成数据库中的记录。下面，我将带领你一步步进入MyBatis的世界，让你快速掌握这一强大的框架。

一、MyBatis的基本概念

1.1. MyBatis的组成

MyBatis主要由以下几部分组成：

  • SqlSessionFactoryBuilder: 用于创建SqlSessionFactory。
  • SqlSessionFactory: 用于创建SqlSession。
  • SqlSession: 用于执行命令、获取映射器（Mapper）和 manage transactions。
  • Executor: 执行器接口，负责执行传入的MappedStatement。
  • MappedStatement: 表示一个映射器的操作，它映射到数据库中的操作。
  • ParameterObject: 参数对象的包装类，用于存储参数。
  • ResultObject: 结果对象的包装类，用于存储结果。

1.2. MyBatis的核心原理

MyBatis的核心原理在于它将SQL映射配置在外部文件中（XML文件），然后在运行时将这些配置转换为对应的Java对象，实现数据库的增删改查操作。

二、MyBatis的入门教程

2.1. 创建项目

首先，你需要创建一个Maven或Gradle项目，并添加MyBatis依赖。

2.1.1. Maven依赖

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

2.1.2. Gradle依赖

dependencies {
    implementation 'org.mybatis:mybatis:3.5.7'
    implementation 'mysql:mysql-connector-java:8.0.26'
}

2.2. 配置数据库

接下来，你需要配置数据库连接信息。

# application.properties
db.url=jdbc:mysql://localhost:3306/mydb
db.user=root
db.password=root

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

2.4. 创建XML映射文件

在src/main/resources/com/example/mapper目录下创建一个名为UserMapper.xml的XML映射文件，定义User实体类与数据库表的映射关系。

<?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">
    <resultMap id="userMap" type="com.example.entity.User">
        <result property="id" column="id"/>
        <result property="name" column="name"/>
        <result property="age" column="age"/>
    </resultMap>
    <select id="selectById" resultMap="userMap">
        SELECT id, name, age FROM user WHERE id = #{id}
    </select>
</mapper>

2.5. 创建接口

在com.example.mapper包下创建一个名为UserMapper的接口，定义查询、添加、删除和修改等方法。

package com.example.mapper;

public interface UserMapper {
    User selectById(int id);
    void addUser(User user);
    void deleteUser(int id);
    void updateUser(User user);
}

2.6. 使用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;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class Main {
    public static void main(String[] args) {
        try (SqlSession session = getSqlSessionFactory().openSession()) {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            User user = userMapper.selectById(1);
            System.out.println(user.getName());
        }
    }

    private static SqlSessionFactory getSqlSessionFactory() {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        return new SqlSessionFactoryBuilder().build(inputStream);
    }
}

通过以上步骤，你已经成功入门了MyBatis。接下来，你可以通过学习更多的高级功能和最佳实践，进一步提高你的开发效率。祝你在MyBatis的世界中畅游无阻！

-- 展开阅读全文 --