正文

Java开源框架MyBatis快速入门指南：从零基础到实战应用

/0 浏览量
0428

引言

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

本文将带领你从零基础开始，逐步学习 MyBatis 的基本概念、配置、使用方法，并最终通过一个实战项目来加深理解。

第一章：MyBatis 简介

1.1 什么是 MyBatis？

MyBatis 是一个半自动化的持久层框架，它将 SQL 映射语句存储在 XML 或注解中，并通过接口和 Java 的 POJOs 进行映射。MyBatis 可以简化数据库操作，提高开发效率。

1.2 MyBatis 的优势

  • 简单易用：MyBatis 提供了简单的 XML 或注解配置，易于上手。
  • 灵活性强：支持自定义 SQL 映射，满足复杂的业务需求。
  • 性能优化：通过缓存机制提高查询效率。

第二章：MyBatis 的环境搭建

2.1 环境准备

  • Java 开发环境：JDK 1.8 或更高版本
  • IDE：如 IntelliJ IDEA 或 Eclipse
  • Maven：用于依赖管理

2.2 创建 Maven 项目

  1. 打开 Maven 安装目录下的 bin 文件夹，运行 mvn archetype:generate 命令。
  2. 选择 maven-archetype-quickstart 模板，并输入项目名称、描述等信息。
  3. 编译项目，查看 src/main/java 目录下的代码。

2.3 添加依赖

在 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
</dependencies>

第三章：MyBatis 配置

3.1 配置文件

创建 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_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>

3.2 数据库配置

在 application.properties 文件中配置数据库连接信息。

# 数据库连接信息
spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

第四章：MyBatis 映射文件

4.1 创建 Mapper 接口

在 com.example.mapper 包下创建 UserMapper.java 接口，定义方法。

package com.example.mapper;

public interface UserMapper {
    int insert(User user);
    User selectById(int id);
    int update(User user);
    int deleteById(int id);
}

4.2 创建 Mapper 映射文件

在 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">
    <insert id="insert" parameterType="User">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>
    <select id="selectById" resultType="User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <update id="update" parameterType="User">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
    <delete id="deleteById" parameterType="int">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

第五章：MyBatis 实战应用

5.1 创建实体类

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

package com.example.entity;

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

    // 省略 getter 和 setter 方法
}

5.2 创建 Service 层

在 com.example.service 包下创建 UserService.java 接口和 UserServiceImpl.java 实现类。

package com.example.service;

public interface UserService {
    int insert(User user);
    User selectById(int id);
    int update(User user);
    int deleteById(int id);
}

package com.example.service.impl;

import com.example.entity.User;
import com.example.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl implements UserService {
    @Autowired
    private UserMapper userMapper;

    @Override
    public int insert(User user) {
        return userMapper.insert(user);
    }

    @Override
    public User selectById(int id) {
        return userMapper.selectById(id);
    }

    @Override
    public int update(User user) {
        return userMapper.update(user);
    }

    @Override
    public int deleteById(int id) {
        return userMapper.deleteById(id);
    }
}

5.3 创建 Controller 层

在 com.example.controller 包下创建 UserController.java 控制器。

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.*;

@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;

    @PostMapping
    public User insert(@RequestBody User user) {
        return userService.insert(user);
    }

    @GetMapping("/{id}")
    public User selectById(@PathVariable int id) {
        return userService.selectById(id);
    }

    @PutMapping
    public User update(@RequestBody User user) {
        return userService.update(user);
    }

    @DeleteMapping("/{id}")
    public int deleteById(@PathVariable int id) {
        return userService.deleteById(id);
    }
}

5.4 运行项目

启动 Spring Boot 应用，访问以下 URL 进行测试：

  • POST /user：添加用户
  • GET /user/{id}：根据 ID 查询用户
  • PUT /user：更新用户
  • DELETE /user/{id}：根据 ID 删除用户

结语

通过本文的学习，相信你已经掌握了 MyBatis 的基本概念、配置、使用方法，并成功实现了一个简单的 CRUD 操作。在实际项目中，MyBatis 可以与 Spring Boot、Spring Cloud 等框架结合使用，实现更复杂的业务需求。希望本文能帮助你更好地掌握 MyBatis，为你的 Java 开发之路添砖加瓦。

-- 展开阅读全文 --