正文

Java开源框架MyBatis高效入门，从搭建到实战案例全解析

/0 浏览量
0412

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

MyBatis 简介

MyBatis 的核心是 SQL 映射文件，它包含了 SQL 语句和映射规则。MyBatis 将 SQL 语句和 Java 对象之间的关系通过 XML 文件或注解进行配置，从而实现对象与数据库的交互。

环境搭建

1. 准备工作

  • JDK 1.8 或更高版本
  • Maven 或 Gradle 构建工具
  • MySQL 数据库

2. 创建 Maven 项目

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>mybatis-example</artifactId>
    <version>1.0-SNAPSHOT</version>

    <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>org.flywaydb</groupId>
            <artifactId>flyway-core</artifactId>
            <version>9.0.0</version>
        </dependency>
    </dependencies>
</project>

3. 配置 MyBatis

在 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_example?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

编写 SQL 映射文件

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

编写接口

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

package com.example.mapper;

import com.example.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Select;

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

编写 Java 对象

在 src/main/java/com/example/entity 目录下创建 User.java 类。

package com.example.entity;

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

    // getter 和 setter 方法
}

使用 MyBatis

在 src/main/java/com/example 目录下创建 Application.java 类，启动 MyBatis。

package com.example;

import com.example.mapper.UserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

public class Application {
    public static void main(String[] args) {
        try {
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build();
            SqlSession sqlSession = sqlSessionFactory.openSession();
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            User user = userMapper.selectById(1);
            System.out.println(user.getName());
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

实战案例

以下是一个简单的实战案例，演示如何使用 MyBatis 添加、查询、更新和删除用户。

1. 添加用户

在 UserMapper.xml 文件中添加以下 SQL 语句：

<insert id="insert" parameterType="com.example.entity.User">
    INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>

在 UserMapper.java 接口中添加以下方法：

@Insert("INSERT INTO user (name, age) VALUES (#{name}, #{age})")
void insert(User user);

在 Application.java 类中添加以下代码：

User user = new User();
user.setName("张三");
user.setAge(20);
userMapper.insert(user);
sqlSession.commit();

2. 查询用户

在 UserMapper.xml 文件中添加以下 SQL 语句：

<select id="selectByName" resultType="com.example.entity.User">
    SELECT * FROM user WHERE name = #{name}
</select>

在 UserMapper.java 接口中添加以下方法：

@Select("SELECT * FROM user WHERE name = #{name}")
List<User> selectByName(String name);

在 Application.java 类中添加以下代码：

List<User> users = userMapper.selectByName("张三");
for (User user : users) {
    System.out.println(user.getName());
}

3. 更新用户

在 UserMapper.xml 文件中添加以下 SQL 语句：

<update id="update" parameterType="com.example.entity.User">
    UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>

在 UserMapper.java 接口中添加以下方法：

@Update("UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}")
void update(User user);

在 Application.java 类中添加以下代码：

User user = new User();
user.setId(1);
user.setName("李四");
user.setAge(21);
userMapper.update(user);
sqlSession.commit();

4. 删除用户

在 UserMapper.xml 文件中添加以下 SQL 语句：

<delete id="delete" parameterType="int">
    DELETE FROM user WHERE id = #{id}
</delete>

在 UserMapper.java 接口中添加以下方法：

@Delete("DELETE FROM user WHERE id = #{id}")
void delete(Integer id);

在 Application.java 类中添加以下代码：

userMapper.delete(1);
sqlSession.commit();

通过以上步骤，您已经完成了 MyBatis 的搭建和实战案例解析。希望这篇文章能帮助您快速入门 MyBatis，并在实际项目中应用它。

-- 展开阅读全文 --