正文

学会MyBatis：高效Java开源框架入门与实战指南

/0 浏览量
0508

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

MyBatis 简介

MyBatis 本是 Apache 组织的一个开源项目，2010 年 10 月由敏捷开发软件公司 MyBatis.org 负责维护。它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。

MyBatis 的特点

  • 简单的 XML 或注解用于配置和原始映射：MyBatis 使用 XML 或注解来配置 SQL 映射，使得配置更加灵活。
  • 接口和 Java 的 POJOs 映射：MyBatis 将接口和 Java 的 POJOs 映射成数据库中的记录，简化了数据持久层的开发。
  • 支持定制化 SQL、存储过程以及高级映射：MyBatis 支持复杂的 SQL 映射，如关联查询、延迟加载等。

MyBatis 入门

1. 环境搭建

要开始使用 MyBatis，首先需要搭建一个 Java 开发环境。以下是一个简单的步骤：

  1. 安装 JDK：下载并安装 JDK，配置环境变量。
  2. 安装 Maven：下载并安装 Maven，配置环境变量。
  3. 创建 Maven 项目：使用 Maven 创建一个新的 Java 项目。
  4. 添加 MyBatis 依赖：在项目的 pom.xml 文件中添加 MyBatis 依赖。
<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.3</version>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-dbcp2</artifactId>
        <version>2.8.0</version>
    </dependency>
</dependencies>

2. 配置 MyBatis

创建一个 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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_db"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

3. 创建 Mapper 接口

创建一个 UserMapper.java 接口，定义数据访问方法。

package com.example.mapper;

import java.util.List;

public interface UserMapper {
    List<User> findAll();
}

4. 创建 Mapper XML 文件

创建一个 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="findAll" resultType="com.example.entity.User">
        SELECT * FROM user
    </select>
</mapper>

5. 使用 MyBatis

在 Java 代码中，创建 SqlSessionFactory 和 SqlSession，然后使用 SqlSession 调用 Mapper 接口的方法。

public class Main {
    public static void main(String[] args) {
        try {
            // 创建 SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));
            // 创建 SqlSession
            SqlSession sqlSession = sqlSessionFactory.openSession();
            // 获取 Mapper 接口
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
            // 调用方法
            List<User> users = userMapper.findAll();
            // 输出结果
            for (User user : users) {
                System.out.println(user);
            }
            // 关闭 SqlSession
            sqlSession.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

MyBatis 实战

1. 分页查询

MyBatis 支持分页查询，可以通过 <select> 标签的 limit 属性实现。

<select id="findPage" resultType="com.example.entity.User">
    SELECT * FROM user LIMIT #{offset}, #{limit}
</select>

2. 关联查询

MyBatis 支持关联查询，可以通过 <resultMap> 标签实现。

<resultMap id="userMap" type="com.example.entity.User">
    <id property="id" column="id"/>
    <result property="name" column="name"/>
    <result property="age" column="age"/>
    <association property="address" javaType="com.example.entity.Address">
        <id property="id" column="address_id"/>
        <result property="street" column="street"/>
        <result property="city" column="city"/>
    </association>
</resultMap>

3. 动态 SQL

MyBatis 支持动态 SQL，可以通过 <if>、<choose>、<when>、<otherwise> 等标签实现。

<select id="findUsersByCondition" resultType="com.example.entity.User">
    SELECT * FROM user
    <where>
        <if test="name != null and name != ''">
            AND name = #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

总结

MyBatis 是一个优秀的持久层框架，它能够帮助开发者简化数据库操作。通过本篇文章，你了解了 MyBatis 的基本概念、入门步骤和实战应用。希望这篇文章能够帮助你更好地学习和使用 MyBatis。

-- 展开阅读全文 --