Java Mybatis 框架入门教程("Java Mybatis 框架入门教程：从零基础到实战掌握")

原创

ithorizon 4周前 (10-19) 阅读数 50 #后端开发

Java Mybatis 框架入门教程：从零基础到实战掌握

一、Mybatis 简介

Mybatis 是一款优秀的持久层框架，它赞成自定义 SQL、存储过程以及高级映射。Mybatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取最终集。Mybatis 可以使用简洁的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java对象）映射成数据库中的记录。

二、Mybatis 的优势

赞成定制化 SQL、存储过程和高级映射。

灵活的映射规则。

易于上手和集成。

良好的文档和社区赞成。

三、环境搭建

在进行 Mybatis 学习之前，我们需要先搭建好开发环境。以下为环境搭建的步骤：

1. 安装 JDK

确保安装了 JDK 1.8 或更高版本。

2. 安装 Maven

Maven 是一个项目管理和构建自动化工具，它可以帮助我们管理项目依赖性、构建项目等。下载并安装 Maven。

3. 创建 Maven 项目

使用 Maven 创建一个 Java 项目，并添加 Mybatis 依赖性。


<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.22</version>
    </dependency>
</dependencies>

四、Mybatis 的核心概念

在 Mybatis 中，有几个核心概念需要了解：

1. 映射器（Mapper）

映射器是 Mybatis 的核心，它负责将 SQL 语句与 Java 方法进行映射。映射器可以是接口或 XML 文件。

2. SQL 会话（SqlSession）

SQL 会话是 Mybatis 执行 SQL 语句的环境。它提供了执行 SQL 语句和提交/回滚事务的方法。

3. SQL 映射（SqlMapping）

SQL 映射定义了 SQL 语句和映射规则。它可以是 XML 文件或注解。

五、Mybatis 的基本使用

下面将通过一个简洁的示例来展示 Mybatis 的基本使用。

1. 创建实体类

首先创建一个用户实体类 User。


public class User {
    private Integer id;
    private String username;
    private String password;
    // 省略构造方法、getter 和 setter 方法
}

2. 创建映射器接口

创建一个 UserMapper 接口，用于定义操作用户表的方法。


public interface UserMapper {
    User getUserById(Integer id);
}

3. 创建映射器 XML 文件

在 resources 目录下创建 UserMapper.xml 文件，定义 SQL 语句和映射规则。


<mapper namespace="com.example.mapper.UserMapper">
    <select id="getUserById" resultType="com.example.entity.User">
        SELECT id, username, password FROM user WHERE id = #{id}
    </select>
</mapper>

4. 配置 Mybatis

在 resources 目录下创建 mybatis-config.xml 文件，配置数据源、事务管理器等。


<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/mybatis?useUnicode=true&characterEncoding=utf-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

5. 测试 Mybatis

编写一个测试类，使用 Mybatis 执行 SQL 语句。


public class MybatisTest {
    public static void main(String[] args) throws IOException {
        InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.getUserById(1);
            System.out.println(user);
        }
    }
}