正文

Java开源框架MyBatis入门必备：从搭建到实战全解析

/0 浏览量
0428

引言

MyBatis是一个优秀的持久层框架，它消除了几乎所有的JDBC代码和手动设置参数以及获取结果集的过程。MyBatis可以通过简单的XML或注解用于配置和原始映射，将接口和Java的POJOs（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。本文将带你从搭建MyBatis环境开始，逐步深入到实战应用。

一、搭建MyBatis环境

1.1 环境准备

在开始之前，请确保你的电脑上已经安装了以下环境：

  • JDK 1.8及以上版本
  • Maven 3.0及以上版本
  • MySQL数据库

1.2 创建Maven项目

  1. 打开Maven命令行工具，创建一个新的Maven项目。
  2. 添加以下依赖到pom.xml文件中：
<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.7</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.22</version>
    </dependency>
</dependencies>

1.3 配置数据库

  1. 在MySQL中创建一个新的数据库，例如mybatis_example。
  2. 创建一个用户表user，包含id、username和password三个字段。

二、编写MyBatis配置文件

在项目的src/main/resources目录下创建一个名为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_example?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>

2.1 数据库连接配置

在上面的配置文件中，我们配置了数据库连接信息，包括驱动、URL、用户名和密码。

2.2 映射文件配置

在com/example/mapper目录下创建一个名为UserMapper.xml的文件，配置User对象的映射：

<?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>

在上面的映射文件中，我们定义了一个selectById方法，用于根据ID查询用户信息。

三、编写Mapper接口

在com/example/mapper目录下创建一个名为UserMapper.java的接口，定义selectById方法：

package com.example.mapper;

import com.example.entity.User;

public interface UserMapper {
    User selectById(int id);
}

四、使用MyBatis

4.1 创建MyBatis会话工厂

在com/example/service目录下创建一个名为MyBatisUtil.java的工具类，用于获取MyBatis会话工厂：

package com.example.service;

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

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(MyBatisUtil.class.getClassLoader(), "mybatis-config.xml");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static SqlSessionFactory getSqlSessionFactory() {
        return sqlSessionFactory;
    }
}

4.2 使用MyBatis查询数据

在com/example/service目录下创建一个名为UserService.java的服务类，用于查询用户信息：

package com.example.service;

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

public class UserService {
    public User getUserById(int id) {
        try {
            SqlSessionFactory sqlSessionFactory = MyBatisUtil.getSqlSessionFactory();
            UserMapper userMapper = sqlSessionFactory.openSession().getMapper(UserMapper.class);
            return userMapper.selectById(id);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }
}

4.3 测试MyBatis

在com.example.controller目录下创建一个名为UserController.java的控制器类，用于测试MyBatis查询功能：

package com.example.controller;

import com.example.service.UserService;
import com.example.entity.User;

import java.util.Scanner;

public class UserController {
    public static void main(String[] args) {
        UserService userService = new UserService();
        Scanner scanner = new Scanner(System.in);
        System.out.print("请输入用户ID：");
        int id = scanner.nextInt();
        User user = userService.getUserById(id);
        if (user != null) {
            System.out.println("用户名：" + user.getUsername());
            System.out.println("密码：" + user.getPassword());
        } else {
            System.out.println("未找到用户");
        }
    }
}

运行UserController类，输入用户ID，即可查询到对应的用户信息。

五、总结

本文详细介绍了Java开源框架MyBatis的入门知识，从搭建环境到实战应用，希望能帮助你快速上手MyBatis。在实际开发中，MyBatis还可以与Spring框架集成，实现更高级的功能。祝你学习愉快！

-- 展开阅读全文 --