Mybatis详解

最新推荐文章于 2025-06-19 21:00:54 发布

原创

最新推荐文章于 2025-06-19 21:00:54 发布 · 1.2k 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #java #sql

MyBatis

一、MyBatis 概述
- 1. MyBatis介绍
- 2. 依赖介绍
二、工程搭建
三、配置文件
四、映射文件
五、注解映射

一、MyBatis 概述

1. MyBatis介绍

Clinton Begin在2002年发起iBATIS项目，此后不久将项目捐献给了Apache Software Foundation，2010年这个项目由Apache Software Foundation迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

2. 依赖介绍

Mybatis的zip发行文件中除了核心jar文件外，还有其他jar，以下为各个jar的说明
1）、要使用 MyBatis，只需将 mybatis-x.x.x.jar 文件置于 classpath 中即可
2）、以下这四个文件，除cglib和asm外都放入了 mybatis-x.x.x.jar文件中， mybatis加入了新的
classloader，classloader首先在classpath中找对应的类文件，如果找不到会在mybatis-x.x.x.jar
文件中查找

**动态代理工具：**
	1. cglib:
		asm-x.x：字节码工具
		cglib-x.x代理生成工具
	2. javassist
		javassist-x.x：字节码工具，生成代理
	如果延迟加载的话，需要为业务实体对象（bo、vo）生成代理，代理对象类的生成采用
	cglib或者javassist，而cglib在处理字节码的地方采用了asm。可以通过配置项
	proxyFactory=CGLIB|JAVASSIST修改代理类生成的方式，默认是javassist。Mapper接
	口的代理是使用JDK动态代理生成的，不需要这些。
**对象图导航包：**
ognl-x.x：在动态构建SQL语句的时使用,${}

3）、mybatis对日志进行了对应的封装，根据配置项加载对应的日志实现类

<setting name="logImpl" value="LOG4J2" />

可选的值：SLF4J、LOG4J、LOG4J2、JDK_LOGGING、COMMONS_LOGGING、
STDOUT_LOGGING、NO_LOGGING

4）、ant：ant的两个包是cglib的编译依赖，cglib中使用了ant的类文件
Mybatis依赖说明：地址

二、工程搭建

1. 工程依赖

Mybatis的依赖项可以先下载好，然后导入工程。如果是Maven工程，使用Maven的依赖管理导入。以
下为MyBatis的pom文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.demo</groupId>
    <artifactId>mybatis</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>mybatis</name>
    <properties>
        <!-- maven：编译版本,源码 字符集，或者可以配置maven-compiler-plugin -->
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
        <!--依赖版本属性:版本的依赖关系可以查询maven中央仓库-->
        <log4j2-version>2.7</log4j2-version>
        <mysql-connector-java-version>8.0.17</mysql-connector-java-version>
        <mybatis-version>3.4.6</mybatis-version>
    </properties>
    <dependencies>
        <!--mysql-jdbc：mysql必选，JDBC驱动 -->
        <!--依赖传递导入：protobuf-java-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${
   
   mysql-connector-java-version}</version>
        </dependency>
        <!--mybatis：-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>${
   
   mybatis-version}</version>
        </dependency>
        <!--log4j-core：可选，log4j2的核心包 -->
        <!--依赖传递导入：log4j-api-->
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
            <version>${
   
   log4j2-version}</version>
        </dependency>
    </dependencies>
</project>

2. 配置文件

Mybatis是一个ORM工具，它借助JDBC完成与数据库的交互，程序中需要通过配置文件提供数据库相关
的配置信息，以及其它影响Mybatis执行过程的配置数据，在工程中创建配置文件，如：mybatisconfig.xml，以下是基本配置文件示例
1）、mybatis-config.xml
XML 配置文件中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源
（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。

<?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="oracle.jdbc.driver.OracleDriver"/>
                <property name="url"
                          value="jdbc:oracle:thin:@localhost:3306:XE"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/demo/mybatis/step01/conf/UserMapper.xml"/>
    </mappers>
</configuration>

environment 元素体中包含了事务管理和连接池的配置。
mappers 元素则是包含一组映射器（mapper），这些映射器的 XML 映射文件包含了 SQL代码和映射定义信息。

3. 映射文件

Mybatis在执行ORM的过程中，可以将Java对象数据转化为SQL，也可以将SQL
UserMapper.xm

<?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.demo.mybatis.step01.bo.UserMapper">
    <!--配置查询结果集和对象的映射，可以不进行配置，默认属性名和列名相同 -->
    <resultMap id="user" type="com.demo.mybatis.step01.bo.User">
        <id column="user_id" property="userID" jdbcType="INTEGER"/>
        <result column="user_name" property="userName"/>
        <result column="password" property="password"/>
    </resultMap>
    <select id="selectUserByID" resultMap="user">
        select * from users where user_id = #{
   
   id}
    </select>
</mapper>

在命名空间“com.demo.mybatis.step01.bo.UserMapper”中定义一个名为“selectUserByID”的映射语句 ， 命名空间是必须的，目的是区分映射语句,而且最好是和对应的Mapper接口同名

4. Mybatis API

SqlSession

使用 MyBatis 的主要 Java 接口就是 SqlSession。可以通过这个接口来执行SQL，获取执行结果。
SqlSessions 是由 SqlSessionFactory 实例创建的，而 SqlSessionFactory 本身是由SqlSessionFactoryBuilder 创建的，它可以从 XML、注解或手动配置 Java 代码来创建SqlSessionFactory。

public class Step01 {
   
   

        public static void main(String[] args) {
   
   
            String resource = "com/demo/mybatis/step01/conf/mybatis-config.xml";
            InputStream inputStream;
            try {
   
   
            // Resources 工具类，可以从 classpath 或其他位置加载资源文件。
                inputStream = Resources.getResourceAsStream(resource);
            } catch (IOException e) {
   
   
                e.printStackTrace();
                throw new RuntimeException();
            }
            // SqlSessionFactoryBuilder创建SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = new
                    SqlSessionFactoryBuilder().build(inputStream);
            //每个线程都应该有它自己的 SqlSession实例。SqlSession 的实例不是线程安全的
            SqlSession session = sqlSessionFactory.openSession();
        }
}

直接执行SQL

通过调用MyBatis中SqlSession对象的相关方法执行映射文件中配置的SQL,有一些类似DBUtils的操作
在这里插入图片描述
上述使用MyBatis的方法很简单，但是三层结构中实现起来比较繁琐，需要在DAO接口的实现类中分别
调用SQLSession对象的方法来执行映射文件中的SQL。

SqlSession session = sqlSessionFactory.openSession();
try {
   
   
	User user = (User) session.selectOne("com.demo...selectUserByID", 4);
	//session.delete("");
	//session.update();
	//session.insert()
	//session.commit();