正文

Java开源框架MyBatis入门必备，从零基础到项目实战！

/0 浏览量
0608

引言

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

本文将带领你从零基础开始，逐步深入学习 MyBatis，并通过一个实战项目来巩固所学知识。

一、MyBatis 简介

1.1 MyBatis 的优势

  • 简单易用：MyBatis 的学习曲线相对较平缓，易于上手。
  • 灵活配置：通过 XML 或注解进行配置，灵活方便。
  • 支持自定义：支持自定义 SQL、存储过程和 Java 类型处理器。
  • 插件机制：支持插件机制，可以扩展 MyBatis 的功能。

1.2 MyBatis 的架构

MyBatis 的架构主要由以下几个部分组成：

  • SqlSession：SqlSession 是 MyBatis 的核心接口，负责执行 SQL 语句、管理事务等。
  • Executor：Executor 负责执行 SQL 语句，并将结果转换为 Java 对象。
  • Mapper：Mapper 接口定义了数据库操作的 SQL 语句，MyBatis 会根据 Mapper 接口生成对应的 XML 文件或注解。
  • SqlSource：SqlSource 负责将 SQL 语句转换为可执行的 SQL 语句。
  • ResultSetHandler：ResultSetHandler 负责将数据库结果集转换为 Java 对象。

二、MyBatis 入门

2.1 环境搭建

  1. 下载 MyBatis：从 MyBatis 官网下载 MyBatis 的 jar 包。
  2. 添加依赖：在项目的 pom.xml 文件中添加 MyBatis 的依赖。
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>
  1. 配置 MyBatis：在 resources 目录下创建 mybatis-config.xml 文件，配置数据源、事务管理器等。
<configuration>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/test"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
</configuration>

2.2 创建 Mapper 接口

创建一个 Mapper 接口，定义数据库操作的 SQL 语句。

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

2.3 创建 Mapper XML

在 resources 目录下创建对应的 Mapper XML 文件，配置 SQL 语句。

<mapper namespace="com.example.mapper.UserMapper">
    <select id="selectById" resultType="com.example.entity.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

2.4 使用 MyBatis

创建一个 SqlSessionFactory，通过 SqlSessionFactory 创建 SqlSession，然后使用 SqlSession 执行数据库操作。

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User user = userMapper.selectById(1);
    System.out.println(user);
}

三、MyBatis 高级特性

3.1 动态 SQL

MyBatis 支持动态 SQL，可以根据条件动态生成 SQL 语句。

<select id="selectUsersByCondition" resultType="User">
    SELECT * FROM user
    <where>
        <if test="username != null">
            AND username = #{username}
        </if>
        <if test="email != null">
            AND email = #{email}
        </if>
    </where>
</select>

3.2 类型处理器

MyBatis 支持自定义类型处理器，将数据库中的数据类型转换为 Java 类型。

public class StringTypeHandler extends BaseTypeHandler<String> {
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {
        ps.setString(i, parameter);
    }

    @Override
    public String getNullableResult(ResultSet rs, String columnName) throws SQLException {
        return rs.getString(columnName);
    }

    @Override
    public String getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        return rs.getString(columnIndex);
    }

    @Override
    public String getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        return cs.getString(columnIndex);
    }
}

3.3 插件机制

MyBatis 支持插件机制，可以扩展 MyBatis 的功能。

public class MyInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 在执行 SQL 语句之前，进行一些操作
        Object result = invocation.proceed();
        // 在执行 SQL 语句之后，进行一些操作
        return result;
    }

    @Override
    public Object plugin(Object target) {
        return Plugin.wrap(target, this);
    }

    @Override
    public void setProperties(Properties properties) {
        // 设置插件配置
    }
}

四、MyBatis 项目实战

4.1 项目简介

本项目是一个简单的用户管理系统，包括用户注册、登录、查询、修改和删除等功能。

4.2 技术栈

  • 后端：Spring Boot、MyBatis
  • 前端：HTML、CSS、JavaScript
  • 数据库：MySQL

4.3 项目结构

user-manager
├── src
│   ├── main
│   │   ├── java
│   │   │   ├── com
│   │   │   │   ├── example
│   │   │   │   │   ├── controller
│   │   │   │   │   ├── service
│   │   │   │   │   ├── mapper
│   │   │   │   │   └── entity
│   │   │   │   └── Application.java
│   │   └── resources
│   │       ├── mybatis-config.xml
│   │       └── application.properties
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── ApplicationTests.java
└── pom.xml

4.4 实战步骤

  1. 创建项目：使用 Spring Initializr 创建一个 Spring Boot 项目。
  2. 添加依赖：在 pom.xml 文件中添加 Spring Boot、MyBatis 和 MySQL 的依赖。
  3. 配置 MyBatis：在 resources 目录下创建 mybatis-config.xml 文件，配置数据源、事务管理器等。
  4. 创建实体类：创建 User 实体类，对应数据库中的 user 表。
  5. 创建 Mapper 接口：创建 UserMapper 接口，定义数据库操作的 SQL 语句。
  6. 创建 Mapper XML：在 resources 目录下创建 UserMapper XML 文件，配置 SQL 语句。
  7. 创建 Service 层：创建 UserService 接口和实现类，实现用户管理的业务逻辑。
  8. 创建 Controller 层：创建 UserController 类，处理用户请求。
  9. 测试项目：使用 Postman 或浏览器测试项目功能。

五、总结

通过本文的学习，相信你已经对 MyBatis 有了一定的了解。MyBatis 是一个功能强大、灵活易用的持久层框架，可以帮助你简化数据库操作，提高开发效率。希望你在实际项目中能够灵活运用 MyBatis，将其优势发挥到极致。

-- 展开阅读全文 --