正文

Java开源框架MyBatis快速入门指南，教你轻松掌握高效SQL映射！

/0 浏览量
0610

引言

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

本文将为你提供一个快速入门指南，让你轻松掌握MyBatis的使用，实现高效的SQL映射。

1. MyBatis的核心组件

1.1 SqlSessionFactory

SqlSessionFactory是一个接口，它负责创建SqlSession对象。SqlSession是MyBatis的核心接口，它包含执行SQL语句所需的所有方法。

1.2 SqlSession

SqlSession负责执行SQL语句，获取Mapper接口，管理事务等。每一个数据库操作都由SqlSession负责。

1.3 Mapper

Mapper是一个接口，它包含了针对数据库中表的操作方法。MyBatis会根据XML配置或注解将接口和Java的POJOs映射成数据库中的记录。

2. 快速搭建MyBatis环境

2.1 添加依赖

在项目的pom.xml文件中添加以下依赖：

<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.2 创建配置文件

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

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

2.3 创建Mapper接口

在src/main/java目录下创建UserMapper.java接口，定义针对数据库中User表的CRUD操作方法。

package com.example.mapper;

public interface UserMapper {
    int insert(User record);
    int insertSelective(User record);
    User selectByPrimaryKey(Integer id);
    int updateByPrimaryKeySelective(User record);
    int updateByPrimaryKey(User record);
    int deleteByPrimaryKey(Integer id);
}

2.4 创建Mapper XML

在src/main/resources目录下创建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">
    <insert id="insert" parameterType="User">
        INSERT INTO user (name, age, email)
        VALUES (#{name}, #{age}, #{email})
    </insert>
    <select id="selectByPrimaryKey" parameterType="int" resultType="User">
        SELECT id, name, age, email
        FROM user
        WHERE id = #{id}
    </select>
    <update id="updateByPrimaryKeySelective" parameterType="User">
        UPDATE user
        <set>
            <if test="name != null">name = #{name},</if>
            <if test="age != null">age = #{age},</if>
            <if test="email != null">email = #{email}</if>
        </set>
        WHERE id = #{id}
    </update>
    <delete id="deleteByPrimaryKey" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

3. 使用MyBatis

3.1 创建SqlSessionFactory

public class MyBatisUtil {
    public static SqlSessionFactory getSqlSessionFactory() throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        return sqlSessionFactory;
    }
}

3.2 使用Mapper

public class UserMapperTest {
    public static void main(String[] args) throws IOException {
        SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
        try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
            UserMapper mapper = sqlSession.getMapper(UserMapper.class);
            // 创建用户
            User user = new User();
            user.setName("张三");
            user.setAge(20);
            user.setEmail("zhangsan@example.com");
            mapper.insert(user);
            sqlSession.commit();
            // 查询用户
            user = mapper.selectByPrimaryKey(1);
            System.out.println(user);
            // 更新用户
            user.setEmail("zhangsan_new@example.com");
            mapper.updateByPrimaryKeySelective(user);
            sqlSession.commit();
            // 删除用户
            mapper.deleteByPrimaryKey(1);
            sqlSession.commit();
        }
    }
}

4. 总结

通过本文的介绍，相信你已经对MyBatis有了初步的了解。MyBatis可以帮助你快速实现高效的SQL映射，提高开发效率。在实际应用中，你可以根据自己的需求进行更深入的学习和实践。

希望本文对你有所帮助！

-- 展开阅读全文 --