0基础学习Mybatis系列数据库操作框架——最小Demo

breaksoftware2024-04-01 8:11

大纲

在学习Java的过程中，一般都会学习到使用JDBC连接和操作数据库的知识。Mybatis则是JDBC的一个上层封装，它简化了驱动加载、创建连接等操作。我们只要按照规范配置几个文件、写几个Java类和按一定规则将这些配置文件通过代码的形式加以利用，即可完成数据库的相关操作。

这个系列我们将学习Mybatis以及基于它开发出的工具MybatisPlus。在这个探索的过程中，我们将依赖包的管理交给Maven去做，注意力主要集中在Mybatis相关技术的应用上。

这个案例将依赖于两个模块：

  • 数据库
  • Mybatis

数据库

为了简单起见，我们使用《在Windows的Docker上部署Mysql服务》部署的Mysql服务。然后使用下面指令创建包含各种类型字段的表

bash 复制代码 
create database testdb;
use testdb;
create table all_type(
        info_int int(10) comment 'int',
        info_tint tinyint comment 'tinyint',
        info_sint smallint comment 'smallint',
        info_mint mediumint comment 'mediumint',
        info_bint bigint comment 'bigint',
        info_char varchar(100) comment 'char',
        info_ttext tinytext comment 'tinytext',
        info_text text comment 'text',
        info_mtext mediumtext comment 'mediumtext',
        info_ltext longtext comment 'longtext',
        info_blob blob comment 'blob',
        info_mblob mediumblob comment 'mediumblob',
        info_lblob longblob comment 'longblob',
        info_float float(8,1) comment 'float',
        info_double double(8,1) comment 'double',
        info_decimal decimal(10,2) comment 'decimal',
        info_date  date comment 'date',
        info_datetime datetime comment 'datetime',
        info_timestamp timestamp comment 'timestamp',
        info_time time comment 'time',
        info_year year(4) comment 'year'
        );

Mybatis

我们需要按照Mybatis的规则来组织代码以及其结构。

目录结构

我们使用IntelliJ IDEA创建一个基于Maven的Java工程。

为了能使用Mybatis，我们需要对上述步骤创建的工程做如下的改进：

配置

  • 新增配置。包含：
    • 记录SQL的文件。这儿需要对Mybatis设计有一个初步认识------分离SQL语言和Java代码，即不要在Java代码中放置SQL语句，而在一个独立的配置文件中放置SQL。本例中该文件我们命名为AllTypeMapper.xml。
    • 包含数据库位置、用户名、密码以及指定SQL所在文件的文件名。本例中该文件我们命名为mybatis-config.xml。
  • 修改配置。只要修改maven需要使用的pom.xml即可，即加入Mybatis以及其依赖的库。

代码

  • 新增代码。我们只要新增SQL结果映射的类即可，即Mybatis会将SQL返回的数据序列化为Java对象。本例中是com.all_type中的AlltType.java。
  • 修改代码。修改Main.java代码，利用上述配置以及Mybatis，达到查询数据库的效果。

代码/配置结构

配置结构

依赖库配置

在pom.xml中新增

xml 复制代码 
    <dependencies>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <version>8.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.15</version>
        </dependency>
    </dependencies>

com.mysql是数据库连接工具，org.mybatis是Mybatis。

完整配置如下，仅供参考

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>

    <properties>
        <maven.compiler.source>22</maven.compiler.source>
        <maven.compiler.target>22</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <version>8.3.0</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.15</version>
        </dependency>
    </dependencies>

</project>

使用Maven解析这个文件并把对应的库下载并部署，结果如下

SQL配置

对应于本例中的AllTypeMapper.xml。

这个文件主要定义SQL语句以及其结果反射的Java类。

xml 复制代码 
    <select id="findAll" resultType="com.all_type.AllType">
        select * from all_type
    </select>

id表示这个SQL的唯一标识；resultType是单个结果的类型（select返回的是一个数组，即多个该类型的结果集合）。

完整的配置如下

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="AllTypeMapper">
    <select id="findAll" resultType="com.all_type.AllType">
        select * from all_type
    </select>
</mapper>
Mybatis配置

对应于本例中的mybatis-config.xml。

这个配置分为两部分。它们都定义在configuration下。

数据库配置

数据库信息可以配置多个，用于表示不同的环境。所以最外层是environments标签。

