正文

手把手教你入门Java开源框架MyBatis，高效提升项目开发效率

/0 浏览量
0722

在Java开发领域，MyBatis是一个广泛使用的持久层框架，它能够帮助开发者更高效地完成数据库操作。MyBatis通过XML或注解的方式配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。下面，我将带你一步步入门MyBatis，让你在项目中能够高效地使用它。

一、MyBatis简介

MyBatis最初由原始的持久层框架Hibernate启发，旨在解决Hibernate的一些问题，如性能、灵活性和易用性。MyBatis的核心是SQL映射文件，它允许开发者将SQL语句与Java代码分离，使得代码更加清晰。

二、环境搭建

1. 创建Maven项目

首先，你需要创建一个Maven项目。在项目的pom.xml文件中，添加以下依赖：

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

2. 配置数据库连接

在项目的resources目录下创建一个名为db.properties的文件，配置数据库连接信息：

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
username=root
password=root

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="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

三、创建Mapper接口和XML映射文件

1. 创建Mapper接口

在com.example.mapper包下创建一个名为UserMapper.java的接口：

package com.example.mapper;

import com.example.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

@Mapper
public interface UserMapper {
    @Select("SELECT * FROM user WHERE id = #{id}")
    User findUserById(Integer id);
}

2. 创建XML映射文件

在com/example/mapper包下创建一个名为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">
    <resultMap id="userResultMap" type="com.example.entity.User">
        <id property="id" column="id"/>
        <result property="username" column="username"/>
        <result property="password" column="password"/>
    </resultMap>
    <select id="findUserById" resultMap="userResultMap">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

四、使用MyBatis

1. 创建MyBatis的SqlSessionFactory

在com.example.mapper包下创建一个名为MyBatisUtil.java的类，用于创建SqlSessionFactory：

package com.example.mapper;

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

import java.io.InputStream;

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

2. 使用MyBatis操作数据库

在com.example.service包下创建一个名为UserService.java的类，用于操作数据库：

package com.example.service;

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

public class UserService {
    private static SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();

    public static User findUserById(Integer id) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            return mapper.findUserById(id);
        }
    }
}

3. 测试

在com.example.Application类中，添加以下测试代码：

package com.example;

import com.example.service.UserService;
import org.junit.Test;

public class Application {
    @Test
    public void testFindUserById() {
        User user = UserService.findUserById(1);
        System.out.println(user);
    }
}

运行测试代码，输出结果如下：

User{id=1, username='admin', password='123456'}

至此，你已经成功入门MyBatis，并能够使用它来高效地完成数据库操作。在实际项目中，你可以根据需要添加更多的功能，如分页、缓存等。希望这篇文章能帮助你更好地掌握MyBatis。

-- 展开阅读全文 --