正文

学会MyBatis：高效构建Java项目的开源框架实战指南

/0 浏览量
0403

引言

MyBatis 是一款优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。MyBatis 通过简单的 XML 或注解用于配置和原始映射，将接口和 Java 的 POJOs（Plain Old Java Objects，简单的 Java 对象）映射成数据库中的记录。本指南将带你从入门到实战，学会如何使用 MyBatis 构建高效的 Java 项目。

MyBatis 简介

什么是 MyBatis？

MyBatis 是一个半ORM（对象关系映射）框架，它允许开发者将 SQL 语句映射到 Java 接口的操作。它不同于完全的ORM框架（如Hibernate），因为它允许开发者完全控制 SQL 语句，而不需要将 SQL 与 Java 代码分离。

MyBatis 的特点

  • 易于上手：MyBatis 使用 XML 或注解来映射 SQL，对初学者友好。
  • 灵活：允许自定义 SQL、存储过程以及高级映射。
  • 扩展性：可以扩展 MyBatis 的功能，如插件。
  • 支持多种数据库：MyBatis 不依赖于任何特定的数据库。

环境搭建

1. 添加依赖

在 Maven 项目中，添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.3</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis.caches</groupId>
        <artifactId>mybatis-redis</artifactId>
        <version>1.0.0</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>5.3.10</version>
    </dependency>
</dependencies>

2. 配置 MyBatis

在 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="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

编写 Mapper 接口

在 com.example.mapper 包下创建 UserMapper.java 接口：

package com.example.mapper;

import com.example.entity.User;

public interface UserMapper {
    User findUserById(int id);
}

编写 Mapper 映射文件

在 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">
    <select id="findUserById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

使用 MyBatis

在 Spring Boot 项目中，添加以下依赖：

<dependencies>
    <!-- ... -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.1.3</version>
    </dependency>
    <!-- ... -->
</dependencies>

在 application.properties 文件中配置数据库信息：

spring.datasource.url=jdbc:mysql://localhost:3306/your_database
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

在 Spring Boot 主类上添加 @MapperScan 注解：

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.MapperScan;

@SpringBootApplication
@MapperScan("com.example.mapper")
public class MyBatisApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyBatisApplication.class, args);
    }
}

在业务层使用 MyBatis：

package com.example.service;

import com.example.entity.User;
import com.example.mapper.UserMapper;

public class UserService {
    private final UserMapper userMapper;

    public UserService(UserMapper userMapper) {
        this.userMapper = userMapper;
    }

    public User findUserById(int id) {
        return userMapper.findUserById(id);
    }
}

总结

通过以上步骤，你已成功搭建了 MyBatis 环境，并学会了如何使用 MyBatis 构建简单的 Java 项目。在实际项目中，MyBatis 可以与 Spring Boot、Spring MVC 等框架结合使用，实现更加复杂的业务需求。希望这份指南对你有所帮助，祝你学习愉快！

-- 展开阅读全文 --