正文

学会MyBatis，轻松实现数据库操作：从入门到项目实战攻略

/0 浏览量
0418

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

第一节：MyBatis 简介

什么是 MyBatis？

MyBatis 允许你采用 SQL 映射语言，将 SQL 语句映射到 Java 接口上。这种映射语言叫做 MyBatis 的 XML 映射文件。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。

MyBatis 的优势

  • 简化数据库操作：通过 XML 或注解的方式，将 SQL 语句与 Java 代码分离，提高代码的可读性和可维护性。
  • 支持自定义 SQL：可以自定义复杂的 SQL 语句，实现动态 SQL、分页查询等功能。
  • 易于集成：MyBatis 可以与 Spring 等主流框架集成，提高开发效率。

第二节：MyBatis 入门

环境搭建

  1. 安装 JDK：MyBatis 需要 JDK 1.6 或更高版本。
  2. 安装 MySQL：搭建一个 MySQL 数据库环境。
  3. 添加 MyBatis 依赖：在项目的 pom.xml 文件中添加 MyBatis 的依赖。
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.3</version>
</dependency>
  1. 配置 MyBatis：创建 mybatis-config.xml 文件，配置数据源、事务管理器等。
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

创建映射文件

在 com/example/mapper 目录下创建 UserMapper.xml 文件，定义 SQL 映射语句。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
</mapper>

编写接口

在 com.example.mapper 目录下创建 UserMapper.java 接口。

package com.example.mapper;

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

使用 MyBatis

在项目中引入 MyBatis 的依赖后，就可以使用 MyBatis 进行数据库操作了。

public class Main {
    public static void main(String[] args) throws Exception {
        // 创建 SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));
        
        // 获取 SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        // 获取 Mapper 接口
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        
        // 查询用户信息
        User user = userMapper.selectById(1);
        System.out.println(user);
        
        // 关闭 SqlSession
        sqlSession.close();
    }
}

第三节：MyBatis 高级功能

动态 SQL

MyBatis 支持动态 SQL，可以使用 <if>、<choose>、<foreach> 等标签实现复杂的 SQL 语句。

缓存机制

MyBatis 提供了两种缓存机制：一级缓存和二级缓存。一级缓存是本地缓存，二级缓存是分布式缓存。

插件

MyBatis 支持插件机制，可以自定义插件扩展 MyBatis 的功能。

第四节：MyBatis 项目实战

创建项目

  1. 创建 Spring Boot 项目：使用 Spring Initializr 创建一个 Spring Boot 项目。
  2. 添加 MyBatis 依赖：在项目的 pom.xml 文件中添加 MyBatis 和 MySQL 的依赖。
<dependencies>
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.1.3</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>
  1. 配置 MyBatis：在 application.properties 文件中配置数据源。
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

创建实体类

在 com.example.entity 目录下创建 User.java 实体类。

package com.example.entity;

public class User {
    private Integer id;
    private String name;
    // ... getter 和 setter 方法
}

创建 Mapper 接口

在 com.example.mapper 目录下创建 UserMapper.java 接口。

package com.example.mapper;

public interface UserMapper {
    User selectById(Integer id);
    List<User> selectAll();
}

创建映射文件

在 com.example.mapper 目录下创建 UserMapper.xml 文件，定义 SQL 映射语句。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM users WHERE id = #{id}
    </select>
    <select id="selectAll" resultType="com.example.entity.User">
        SELECT * FROM users
    </select>
</mapper>

使用 MyBatis

在 Spring Boot 应用中，可以使用 MyBatis 的 @Mapper 注解自动扫描 Mapper 接口。

@Mapper
public interface UserMapper {
    User selectById(Integer id);
    List<User> selectAll();
}

测试 MyBatis

  1. 创建测试类：创建 UserMapperTest.java 测试类。
  2. 编写测试用例：编写测试用例，测试 MyBatis 的功能。
package com.example.mapper;

import org.junit.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import static org.junit.Assert.*;

@SpringBootTest
public class UserMapperTest {
    @Autowired
    private UserMapper userMapper;

    @Test
    public void testSelectById() {
        User user = userMapper.selectById(1);
        assertNotNull(user);
        assertEquals("张三", user.getName());
    }

    @Test
    public void testSelectAll() {
        List<User> users = userMapper.selectAll();
        assertNotNull(users);
        assertFalse(users.isEmpty());
    }
}

通过以上步骤，你就可以学会 MyBatis，并使用它进行数据库操作了。希望这份攻略能帮助你轻松入门 MyBatis，并在实际项目中应用它。

-- 展开阅读全文 --