正文

Java开源框架MyBatis入门指南：从基础到实践，轻松上手数据库操作

/0 浏览量
0410

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

MyBatis 简介

MyBatis 遵循约定大于配置的原则，它将 SQL 映射文件、接口和 POJOs 结合起来，使得数据库操作变得简单而高效。MyBatis 在内部管理数据库连接、事务和结果集的处理，让开发者可以专注于业务逻辑的实现。

环境搭建

1. 创建项目

首先，你需要创建一个 Java 项目。这里我们使用 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.3</version>
        </dependency>
        <!-- 数据库驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.22</version>
        </dependency>
    </dependencies>
</project>

2. 配置数据库

在 src/main/resources 目录下创建 database.properties 文件，配置数据库连接信息。

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

3. 编写 Mapper 接口

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

package com.example;

import java.util.List;

public interface UserMapper {
    List<User> findAll();
}

4. 编写 XML 映射文件

在 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.UserMapper">
    <select id="findAll" resultType="com.example.User">
        SELECT * FROM user
    </select>
</mapper>

5. 配置 MyBatis

在 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/mybatis_example?useSSL=false&serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/UserMapper.xml"/>
    </mappers>
</configuration>

使用 MyBatis

1. 创建 SqlSessionFactory

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

2. 创建 SqlSession

SqlSession sqlSession = sqlSessionFactory.openSession();

3. 调用 Mapper 接口方法

UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> users = mapper.findAll();
for (User user : users) {
    System.out.println(user.getName());
}
sqlSession.close();

总结

通过以上步骤，你已经成功入门了 MyBatis。MyBatis 提供了丰富的功能和灵活的配置方式，可以帮助你轻松实现数据库操作。在实际开发中，你可以根据需求进行扩展和定制，让 MyBatis 为你的项目带来更多便利。

-- 展开阅读全文 --