MyBatis 入门系列【1】 入门案例

蛐蛐君2023-09-13 14:45

1. 简介

官方文档

Github地址

1.1 概述

MyBatis是一款优秀的持久层框架，它支持自定义SQL、存储过程以及高级映射。

MyBatis免除了几乎所有的JDBC代码以及设置参数和获取结果集的工作。可以通过简单的XML或注解来配置和映射原始类型、接口和Java POJO对象为数据库中的记录。

1.2 发展历史

MyBatis框架最早的名字叫iBatis，主要的历史事件如下：

  • 2001年 ，Clinton Begin发起一个开源项目iBatis1.0

  • 2005年 ，发布iBatis2.0

  • 2010年 ，发布iBatis3.0，iBatis在这之前都是由Apache组织管理

  • 2010年6月份 ，iBatis项目交由谷歌公司托管并改名为MyBatis

  • 2013年11月 ，整个项目迁移至GitHub

  • 2019年10月 ，发布MyBatis3.5.3

1.3 ORM、Hibernate、JPA

1.3.1 ORM

ORM（Object Relational Mapping）：对象关系映射，是一种设计思想，是为了解决面向对象与关系数据库存在的互不匹配的现象。ORM通过使用描述对象和数据库之间映射的元数据，将程序中的对象自动持久化到关系数据库中。

1.3.2 JPA

全称Java Persistence API，可以通过注解或者XML描述【对象-关系表】之间的映射关系，并将实体对象持久化到数据库中。

JPA仅仅是一种规范，也就是说JPA仅仅定义了一些接口，而接口是需要实现才能工作的。所以底层需要某种实现。

JPA是一套实现ORM理论的接口，没有实现代码。

1.3.3 Hibernate

Hibernate是由Gavin King于2001 年创建的开放源代码的对象关系框架。它强大且高效的构建具有关系对象持久性和查询服务的Java应用程序。

Hibernate将Java类映射到数据库表中，从Java数据类型中映射到SQL数据类型中，并把开发人员从95% 的公共数据持续性编程工作中解放出来。

Hibernate是传统Java对象和数据库服务器之间的桥梁，用来处理基于O/R映射机制和模式的那些对象。

而Mybatis是一个半自动的ORM框架，相对于Hibernate来说，功能可能没有那么强大，但是其也有自身诸多优点，比如简单易用、自己编写SQL可方便排错及调优等等。所以，目前国内大部分公司都采用Mybatis框架。

2. 入门案例

源码地址

2.1 环境搭建

创建一个Maven工程，引入Mybatis、Mysql驱动、Lombok、Logback等依赖：

xml 复制代码 
<?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>org.example</groupId>
    <artifactId>mybatis-demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
        <!--Mysql 驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.25</version>
        </dependency>
        <!--lombok-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.20</version>
        </dependency>
        <!--logback日志-->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.7</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-core</artifactId>
            <version>1.1.7</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-access</artifactId>
            <version>1.1.7</version>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.1.7</version>
        </dependency>
    </dependencies>
    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <!--idea默认不会编译src的java目录的xml文件-->
                <includes>
                    <!--配置将src源代码下的xml等资源文件编译进classes文件夹-->
                    <include>**/*.xml</include>
                </includes>
            </resource>
        </resources>
    </build>
</project>

添加日志配置文件logback.xml，方便打印分析日志：

xml 复制代码 
<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <!-- encoders are assigned the type
             ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
        <encoder>
            <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>
    <root level="debug">
        <appender-ref ref="STDOUT" />
    </root>
</configuration>

添加MyBatis全局配置文件 ，配置文件中包含了对MyBatis的核心设置，包括获取数据库连接实例的数据源（DataSource），以及决定事务作用域和控制方式的事务管理器（TransactionManager）。

XML头部的声明，用来验证XML文档的正确性。environment元素体中包含了事务管理和连接池的配置。mappers元素则包含了一组映射器（mapper），这些映射器的XML映射文件包含了SQL语句和映射定义信息。

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="com.mysql.cj.jdbc.Driver"/>
                <!--数据库地址-->
                <property name="url"
                          value="jdbc:mysql://127.0.0.1:3306/angel_admin?serverTimezone=Asia/Shanghai"/>
                <!--用户名-->
                <property name="username" value="root"/>
                <!--密码-->
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 添加mapper XML所在文件夹-->
    <mappers>
        <package name="org.pearl.mybatis.demo.dao"/>
    </mappers>
</configuration>

2.2 执行

在数据库中导入用户表Sql脚本（源码地址中）：

添加用户表对应的实体类：

java 复制代码 
@Data
public class User implements Serializable {

    private static final long serialVersionUID = 1L;

    private Long userId;

    private String userName;

    private String loginName;

    private Integer gender;

    private String phone;

    private String address;

    private Integer organizationId;

    private Boolean state;

    private String email;

    private Integer createUserId;

    private Date modifyDate;

    private Date createDate;

    private String password;
}

添加用户表对应的UserMapper接口及XML文件，添加根据ID查询用户的SQL：

java 复制代码 
public interface UserMapper {
    User selectOneById(Long id);
}
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="org.pearl.mybatis.demo.dao.UserMapper">
    <select id="selectOneById" resultType="org.pearl.mybatis.demo.pojo.entity.User">
    select user_id as userId,user_name as userName,login_name as loginName from base_user where user_id = #{id}
  </select>
</mapper>

读取全局配置文件，获取SqlSessionFactory，通过SqlSession执行SQL：

java 复制代码 
@Slf4j
public class Test001 {
    public static void main(String[] args) throws IOException {
        // 根据xml配置文件（全局配置文件）创建一个SqlSessionFactory对象
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        // 通过SqlSessionFactory获取SqlSession实例，SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句
        SqlSession sqlSession = sqlSessionFactory.openSession();
		
	      // 通过SqlSession获取Mapper接口实例，并进行SQL执行，映射结果集等操作。
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = mapper.selectOneById(1L);
        System.out.println(user);
    }
}

查看输出结果：

相关推荐
jokerest12310 小时前
web——sqliabs靶场——第十三关——报错注入+布尔盲注
mybatis
武子康10 小时前
Java-06 深入浅出 MyBatis - 一对一模型 SqlMapConfig 与 Mapper 详细讲解测试
java·开发语言·数据仓库·sql·mybatis·springboot·springcloud
WindFutrue13 小时前
使用Mybatis向Mysql中的插入Point类型的数据全方位解析
数据库·mysql·mybatis
AiFlutter14 小时前
Java实现简单的搜索引擎
java·搜索引擎·mybatis
天天扭码17 小时前
五天SpringCloud计划——DAY1之mybatis-plus的使用
java·spring cloud·mybatis
武子康2 天前
Java-05 深入浅出 MyBatis - 配置深入 动态 SQL 参数、循环、片段
java·sql·设计模式·架构·mybatis·代理模式
2的n次方_2 天前
MyBatis——#{} 和 ${} 的区别和动态 SQL
数据库·sql·mybatis
jokerest1232 天前
web——sqliabs靶场——第十二关——(基于错误的双引号 POST 型字符型变形的注入)
数据库·sql·mybatis
天蓝蓝235282 天前
Lucene数据写入流程
java·mybatis·lucene
热门推荐
01(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明02PyTorch机器学习实现液态神经网络03【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总04玄机平台应急响应—webshell查杀05Coze扣子平台完整体验和实践（附国内和国际版对比）06Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO07【目标跟踪】相机运动补偿08Unity中PICO实现 隔空取物 和 接触抓取物体09RAG 实践- Ollama+RagFlow 部署本地知识库10量化方法怎么选？如何评估量化后的大模型LLM？