正文

轻松入门Java开源框架MyBatis：从搭建环境到实战项目

/0 浏览量
0829

引言

在Java开发领域，MyBatis是一个广泛使用的持久层框架，它允许开发者以简单的方式将SQL语句与Java代码结合，从而实现数据持久化。本文将带领你从搭建开发环境开始，一步步学习如何使用MyBatis，并通过一个实战项目来加深理解。

一、MyBatis简介

MyBatis是一个半ORM（对象关系映射）框架，它将SQL语句与Java代码分离，使开发者能够更加专注于业务逻辑的实现。MyBatis的核心是SQL映射文件，它定义了SQL语句与Java对象之间的映射关系。

二、搭建开发环境

1. 安装Java开发工具包（JDK）

首先，确保你的计算机上安装了JDK。你可以从Oracle官网下载JDK安装包，并按照提示进行安装。

2. 安装IDE

推荐使用IntelliJ IDEA或Eclipse等IDE进行Java开发。以下以IntelliJ IDEA为例：

  • 下载并安装IntelliJ IDEA。
  • 在安装过程中，选择“Community Edition”即可。

3. 创建Maven项目

Maven是一个项目管理工具，它可以帮助我们管理项目依赖。以下以Maven 3.6.3为例：

  • 打开Maven命令行工具，运行以下命令创建项目：
mvn archetype:generate -DgroupId=com.example -DartifactId=mybatis-project -DarchetypeArtifactId=maven-archetype-quickstart
  • 创建完成后，进入项目目录，运行以下命令安装依赖：
mvn install

三、配置MyBatis

1. 添加依赖

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

<dependencies>
    <!-- MyBatis依赖 -->
    <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>

2. 配置数据库

在src/main/resources目录下创建一个名为application.properties的文件，并添加以下内容：

# 数据库配置
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db?useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=root

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="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

四、创建实体类和Mapper接口

1. 创建实体类

在src/main/java/com/example/mybatisproject目录下创建一个名为User的实体类：

package com.example.mybatisproject;

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

    // 省略getter和setter方法
}

2. 创建Mapper接口

在src/main/java/com/example/mybatisproject目录下创建一个名为UserMapper的接口：

package com.example.mybatisproject;

import com.example.mybatisproject.User;

public interface UserMapper {
    User getUserById(Integer id);
}

五、编写SQL映射文件

在src/main/resources目录下创建一个名为UserMapper.xml的文件，并添加以下内容：

<?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.mybatisproject.UserMapper">
    <select id="getUserById" resultType="com.example.mybatisproject.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

六、使用MyBatis

1. 创建SqlSessionFactory

在src/main/java/com/example/mybatisproject目录下创建一个名为MyBatisUtil的工具类：

package com.example.mybatisproject;

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

public class MyBatisUtil {
    public static SqlSessionFactory getSqlSessionFactory() throws Exception {
        String resource = "mybatis-config.xml";
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resource);
        return sqlSessionFactory;
    }
}

2. 使用MyBatis执行SQL

在src/main/java/com/example/mybatisproject目录下创建一个名为App的主类：

package com.example.mybatisproject;

import org.apache.ibatis.session.SqlSession;

public class App {
    public static void main(String[] args) {
        try (SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession()) {
            UserMapper userMapper = session.getMapper(UserMapper.class);
            User user = userMapper.getUserById(1);
            System.out.println(user);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行App主类，输出结果如下：

User{id=1, name='张三', email='zhangsan@example.com'}

七、总结

通过本文的学习，你已成功搭建了MyBatis开发环境，并创建了一个简单的实战项目。接下来，你可以继续学习MyBatis的高级功能，如动态SQL、插件等。祝你学习愉快！

-- 展开阅读全文 --