首页手记 Mybatis持久层框架资料详解与入门教程

Mybatis持久层框架资料详解与入门教程

标签：

Java SSM 数据库

概述

Mybatis是一款优秀的持久层框架，支持定制化SQL和高级映射，避免了手动设置参数和获取结果集的复杂性；本文将详细介绍Mybatis的下载与环境搭建、核心概念、基本使用、高级特性和常见问题解决方案，旨在帮助开发者全面了解Mybatis持久层框架资料。

Mybatis入门介绍

Mybatis是什么

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解进行配置和原始映射，将接口和 Java 的 POJO 用于编程，并通过 MyBatis 的强大的动态 SQL 功能，以及其它特性来完成最终操作。

Mybatis的优势与应用场景

MyBatis具有以下优势：

灵活性：MyBatis通过XML或注解可以灵活配置SQL语句，支持动态SQL，使得SQL语句的编写和维护更加方便。
性能：MyBatis的性能优于大部分框架，因为它使用了直接的SQL执行，避免了对象-关系映射的复杂性。
一对一的映射：MyBatis将数据库列直接映射为对象的属性，使得开发过程更加简单。
易于使用：MyBatis的学习曲线相对较低，对于熟悉SQL语句的开发者来说，学习成本较低。

Mybatis适用于以下场景：

需要对数据库进行复杂查询的应用。
需要对SQL执行效率进行优化、监控的应用。
需要灵活配置SQL的应用。

Mybatis的下载与环境搭建

要使用Mybatis，首先需要下载其最新版本。本文以MyBatis 3.5.7版本为例。下载完成后，将MyBatis的jar包（通常包括mybatis-3.5.7.jar, mybatis-spring-2.0.6.jar等）添加到项目的lib目录中，或者添加到项目依赖中。

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>
<dependency>
    <groupId>org.mybatis.spring</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.6</version>
</dependency>

为了配置MyBatis，需要创建一个配置文件（通常是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/mybatis"/>
                <property name="username" value="root"/>
                <property name="password" value="password"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

要完成MyBatis的环境搭建，还需要在Java代码中配置MyBatis的SqlSessionFactory。

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

import java.io.InputStream;

public class MyBatisUtil {
    private static SqlSessionFactory sqlSessionFactory;

    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

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

在Maven和Gradle项目中添加Mybatis依赖

在Maven项目中，添加以下依赖：

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.7</version>
</dependency>
<dependency>
    <groupId>org.mybatis.spring</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.6</version>
</dependency>

在Gradle项目中，添加以下依赖：

implementation 'org.mybatis:mybatis:3.5.7'
implementation 'org.mybatis.spring:mybatis-spring:2.0.6'

Mybatis的核心概念

SqlSessionFactory和SqlSession

SqlSessionFactory是MyBatis创建SqlSession的工厂。它是线程安全的，可以被自由地缓存和重用。每个应用程序只需要一个SqlSessionFactory的实例即可。

SqlSession提供了在数据库中执行SQL语句的机制。每个线程都应该获得自己的SqlSession实例。可以使用SqlSessionFactory的openSession()方法来获取SqlSession。SqlSession具有执行INSERT、UPDATE和DELETE等增删改查操作的方法。

import org.apache.ibatis.session.SqlSession;

public class MyBatisExample {
    public static void main(String[] args) {
        SqlSession sqlSession = MyBatisUtil.getSqlSessionFactory().openSession();
        try {
            // 使用SqlSession执行SQL语句
            User user = sqlSession.selectOne("com.example.mapper.UserMapper.findById", 1);
            System.out.println(user.getName());
        } finally {
            sqlSession.close();
        }
    }
}

Mapper接口与XML配置文件

Mapper接口和XML配置文件是MyBatis的核心特性。Mapper接口用于定义映射关系，XML配置文件则提供具体的SQL实现。Mapper接口是接口，不需要实现任何方法，MyBatis会根据Mapper接口的方法签名来生成对应的SQL。

例如，定义一个UserMapper接口：

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

对应的XML配置文件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.mapper.UserMapper">
    <select id="findById" resultType="com.example.model.User">
        SELECT * FROM user WHERE id = #{id}
    </select>
</mapper>

映射文件详解

映射文件中的主要元素包括resultMap, select, insert, update, delete。

resultMap：映射结果集中的列到Java对象的属性。这是MyBatis中最复杂也是最强大的元素。以下是一个resultMap的示例：

<resultMap id="userResultMap" type="com.example.model.User">
    <id property="id" column="id"/>
    <result property="name" column="name"/>
    <result property="age" column="age"/>
</resultMap>

select：定义一个查询语句，用于从数据库中选择数据。例如：

<select id="findById" resultMap="userResultMap">
    SELECT * FROM user WHERE id = #{id}
</select>

insert：定义一个插入语句，用于向数据库中插入数据。例如：

<insert id="insertUser" parameterType="com.example.model.User">
    INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>

update：定义一个更新语句，用于更新数据库中的数据。例如：

<update id="updateUser" parameterType="com.example.model.User">
    UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>

delete：定义一个删除语句，用于从数据库中删除数据。例如：

<delete id="deleteUser" parameterType="int">
    DELETE FROM user WHERE id = #{id}
</delete>

Mybatis的基本使用

CRUD操作

CRUD操作是MyBatis中最常见的操作，包括创建（Create）、读取（Read）、更新（Update）和删除（Delete）。

public interface UserMapper {
    User findById(Integer id);
    void insertUser(User user);
    void updateUser(User user);
    void deleteUser(Integer id);
}

对应的XML配置文件：

<insert id="insertUser" parameterType="com.example.model.User">
    INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>

<update id="updateUser" parameterType="com.example.model.User">
    UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}
