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

大纲

数据库
Mybatis
- 目录结构
- - 配置
  - 代码
- 代码/配置结构
- - 配置结构
  - - 依赖库配置
    - SQL配置
    - Mybatis配置
    - - 数据库配置
      - SQL映射配置
    - 完整配置
  - 代码结构
  - - 映射类
    - Mybatis逻辑
    - - 从 XML 中构建 SqlSessionFactory
      - 从 SqlSessionFactory 中获取 SqlSession
      - 通过mapper中的namespace和id执行SQL
    - 完整逻辑和代码
参考资料

在学习Java的过程中，一般都会学习到使用JDBC连接和操作数据库的知识。Mybatis则是JDBC的一个上层封装，它简化了驱动加载、创建连接等操作。我们只要按照规范配置几个文件、写几个Java类和按一定规则将这些配置文件通过代码的形式加以利用，即可完成数据库的相关操作。
这个系列我们将学习Mybatis以及基于它开发出的工具MybatisPlus。在这个探索的过程中，我们将依赖包的管理交给Maven去做，注意力主要集中在Mybatis相关技术的应用上。
这个案例将依赖于两个模块：

数据库
Mybatis

数据库

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

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中新增

    <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 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类。

    <select id="findAll" resultType="com.all_type.AllType">select * from all_type</select>

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapperPUBLIC "-//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分别表示数据库的用户名和密码。

    <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语句文件。

    <mappers><mapper resource="AllTypeMapper.xml"/></mappers>

完整配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//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’,

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字段对应的值。

<select id="findAll" resultType="com.all_type.AllType">select * from all_type
</select>

Mybatis逻辑

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

从 XML 中构建 SqlSessionFactory

InputStream in = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSF = new SqlSessionFactoryBuilder().build(in);

从 SqlSessionFactory 中获取 SqlSession

SqlSession s = sqlSF.openSession();

通过mapper中的namespace和id执行SQL

List<AllType> all = s.selectList("AllTypeMapper.findAll");

完整逻辑和代码

在这里插入图片描述

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