正文

学会MyBatis：从入门到实战，轻松搭建Java项目数据库层

/0 浏览量
0819

在这个数字化时代，数据库是存储和检索数据的重要工具。而MyBatis作为Java中一款强大的持久层框架，已经成为众多开发者构建数据库层的不二选择。本文将带领大家从MyBatis的基础知识入手，一步步深入，直至能够独立搭建一个Java项目的数据库层。

一、MyBatis简介

1.1 什么是MyBatis？

MyBatis是一个半自动化的持久层框架，它将接口和XML映射文件结合，以半自动化的方式实现数据库的增删改查（CRUD）操作。相比于完全自动化的Hibernate，MyBatis更侧重于SQL映射和灵活的配置。

1.2 MyBatis的特点

  • 易于上手：无需复杂的配置，即可实现简单的CRUD操作。
  • 灵活配置：支持复杂的SQL操作，可以通过XML或注解方式灵活配置。
  • 支持自定义SQL：可以自定义查询语句，满足不同场景下的需求。

二、环境搭建

2.1 安装Java开发环境

在开始之前，请确保你的电脑上已经安装了Java开发环境。你可以从Oracle官网下载并安装JDK。

2.2 安装IDE

推荐使用IntelliJ IDEA或Eclipse等IDE，这些IDE都支持MyBatis的开发。

2.3 创建Maven项目

使用Maven来管理项目依赖，可以简化项目的构建过程。首先，创建一个新的Maven项目，然后添加以下依赖：

<dependencies>
    <!-- MyBatis核心库 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
    </dependency>
    <!-- 数据库连接池 -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>1.1.23</version>
    </dependency>
    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.26</version>
    </dependency>
</dependencies>

三、MyBatis配置

3.1 配置数据源

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

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
jdbc.username=root
jdbc.password=root

3.2 创建SqlSessionFactory

在src/main/resources目录下创建mybatis-config.xml文件，配置SqlSessionFactory：

<?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="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

四、编写Mapper接口和XML映射文件

4.1 编写Mapper接口

在com.example.mapper包下创建UserMapper.java接口，定义数据库操作的抽象方法：

package com.example.mapper;

public interface UserMapper {
    User getUserById(int id);
    void addUser(User user);
    void updateUser(User user);
    void deleteUser(int id);
}

4.2 创建XML映射文件

在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">
    <resultMap id="UserResultMap" type="User">
        <result property="id" column="id"/>
        <result property="username" column="username"/>
        <result property="email" column="email"/>
    </resultMap>
    <select id="getUserById" resultMap="UserResultMap">
        SELECT * FROM users WHERE id = #{id}
    </select>
    <insert id="addUser" parameterType="User">
        INSERT INTO users (username, email) VALUES (#{username}, #{email})
    </insert>
    <update id="updateUser" parameterType="User">
        UPDATE users SET username = #{username}, email = #{email} WHERE id = #{id}
    </update>
    <delete id="deleteUser">
        DELETE FROM users WHERE id = #{id}
    </delete>
</mapper>

五、使用MyBatis操作数据库

5.1 创建Service层

在com.example.service包下创建UserService.java接口，定义用户操作的抽象方法：

package com.example.service;

public interface UserService {
    User getUserById(int id);
    void addUser(User user);
    void updateUser(User user);
    void deleteUser(int id);
}

5.2 实现Service接口

在com.example.service.impl包下创建UserServiceImpl.java类，实现UserService接口：

package com.example.service.impl;

import com.example.mapper.UserMapper;
import com.example.model.User;
import com.example.service.UserService;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

public class UserServiceImpl implements UserService {
    private final SqlSessionFactory sqlSessionFactory;

    public UserServiceImpl(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }

    @Override
    public User getUserById(int id) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            return mapper.getUserById(id);
        }
    }

    @Override
    public void addUser(User user) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            mapper.addUser(user);
            session.commit();
        }
    }

    @Override
    public void updateUser(User user) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            mapper.updateUser(user);
            session.commit();
        }
    }

    @Override
    public void deleteUser(int id) {
        try (SqlSession session = sqlSessionFactory.openSession()) {
            UserMapper mapper = session.getMapper(UserMapper.class);
            mapper.deleteUser(id);
            session.commit();
        }
    }
}

5.3 使用MyBatis操作数据库

现在，你可以使用MyBatis操作数据库了。以下是一个简单的示例：

package com.example.demo;

import com.example.model.User;
import com.example.service.UserService;
import org.apache.ibatis.session.SqlSessionFactory;

public class Main {
    public static void main(String[] args) {
        SqlSessionFactory sqlSessionFactory = ... // 创建SqlSessionFactory
        UserService userService = new UserServiceImpl(sqlSessionFactory);
        User user = userService.getUserById(1);
        System.out.println("User: " + user.getUsername());
    }
}

通过以上步骤，你已经成功搭建了一个使用MyBatis的Java项目数据库层。希望这篇文章能帮助你快速上手MyBatis，祝你学习愉快！

-- 展开阅读全文 --