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);
    }
}

查看输出结果：

相关推荐
鹿屿二向箔2 小时前
基于SSM（Spring + Spring MVC + MyBatis）框架的汽车租赁共享平台系统
spring·mvc·mybatis
沐雪架构师5 小时前
mybatis连接PGSQL中对于json和jsonb的处理
json·mybatis
鹿屿二向箔7 小时前
基于SSM（Spring + Spring MVC + MyBatis）框架的咖啡馆管理系统
spring·mvc·mybatis
aloha_78916 小时前
从零记录搭建一个干净的mybatis环境
java·笔记·spring·spring cloud·maven·mybatis·springboot
毕业设计制作和分享17 小时前
ssm《数据库系统原理》课程平台的设计与实现+vue
前端·数据库·vue.js·oracle·mybatis
paopaokaka_luck20 小时前
基于Spring Boot+Vue的助农销售平台(协同过滤算法、限流算法、支付宝沙盒支付、实时聊天、图形化分析)
java·spring boot·小程序·毕业设计·mybatis·1024程序员节
cooldream200921 小时前
Spring Boot中集成MyBatis操作数据库详细教程
java·数据库·spring boot·mybatis
不像程序员的程序媛1 天前
mybatisgenerator生成mapper时报错
maven·mybatis
小布布的不1 天前
MyBatis 返回 Map 或 List＜Map＞时，时间类型数据，默认为LocalDateTime，响应给前端默认含有‘T‘字符
前端·mybatis·springboot
背水1 天前
Mybatis基于注解的关系查询
mybatis
热门推荐
01【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总02(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【AIGC】重塑未来的科技巨轮05全面解析：构建基于深度学习的安全帽检测系统（UI界面+YOLO代码+数据集）06【经验分享】Ubuntu22.04安装微信(linux官方版)07基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测08Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO09RAG 实践- Ollama+RagFlow 部署本地知识库10【TC3xx芯片】TC3xx芯片电源管理系统PMS详解