单个的环境使用environment标签表示，并通过id来唯一标志。

transactionManager的type字段表示使用哪种事务管理器。可选项如下：

  • JDBC。这个配置直接使用了 JDBC 的提交和回滚功能，它依赖从数据源获得的连接来管理事务作用域。默认情况下，为了与某些驱动程序兼容，它在关闭连接时启用自动提交。
  • MANAGED。这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接。

dataSource用于定义数据源。它的type也有两种类型，用于定义数据源的连接方式：

  • UNPOOLED。这个数据源的实现会每次请求时打开和关闭连接。
  • POOLED。这种数据源的实现利用"池"的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。

dataSource下的driver表示驱动程序名；url提供数据库连接信息；username和password分别表示数据库的用户名和密码。

xml 复制代码 
    <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://localhost:3306/testdb?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="fangliang"/>
            </dataSource>
        </environment>
    </environments>
SQL映射配置

这儿可以定义一批SQL语句文件。

xml 复制代码 
    <mappers>
        <mapper resource="AllTypeMapper.xml"/>
    </mappers>
完整配置
xml 复制代码 
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "https://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://localhost:3306/testdb?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="fangliang"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="AllTypeMapper.xml"/>
    </mappers>
</configuration>

代码结构

映射类

对应于本例中的AllType.java。

为了简单起见，我们只定义了表中的第一个字段。注意字段名称一致。

info_int int(10) comment 'int',

java 复制代码 
package com.all_type;

public class AllType {

    public int getInfo_int() {
        return info_int;
    }

    public void setInfo_int(int info_int) {
        this.info_int = info_int;
    }

    private int info_int;
}

这个映射类和SQL配置文件AllTypeMapper.xml的SQL语句块有关联，即resultType字段对应的值。

xml 复制代码 
<select id="findAll" resultType="com.all_type.AllType">
	select * from all_type
</select>
Mybatis逻辑

这部分代码我们写在Main.java中。它需要按以下步骤执行：

从 XML 中构建 SqlSessionFactory
java 复制代码 
InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSF = new SqlSessionFactoryBuilder().build(in);
从 SqlSessionFactory 中获取 SqlSession
java 复制代码 
SqlSession s = sqlSF.openSession();
通过mapper中的namespace和id执行SQL
java 复制代码 
List<AllType> all = s.selectList("AllTypeMapper.findAll");
完整逻辑和代码
java 复制代码 
package org.example;

import com.all_type.AllType;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.*;

import java.io.InputStream;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        try {
            InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
            SqlSessionFactory sqlSF = new SqlSessionFactoryBuilder().build(in);
            List<AllType> all;
            try (SqlSession s = sqlSF.openSession()) {
                all = s.selectList("AllTypeMapper.findAll");
            }
            for (AllType a : all) {
                System.out.println(a.getInfo_int());
            }
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
    }
}

参考资料

相关推荐
vvvae123424 分钟前
分布式数据库
数据库
哎呦没25 分钟前
大学生就业招聘：Spring Boot系统的架构分析
java·spring boot·后端
雪域迷影44 分钟前
PostgreSQL Docker Error – 5432: 地址已被占用
数据库·docker·postgresql
编程、小哥哥1 小时前
netty之Netty与SpringBoot整合
java·spring boot·spring
bug菌¹1 小时前
滚雪球学Oracle[4.2讲]：PL/SQL基础语法
数据库·oracle
逸巽散人2 小时前
SQL基础教程
数据库·sql·oracle
IT学长编程2 小时前
计算机毕业设计 玩具租赁系统的设计与实现 Java实战项目 附源码+文档+视频讲解
java·spring boot·毕业设计·课程设计·毕业论文·计算机毕业设计选题·玩具租赁系统
莹雨潇潇2 小时前
Docker 快速入门（Ubuntu版）
java·前端·docker·容器
月空MoonSky2 小时前
Oracle中TRUNC()函数详解
数据库·sql·oracle
momo小菜pa2 小时前
【MySQL 06】表的增删查改
数据库·mysql
热门推荐
01【经验分享】Ubuntu22.04安装微信(linux官方版)02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04CTF网络安全大赛简单的web抓包题目：HEADache05安卓系列机型永久去除data分区加密 详细步骤解析06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07pve(Proxmox VE)安装i225v网卡驱动08Ubuntu24.04安装中文输入法09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10分享几个惊艳的 Three.js 个人站点