正文

学会MyBatis，轻松构建高效Java项目：从入门到实战攻略

/0 浏览量
0512

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集，它可以让我们更高效地构建 Java 项目。本文将带你从入门到实战，逐步学会如何使用 MyBatis。

第一节：MyBatis 简介

1.1 什么是 MyBatis？

MyBatis 是一个半ORM（对象关系映射）框架，它允许你使用面向对象的编程方法来操作关系数据库。MyBatis 在 SQL 语句执行前后将数据映射到 Java 对象上，从而简化了数据库操作。

1.2 MyBatis 的特点

  • 支持定制化 SQL：允许你使用自定义的 SQL 语句来执行数据库操作。
  • 存储过程支持：可以调用数据库中的存储过程。
  • 高级映射：支持复杂的映射关系，如关联映射、集合映射等。
  • 易于集成：可以轻松地与其他框架如 Spring、Hibernate 集成。

第二节：环境搭建

2.1 创建 Maven 项目

首先，我们需要创建一个 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-project</artifactId>
    <version>1.0-SNAPSHOT</version>
</project>

2.2 添加 MyBatis 依赖

在 pom.xml 文件中添加 MyBatis 以及数据库驱动依赖。

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

第三节：配置文件

3.1 数据源配置

在 src/main/resources 目录下创建 database.properties 文件，配置数据库连接信息。

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydatabase?useSSL=false
jdbc.username=root
jdbc.password=root

3.2 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="${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>

第四节：定义 SQL 映射

4.1 创建 Mapper 接口

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

package com.example.mapper;

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

public interface UserMapper {
    List<User> getAllUsers();
    User getUserById(int id);
}

4.2 创建 SQL 映射文件

在 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="getAllUsers" resultType="com.example.model.User">
        SELECT * FROM users
    </select>
    <select id="getUserById" parameterType="int" resultType="com.example.model.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

第五节：使用 MyBatis

5.1 创建 SqlSessionFactory

在 com.example 包下创建 MyBatisUtil.java 工具类，用于获取 SqlSessionFactory。

package com.example;

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

import java.io.InputStream;

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    public static SqlSessionFactory getSqlSessionFactory() {
        if (sqlSessionFactory == null) {
            try {
                InputStream inputStream = MyBatisUtil.class.getClassLoader().getResourceAsStream("mybatis-config.xml");
                sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        return sqlSessionFactory;
    }
}

5.2 使用 MyBatis 执行查询

在 com.example 包下创建 Main.java 主类，执行查询操作。

package com.example;

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

public class Main {
    public static void main(String[] args) {
        try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            List<User> users = userMapper.getAllUsers();
            for (User user : users) {
                System.out.println(user);
            }
        }
    }
}

通过以上步骤，你已经成功地使用 MyBatis 构建了一个简单的 Java 项目。接下来，你可以根据实际需求扩展 MyBatis 的功能，例如添加增删改操作、关联映射等。祝你在 MyBatis 的学习之路上越走越远！

-- 展开阅读全文 --