正文

Java开源框架MyBatis入门实战：从搭建环境到项目应用全解析

/0 浏览量
0520

在Java开发领域，MyBatis是一个非常受欢迎的开源持久层框架。它简化了数据库操作，允许开发者用更接近SQL的方式来操作数据库。本文将带领大家从搭建环境开始，一步步深入学习MyBatis，直至应用到实际项目中。

1. 环境搭建

1.1 Java环境

首先，确保你的电脑上安装了Java开发环境。你可以通过访问Oracle官网下载并安装Java。

1.2 Maven

Maven是一个项目管理和构建自动化工具，可以帮助我们管理项目依赖。下载并安装Maven，然后配置环境变量。

1.3 MySQL数据库

下载并安装MySQL数据库，创建一个用于练习的数据库。

2. 创建Maven项目

使用Maven创建一个新的Java项目，并添加以下依赖：

<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.22</version>
    </dependency>
    <!-- Log4j日志依赖 -->
    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.13.3</version>
    </dependency>
</dependencies>

3. 配置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_db?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <!-- 配置映射器 -->
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

4. 编写Mapper接口

在src/main/java/com/example/mapper目录下创建一个名为UserMapper.java的接口，定义数据库操作的方法：

package com.example.mapper;

public interface UserMapper {
    List<User> findAll();
    User findById(int id);
    int insert(User user);
    int update(User user);
    int delete(int id);
}

5. 编写Mapper XML

在src/main/resources/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="findAll" resultType="com.example.entity.User">
        SELECT * FROM user
    </select>

    <select id="findById" parameterType="int" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>

    <insert id="insert" parameterType="com.example.entity.User">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>

    <update id="update" parameterType="com.example.entity.User">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>

    <delete id="delete" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

6. 编写实体类

在src/main/java/com/example/entity目录下创建一个名为User.java的实体类：

package com.example.entity;

public class User {
    private int id;
    private String name;
    private int age;

    // 省略getter和setter方法
}

7. 编写测试类

在src/test/java/com/example目录下创建一个名为UserMapperTest.java的测试类，测试MyBatis功能：

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;
import org.junit.BeforeClass;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    private static SqlSessionFactory sqlSessionFactory;

    @BeforeClass
    public static void setUp() throws Exception {
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(UserMapperTest.class.getClassLoader().getResourceAsStream("mybatis-config.xml"));
    }

    @Test
    public void testFindAll() {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            List<User> users = mapper.findAll();
            System.out.println(users);
        }
    }
}

8. 运行测试

运行UserMapperTest类中的testFindAll方法，查看控制台输出结果。

通过以上步骤，你已经成功搭建了MyBatis环境，并实现了对数据库的基本操作。接下来，你可以根据实际需求，进一步学习MyBatis的高级特性，如动态SQL、缓存等。祝你学习愉快！

-- 展开阅读全文 --