Java开源框架MyBatis：入门、进阶与应用实战攻略

引言

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

本文将带你从入门到进阶，最后通过实战案例来应用 MyBatis。

一、MyBatis 入门

1.1 环境搭建

首先，需要下载 MyBatis 的 jar 包以及数据库驱动的 jar 包。这里以 MySQL 为例，可以到官网下载最新的 MyBatis 以及 MySQL 驱动。

然后，创建一个 Java 项目，添加相应的依赖。

<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.22</version>
    </dependency>
</dependencies>

1.2 配置文件

创建 mybatis-config.xml 文件，配置数据库连接信息以及 MyBatis 的环境。

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

1.3 编写 Mapper 接口

创建一个 UserMapper 接口，定义所需的数据库操作方法。

package com.example.mapper;

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

1.4 编写 Mapper XML

创建一个 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">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
    <insert id="insert">
        INSERT INTO user (name, age) VALUES (#{name}, #{age})
    </insert>
    <update id="update">
        UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
    </update>
    <delete id="delete">
        DELETE FROM user WHERE id = #{id}
    </delete>
</mapper>

二、MyBatis 进阶

2.1 动态 SQL

MyBatis 支持动态 SQL，可以通过 <if>、<choose>、<when>、<otherwise> 等标签实现条件判断、选择执行等操作。

<select id="selectByCondition" resultType="com.example.entity.User">
    SELECT * FROM user
    <where>
        <if test="name != null">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

2.2 批量操作

MyBatis 支持批量操作，可以一次性插入、更新或删除多条记录。

<insert id="batchInsert">
    INSERT INTO user (name, age) VALUES
    <foreach collection="list" item="user" separator=",">
        (#{user.name}, #{user.age})
    </foreach>
</insert>

2.3 关联操作

MyBatis 支持一对一、一对多关联操作，可以通过 <resultMap> 和 <association> 标签实现。

<resultMap id="userMap" type="com.example.entity.User">
    <id column="id" property="id"/>
    <result column="name" property="name"/>
    <result column="age" property="age"/>
    <association property="address" javaType="com.example.entity.Address">
        <id column="address_id" property="id"/>
        <result column="street" property="street"/>
        <result column="city" property="city"/>
    </association>
</resultMap>

三、MyBatis 应用实战

3.1 项目搭建

创建一个 Spring Boot 项目，添加 MyBatis 依赖。

<dependencies>
    <!-- MyBatis -->
    <dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.1.3</version>
    </dependency>
    <!-- MySQL 驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.22</version>
    </dependency>
</dependencies>

3.2 配置 MyBatis

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

spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.example.entity

3.3 编写实体类和 Mapper 接口

创建实体类 User 和 Address，以及 UserMapper 接口。

package com.example.entity;

public class User {
    private int id;
    private String name;
    private int age;
    private Address address;
    // 省略 getter 和 setter
}

package com.example.entity;

public class Address {
    private int id;
    private String street;
    private String city;
    // 省略 getter 和 setter
}

package com.example.mapper;

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

3.4 编写 Mapper XML

创建 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">
    <!-- 省略 SQL 映射 -->
</mapper>

3.5 使用 MyBatis

在 Spring Boot 应用中，通过 @MapperScan 注解扫描 Mapper 接口。

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);
    }
}

然后在业务代码中注入 UserMapper，使用 MyBatis 进行数据库操作。

package com.example.service;

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 UserService {
    @Autowired
    private UserMapper userMapper;

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

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

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

    public int delete(int id) {
        return userMapper.delete(id);
    }
}

总结

本文介绍了 MyBatis 的入门、进阶以及应用实战。MyBatis 是一个功能强大的持久层框架，能够帮助开发者简化数据库操作。通过本文的学习，相信你已经对 MyBatis 有了一个全面的认识。在实际开发中，MyBatis 可以与 Spring Boot 等框架结合使用，实现高效的数据库操作。

正文

Java开源框架MyBatis：入门、进阶与应用实战攻略

引言

一、MyBatis 入门

1.1 环境搭建

1.2 配置文件

1.3 编写 Mapper 接口

1.4 编写 Mapper XML

二、MyBatis 进阶

2.1 动态 SQL

2.2 批量操作

2.3 关联操作

三、MyBatis 应用实战

3.1 项目搭建

3.2 配置 MyBatis

3.3 编写实体类和 Mapper 接口

3.4 编写 Mapper XML

3.5 使用 MyBatis

总结

相关阅读

揭秘Java项目框架：从小白到精通，轻松构建高效软件

Java开源框架MyBatis快速入门，轻松实现数据库操作，助你成为数据库管理高手

揭秘Java开源框架MyBatis：高效数据库操作，入门实战攻略与最佳实践

Java项目框架，轻松入门实战指南，带你掌握核心技术

掌握TypeScript，轻松驾驭前端框架：揭秘Vue、React、Angular三大热门选择！

轻松上手JeecgBoot框架：从入门到实战，打造高效Java项目

告别繁琐开发！盘点5大主流Web表单开发框架，提升效率轻松建表单

揭秘JeecgBoot：轻松集成Shiro安全框架，提升项目安全性及用户体验

揭秘Java项目框架：从入门到实战，高效开发不再难

新手必看！JeecgBoot框架入门教程，轻松掌握企业级应用开发