正文

新手必看：MyBatis开源框架入门教程及实际应用案例

/0 浏览量
0427

引言

MyBatis是一个优秀的持久层框架，它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis通过简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。本文将为你提供一个MyBatis的入门教程，并展示一些实际应用案例。

一、MyBatis入门

1.1 环境搭建

首先，你需要安装Java开发环境，并配置好Maven或Gradle等构建工具。以下是使用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>
        <!-- MySQL驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.26</version>
        </dependency>
        <!-- 数据库连接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.2.6</version>
        </dependency>
    </dependencies>
</project>

1.2 配置MyBatis

在src/main/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="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_example?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

1.3 创建Mapper接口和XML映射文件

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

package com.example.mapper;

import com.example.entity.User;

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

然后，在src/main/resources目录下创建对应的XML映射文件，如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="getUserById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

1.4 使用MyBatis

在Java代码中，你可以通过SqlSessionFactoryBuilder来创建SqlSessionFactory，然后通过SqlSessionFactory来创建SqlSession。

package com.example;

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 MyBatisDemo {
    public static void main(String[] args) {
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(
                Resources.getResourceAsStream("mybatis-config.xml"));
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            User user = userMapper.getUserById(1);
            System.out.println(user);
        }
    }
}

二、MyBatis实际应用案例

2.1 分页查询

在UserMapper.xml中添加分页查询的SQL语句。

<select id="getUserListByPage" resultType="com.example.entity.User">
    SELECT * FROM user LIMIT #{offset}, #{limit}
</select>

在Java代码中，调用分页查询的方法。

List<User> userList = userMapper.getUserListByPage(0, 10);

2.2 动态SQL

在UserMapper.xml中，使用<if>标签实现动态SQL。

<select id="getUserListByCondition" resultType="com.example.entity.User">
    SELECT * FROM user
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

在Java代码中，调用动态SQL查询的方法。

List<User> userList = userMapper.getUserListByCondition(name, age);

2.3 缓存

MyBatis提供了两种类型的缓存：一级缓存和二级缓存。

  • 一级缓存：本地缓存，存在于SqlSession的生命周期内。
  • 二级缓存：分布式缓存，存在于SqlSessionFactory的生命周期内。

在UserMapper.xml中，为getUserById方法添加缓存配置。

<select id="getUserById" resultType="com.example.entity.User" useCache="true">
    SELECT * FROM user WHERE id = #{id}
</select>

在Java代码中，调用查询方法，并查看缓存是否生效。

User user1 = userMapper.getUserById(1);
User user2 = userMapper.getUserById(1);
System.out.println(user1 == user2); // 输出true，表示缓存生效

结语

通过本文的介绍，相信你已经对MyBatis有了基本的了解。在实际项目中，MyBatis可以帮助你更高效地完成数据库操作。希望本文能帮助你快速入门MyBatis，并在实际应用中发挥其优势。

-- 展开阅读全文 --