正文

从零开始，轻松掌握Java开源框架MyBatis：高效数据库操作与灵活配置详解

/0 浏览量
0524

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

一、MyBatis 简介

MyBatis 遵循约定大于配置的原则，使得开发人员能够更专注于 SQL 本身，而不是花费大量时间在复杂的配置上。MyBatis 具有以下特点：

  • 半自动ORM映射：MyBatis 可以将 Java 对象映射成数据库中的表，也可以将表映射成 Java 对象。
  • 灵活的映射配置：可以通过 XML 或注解来配置映射，使得映射更加灵活。
  • 支持自定义 SQL、存储过程以及高级映射：MyBatis 支持自定义 SQL 语句、存储过程以及复杂的映射，如一对一、一对多、多对多等。

二、环境搭建

1. 创建 Maven 项目

首先，创建一个 Maven 项目。在 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.23</version>
    </dependency>
    <!-- 数据库连接池 -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.22</version>
    </dependency>
</dependencies>

2. 配置数据库连接

在 resources 目录下创建 application.properties 文件，配置数据库连接信息：

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

3. 配置 MyBatis

在 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="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 配置映射文件 -->
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

三、定义 Mapper 接口

在 com.example.mapper 包下创建 UserMapper.java 接口，定义数据库操作的方法：

package com.example.mapper;

import com.example.entity.User;
import java.util.List;

public interface UserMapper {
    List<User> findAll();
    User findById(Integer id);
    int save(User user);
    int update(User user);
    int delete(Integer id);
}

四、定义 Mapper 映射文件

在 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">
    <select id="findAll" resultType="com.example.entity.User">
        SELECT * FROM user
    </select>
    <select id="findById" parameterType="int" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <insert id="save" parameterType="com.example.entity.User">
        INSERT INTO user (name, age, email) VALUES (#{name}, #{age}, #{email})
    </insert>
    <update id="update" parameterType="com.example.entity.User">
        UPDATE user SET name = #{name}, age = #{age}, email = #{email} WHERE id = #{id}
    </update>
    <delete id="delete" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

五、使用 MyBatis

在主程序中，加载 MyBatis 配置文件，获取 sqlSession 对象，并使用它执行数据库操作：

package com.example;

import com.example.mapper.UserMapper;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        try {
            // 加载 MyBatis 配置文件
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
            // 获取 sqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
            // 获取 Mapper 接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 执行数据库操作
            List<User> users = userMapper.findAll();
            for (User user : users) {
                System.out.println(user);
            }
            sqlSession.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

通过以上步骤，你就可以轻松地使用 MyBatis 进行数据库操作了。MyBatis 的强大之处在于其灵活的配置和高效的数据库操作能力，希望这篇文章能帮助你快速上手 MyBatis。

-- 展开阅读全文 --