正文

轻松入门MyBatis：从搭建到项目实战全攻略

/0 浏览量
0804

引言

MyBatis 是一个优秀的持久层框架，它消除了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程。在这个全攻略中，我们将带你从搭建 MyBatis 环境开始，一步步深入到项目实战，让你轻松掌握 MyBatis 的使用。

一、MyBatis 简介

1.1 什么是 MyBatis？

MyBatis 是一个半自动化的持久层框架，它将 SQL 映射文件、接口和 Java 对象映射起来，从而将 Java 对象和数据库表进行映射。

1.2 MyBatis 的优势

  • 简化 JDBC 代码
  • 提高开发效率
  • 良好的扩展性
  • 支持自定义 SQL 映射

二、搭建 MyBatis 环境

2.1 准备工作

  • Java 开发环境
  • Maven 或 Gradle 依赖管理工具
  • MySQL 数据库

2.2 创建 Maven 项目

  1. 在 Maven 的官网下载最新版本的 Maven 安装包。
  2. 解压安装包，配置环境变量。
  3. 打开命令行窗口，输入 mvn -v 验证是否安装成功。

2.3 添加依赖

在项目的 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.8</version>
    </dependency>
</dependencies>

2.4 配置数据库连接

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

# 数据库连接信息
jdbc.url=jdbc:mysql://localhost:3306/your_database
jdbc.username=root
jdbc.password=your_password
jdbc.driver=com.mysql.cj.jdbc.Driver

三、编写 MyBatis 映射文件

3.1 创建 Mapper 接口

在 src/main/java 目录下创建对应的 Mapper 接口：

package com.example.mapper;

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

3.2 编写 XML 映射文件

在 src/main/resources 目录下创建对应的 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="findAll" resultType="com.example.entity.User">
        SELECT * FROM user
    </select>
</mapper>

3.3 创建 SqlSessionFactory

在 src/main/java 目录下创建 SqlSessionFactoryBuilder 类：

package com.example;

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

public class SqlSessionFactoryBuilder {
    public static SqlSessionFactory build() throws Exception {
        String resource = "application.properties";
        Properties props = PropertiesUtil.loadProperties(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(props);
        return sqlSessionFactory;
    }
}

四、使用 MyBatis 操作数据库

4.1 编写 Service 层

在 src/main/java 目录下创建 UserService 类：

package com.example.service;

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

import java.util.List;

public class UserService {
    private final UserMapper userMapper;

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

    public List<User> findAll() {
        return userMapper.findAll();
    }
}

4.2 编写 Controller 层

在 src/main/java 目录下创建 UserController 类：

package com.example.controller;

import com.example.entity.User;
import com.example.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping("/users")
    public List<User> getAllUsers() {
        return userService.findAll();
    }
}

4.3 运行项目

启动项目，访问 http://localhost:8080/users，即可查看数据库中的用户信息。

五、项目实战

在实际项目中，MyBatis 可以与 Spring、Spring MVC 等框架结合使用，实现更强大的功能。以下是一个简单的项目实战示例：

  1. 创建 Spring Boot 项目。
  2. 添加 MyBatis 和 MySQL 依赖。
  3. 配置数据库连接信息。
  4. 编写 Mapper 接口和 XML 映射文件。
  5. 编写 Service 层和 Controller 层。
  6. 运行项目。

通过以上步骤，你就可以在项目中使用 MyBatis 进行数据库操作了。

结语

本文从搭建 MyBatis 环境开始，逐步深入到项目实战，带你轻松入门 MyBatis。希望这篇文章能帮助你更好地理解和掌握 MyBatis 的使用。在实际项目中，你可以根据自己的需求进行扩展和优化，让 MyBatis 为你的项目带来更多便利。

-- 展开阅读全文 --