</update>

<delete id="deleteUser" parameterType="int">
    DELETE FROM user WHERE id = #{id}
</delete>

参数绑定与结果映射

参数绑定是指将Java对象中的属性值绑定到SQL语句中。例如，在插入用户信息时，可以将User对象中的属性值绑定到SQL语句中的#{name}和#{age}。

<insert id="insertUser" parameterType="com.example.model.User">
    INSERT INTO user (name, age) VALUES (#{name}, #{age})
</insert>

结果映射是指将数据库查询结果映射到Java对象中。例如，通过resultMap将查询结果映射到User对象中。

<resultMap id="userResultMap" type="com.example.model.User">
    <id property="id" column="id"/>
    <result property="name" column="name"/>
    <result property="age" column="age"/>
</resultMap>

分页查询与动态SQL

分页查询通过ROWNUM或LIMIT来实现。例如，以下是分页查询的示例：

<select id="findUsersByPage" parameterType="int" resultType="com.example.model.User">
    SELECT * FROM user LIMIT #{offset}, #{limit}
</select>

动态SQL用于根据条件生成SQL语句。例如，以下是一个根据条件生成动态SQL的示例：

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

Mybatis与数据库交互

如何配置数据库连接

数据库连接配置通常在MyBatis的配置文件mybatis-config.xml中进行，通过<environment>标签下的<dataSource>标签来配置数据库连接信息。例如：

<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"/>
            <property name="username" value="root"/>
            <property name="password" value="password"/>
        </dataSource>
    </environment>
</environments>

配置不同类型数据库连接的具体步骤

例如，对于PostgreSQL数据库，配置如下：

<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="org.postgresql.Driver"/>
            <property name="url" value="jdbc:postgresql://localhost:5432/mybatis"/>
            <property name="username" value="postgres"/>
            <property name="password" value="password"/>
        </dataSource>
    </environment>
</environments>

使用Mybatis实现事务管理

MyBatis通过SqlSession的commit()和rollback()方法来实现事务管理。在事务处理中，通常使用SqlSession的openSession()方法来创建一个新的SqlSession实例，并在使用完后调用close()方法来关闭SqlSession。例如：

public void addUserWithTransaction(User user) {
    SqlSession sqlSession = MyBatisUtil.getSqlSessionFactory().openSession();
    try {
        sqlSession.insert("com.example.mapper.UserMapper.insertUser", user);
        sqlSession.commit();
    } catch (Exception e) {
        sqlSession.rollback();
        e.printStackTrace();
    } finally {
        sqlSession.close();
    }
}

Mybatis的高级特性

一级缓存和二级缓存

MyBatis包含一级缓存和二级缓存两种缓存机制。

一级缓存：每个SqlSession都维护了一个独立的缓存，即一级缓存。查询相同数据时，会先从缓存中获取。当事务提交或回滚后，缓存会被清空。
二级缓存：每个Mapper都有自己的二级缓存，不同SqlSession间共享。需要配置启用二级缓存。

启用二级缓存的配置如下：

<cache/>

插件开发：编写自己的拦截器

MyBatis允许开发人员通过插件的方式扩展其功能。插件通过继承Interceptor接口，重写intercept()方法来实现。例如，以下是一个简单的插件示例，用于记录SQL执行时间：

import org.apache.ibatis.executor.Executor;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.session.ResultHandler;
import org.apache.ibatis.session.defaults.DefaultSqlSession;

import java.util.Date;
import java.util.Properties;

public class PerformanceInterceptor implements org.apache.ibatis.plugin.Interceptor {
    @Override
    public Object intercept(java.lang.reflect.Invocation invocation) throws Throwable {
        Object[] args = invocation.getArguments();
        Executor executor = (Executor) args[0];
        MappedStatement mappedStatement = (MappedStatement) args[1];
        Object parameter = args[2];
        BoundSql boundSql = mappedStatement.getBoundSql(parameter);
        String sql = boundSql.getSql();
        Date start = new Date();
        Object result = invocation.proceed();
        Date end = new Date();
        System.out.println("SQL: " + sql + " 耗时：" + (end.getTime() - start.getTime()) + "ms");
        return result;
    }

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

    @Override
    public void setProperties(Properties properties) {
    }
}

配置插件：

<plugins>
    <plugin interceptor="com.example.interceptor.PerformanceInterceptor"/>
</plugins>

与Spring框架集成

MyBatis可以很好地与Spring框架集成，通过SqlSessionFactoryBean可以创建SqlSessionFactory。例如，以下是一个Spring配置文件示例，用于创建SqlSessionFactory：

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
</bean>

通过@Mapper注解可以将Mapper接口注册到Spring容器中：

import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Component;

@Mapper
public interface UserMapper {
    User findById(Integer id);
    void insertUser(User user);
    void updateUser(User user);
    void deleteUser(Integer id);
}

Mybatis常见问题及解决方案

常见错误及排查方法

在使用MyBatis过程中，常见的错误包括SQL语句错误、配置文件错误和类型转换错误。

SQL语句错误：通过MyBatis的日志功能可以查看执行的SQL语句，如果出现错误，可以检查SQL语句是否正确。
配置文件错误：可以检查mybatis-config.xml配置文件和Mapper配置文件（.xml文件）是否正确配置。
类型转换错误：如果SQL查询结果与Java对象属性类型不匹配，会出现类型转换错误。可以通过配置resultMap来指定正确的类型映射。

性能优化技巧

以下是一些常用的MyBatis性能优化技巧：

减少不必要的SQL查询：通过缓存机制减少重复查询。
批量操作：通过<foreach>标签实现批量插入或更新。
使用懒加载：对于多表关联查询，可以使用懒加载减少不必要的数据加载。
优化SQL语句：通过调整SQL语句中的条件、索引等，提高查询效率。

例如，批量插入的示例：

<insert id="batchInsert" parameterType="java.util.List">
    INSERT INTO user (name, age) VALUES
    <foreach item="item" index="index" collection="list"
             open="(" separator=")," close=")">
        #{item.name}, #{item.age}
    </foreach>
</insert>

通过以上内容，可以全面了解Mybatis的各个方面，从基础概念到高级特性和优化技巧。希望这些信息能够帮助你更好地理解和使用MyBatis。

点击查看更多内容

为 TA 点赞

若觉得本文不错，就分享一下吧！

评论

评论

共同学习，写下你的评论

评论加载中...

展开查看更多评论

作者其他优质文章

正在加载中

慕侠2389804

手记
篇

粉丝

55

获赞与收藏

156

关注作者，订阅最新文章

阅读免费教程

Java并发工具

23个小节 19277 315

Java 并发原理入门教程

26个小节 39001 568

Java 入门教程

50个小节 342044 3165

推荐

评论

收藏

共同学习，写下你的评论



感谢您的支持，我会继续努力的～

扫码打赏，你说多少就多少

赞赏金额会直接到老师账户

支付方式

打开微信扫一扫，即可进行扫码打赏哦

今天注册有机会得

100积分直接送

付费专栏免费学

大额优惠券免费领

立即参与放弃机会

点击
抽奖

慕课手记新用户专享福利

恭喜你，你的运气太好了，居然抽中了 100个积分！

恭喜你，抽中了价值元的专栏！

太棒了，直接落到你账户里！

积分商城里的罗技鼠标、机械键盘、
Kindle 阅读器、小米平衡车
Apple iPad （10.2英寸）、大额优惠券
在等着你去兑换了噢

作者：

免费赠送

兑换码：1111222211 复制

优惠券可用于购买实战课、体系课
无门槛使用

先去看看，有什么好东西马上兑换我爱学习，选课去


热搜

最近搜索清空