尚硅谷MyBatis新版视频教程
B站直达:https://www.bilibili.com/video/BV1VP4y1c7j7
百度网盘:https://pan.baidu.com/s/1Y4K8zAcABJe5egHcP5PGNQ 提取码:yyds
阿里云盘:https://www.aliyundrive.com/s/jhn918RtGjA(教程配套资料请从百度网盘下载)

围观尚硅谷Java课程:http://www.atguigu.com/kecheng.shtml
更多尚硅谷视频教程请访问:http://www.atguigu.com/download.shtml

一、MyBatis 简介

1.1、MyBatis历史

MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁 移到了Google Code。随着开发团队转投Google Code旗下, iBatis3.x正式更名为MyBatis。代码于 2013年11月迁移到Github。 iBatis一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。 iBatis提供的持久层框架 包括SQL Maps和Data Access Objects(DAO)。

1.2、MyBatis特性

  1. MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
  2. MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
  3. MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录
  4. MyBatis 是一个 半自动的ORM(Object Relation Mapping)框架

1.3、MyBatis 下载

MyBatis下载地址:https://github.com/mybatis/mybatis-3

image-20240228220851233

image-20240228220944909

1.4、 和其它持久化层技术对比

  • JDBC

    • SQL 夹杂在Java代码中耦合度高,导致硬编码内伤

    • 维护不易且实际开发需求中 SQL 有变化,频繁修改的情况多见

    • 代码冗长,开发效率低

  • Hibernate 和 JPA

    • 操作简便,开发效率高
    • 程序中的长难复杂 SQL 需要绕过框架
    • 内部自动生产的 SQL,不容易做特殊优化
    • 基于全映射的全自动框架,大量字段的 POJO 进行部分映射时比较困难。
    • 反射操作太多,导致数据库性能下降
  • MyBatis

    • 轻量级,性能出色
    • SQL 和 Java 编码分开,功能边界清晰。Java代码专注业务、SQL语句专注数据
    • 开发效率稍逊于HIbernate,但是完全能够接受

二、搭建MyBatis

2.1 、开发环境

IDE:idea 2033.3

构建工具:maven 3.6.3

MySQL版本:MySQL 8

MyBatis版本:MyBatis 3.5.7

2.2 、创建maven工程

2.2.1、 创建一个空项目

image-20240228222502386

2.2.2 、配置 jdk及相应版本

image-20240228222644104

2.2.3 、Maven配置设置

File => Settings => Build,Execution,Deployment => Build Tools => Maven

选择本地Maven进行配置

image-20240228223200439

Maven下载依赖步骤:

先在本地仓库查找,若本地仓库没有,则看配置文件中是否配置镜像网站,若已配置则从镜像网站拉取,反之从中央仓库拉取

2.2.4 、创建Maven工程

New => Module

image-20240228223733874

可以选择 Maven Archetype的方式创建,即选择不同的模板进行创建

image-20240228223903765

也可以直接创建java项目

image-20240228224140318

创建好后目录结果如图所示

image-20240228224243625

设置打包方式:jar

image-20240228224347864

引入依赖

可从 Maven仓库 查看依赖最新版本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<dependencies>
<!-- Mybatis核心 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.33</version>
</dependency>
<!-- lombok依赖 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.24</version>
<!-- 对于编译时注解处理器,通常设置为 provided -->
<scope>provided</scope>
</dependency>
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
</dependencies>

点击Maven小图片可更新依赖

image-20240228225133635

或者在Maven侧边栏进行操作

image-20240228225229959

也可在此处查看引入的相关依赖

image-20240228225557457

2.3、创建Mybatis核心配置文件

习惯上命名为mybatis-config.xml,这个文件名仅仅只是建议,并非强制要求。将来整合Spring 之后,这个配置文件可以省略,所以大家操作时可以直接复制、粘贴。 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息

核心配置文件存放的位置是src/main/resources目录下

3.1、创建mybatis-config.xml核心配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<?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">
<!-- Spring中约束使用xsd约束,MyBatis使用dtd约束,dtd约束中 DOCTYPE 后的标签必定为当前配置文件中的根标签 -->
<configuration>
<!--设置连接数据库的环境,可配置多个连接数据库的环境信息-->
<environments default="development">
<environment id="development">
<!-- 事务管理器,以最原始的JDBC方式进行管理,事务的开启,提交,回滚需手动处理 -->
<transactionManager type="JDBC"/>
<!-- 数据源 连接数据库的信息 type="POOLED" 表示使用数据库连接池,会对当前的数据库连接进行保存,下次使用时可直接从缓存中获取 -->
<dataSource type="POOLED">
<!-- 驱动名称 mysql8之前版本: com.mysql.jdbc.Driver mysql8之后:com.mysql.cj.jdbc.Driver -->
<!-- <property name="driver" value="com.mysql.jdbc.Driver"/>-->
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<!-- 连接地址 mysql8 之后需指定时区 GMT%2B8 或 Asia/Shanghai -->
<!-- <property name="url" value="jdbc:mysql://localhost:3306/MyBatis"/>-->
<property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useUnicode=true&amp;characterEncoding=UTF8&amp;serverTimezone=Asia/Shanghai&amp;useSSL=false"/>
<!-- 用户名 -->
<property name="username" value="root"/>
<!-- 登录密码 -->
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="mappers/UserMapper.xml"/>
</mappers>
</configuration>

2.4、创建Mapper接口

MyBatis中的mapper接口相当于以前的dao。但是区别在于,mapper仅仅是接口,我们不需要 提供实现类。

2.4.1 、创建表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/*
Navicat Premium Data Transfer

Source Server : MYSQL8.0.31
Source Server Type : MySQL
Source Server Version : 80031
Source Host : localhost:3306
Source Schema : mybatis

Target Server Type : MySQL
Target Server Version : 80031
File Encoding : 65001

Date: 28/02/2024 23:21:56
*/

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for t_user
-- ----------------------------
DROP TABLE IF EXISTS `t_user`;
CREATE TABLE `t_user` (
`id` int NOT NULL AUTO_INCREMENT,
`username` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`password` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`age` int NULL DEFAULT NULL,
`sex` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
`email` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL,
PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 6 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Records of t_user
-- ----------------------------
INSERT INTO `t_user` VALUES (3, '张三', '123', 18, '男', 'zhangsan@shiguangteach.com');
INSERT INTO `t_user` VALUES (4, '李四', 'lisi', 18, '男', 'lisi@shiguangteach.com');
INSERT INTO `t_user` VALUES (5, '王五', 'wangwu', 20, '男', 'wangwu@shiguangteach.com');

SET FOREIGN_KEY_CHECKS = 1;

2.4.2、创建实体类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
package com.shiguang.mybatis.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;


@Data
@NoArgsConstructor
@AllArgsConstructor
@ToString
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String email;
private String sex;
}

2.4.3、创建Mapper接口

Mybatis 面向接口编程的两个一致
1、映射文件的namespace要和mapper接口的全类名保持一致
2、映射文件中SQL语句的id要和mapper接口中的方法名一致

src/main/java/com/shiguang/mybatis/mapper/UserMapper.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
package com.shiguang.mybatis.mapper;


/**
* Created By AnShiGuang329 On 2024/1/16 22:31
*/
public interface UserMapper {
/**
* Mybatis 面向接口编程的两个一致
* 1、映射文件的namespace要和mapper接口的全类名保持一致
* 2、映射文件中SQL语句的id要和mapper接口中的方法名一致
*/

/**
* 添加用户信息
*/
int insertUser();


}

三、MyBatis增删改查

3.1、创建MyBatis的映射文件

相关概念:ORM(Object Relationship Mapping)对象关系映射。

  • 对象:Java的实体类对象
  • 关系:关系型数据库
  • 映射:二者之间的对应关系
Java概念 数据库概念
属性 字段/列
对象 记录/行

3.2、创建xml映射文件

1、映射文件的命名规则:

表所对应的实体类的类名+Mapper.xml

例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml

因此一个映射文件对应一个实体类,对应一张表的操作

MyBatis映射文件用于编写SQL,访问以及操作表中的数据

MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2、MyBatis中可以面向接口操作数据,要保证两个一致:

a >mapper接口的全类名和映射文件的命名空间(namespace)保持一致

b >mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

mappers/UserMapper.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
<?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.shiguang.mybatis.mapper.UserMapper">


<insert id="insertUser">
insert into t_user values (null, '王铁成', 'wangwu', 10, '男', 'wangwu@shiguangteach.com')
</insert>

</mapper>

3.3、测试新增功能

src/test/java/MyBatisTest.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
import com.shiguang.mybatis.mapper.UserMapper;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;

public class MyBatisTest {
@Test
public void testMyBatis() throws IOException {
// 加载核心配置文件
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

// 获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

// 获取SqlSessionFactory
// 通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory,生产SqlSession对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

//获取SqlSession
//sqlSessionFactory.openSession() 默认不会开启事务,需执行完sql后调用commit()方法手动提交
// sqlSessionFactory.openSession(true) 开启自动提交事务
SqlSession sqlSession = sqlSessionFactory.openSession(true);

//获取mapper接口对象
///通过代理模式创建UserMapper接口的代理实现类对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);


//测试功能


//调用UserMapper接口中的方法,就可以根据UserMapper的全类名匹配元素文件,
// 通过调用的方法名匹配 映射文件中的SQL标签,并执行标签中的SQL语句
int resultCode = mapper.insertUser();
System.out.println("resultCode:" + resultCode);

//提交事务
// sqlSession.commit();

}

}

3.4、加入log4j日志功能

3.4.1、导入依赖

1
2
3
4
5
6
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>

3.4.2、log4j的配置文件

log4j的配置文件名为log4j.xml,存放的位置是src/main/resources目录下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
<param name="Encoding" value="UTF-8"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}
%m (%F:%L) \n"/>
</layout>
</appender>
<logger name="java.sql">
<level value="debug"/>
</logger>
<logger name="org.apache.ibatis">
<level value="info"/>
</logger>
<root>
<level value="debug"/>
<appender-ref ref="STDOUT"/>
</root>
</log4j:configuration>

文件中有一处报错可忽略

image-20240304224424715

日志的级别

FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)

从左到右打印的内容越来越详细

日志级别越高,输出的日志越少,日志级别越低,输出的日志越多

日志输出信息如下所示

image-20240304223935862

3.5、测试修改和删除功能

UserMapper.java 中新增相应方法

1
2
3
4
5
6
7
8
9
10
11
/**
* 修改用户信息
*/
int updateUser();


/**
* 删除用户信息
*/
int deleteById();

UserMapper.xml 中新增相应sql

1
2
3
4
5
6
7
8
9
10
11
<!--    int updateUser();-->

<update id="updateUser">
update t_user set username = '赵磊' where id = 8
</update>


<!-- int deleteById();-->
<delete id="deleteById">
delete from t_user where id = 8
</delete>

测试

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
@Test
public void testUpdate() throws IOException {

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

SqlSession sqlSession = sqlSessionFactory.openSession(true);

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

//测试功能

int resultCode = mapper.updateUser();
System.out.println("resultCode:" + resultCode);


}

@Test
public void testDelete() throws IOException {

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

SqlSession sqlSession = sqlSessionFactory.openSession(true);

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

//测试功能

int resultCode = mapper.deleteById();
System.out.println("resultCode:" + resultCode);

}

3.6、测试查询功能

UserMapper.java 中新增相应方法

1
2
3
4
5
6
7
8
9
10
/**
* 根据ID获取User对象
*/
User getUserById();


/**
* 查询所有用户信息
*/
List<User> getAllUser();

UserMapper.xml 中新增相应sql

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<!--User getUserById();-->
<!--
查询功能的标签必须设置resultType或resultMap
resultType: 设置默认的映射关系
resultMap: 设置自定义映射关系
-->
<select id="getUserById" resultType="com.shiguang.mybatis.pojo.User">
select * from t_user where id = 3
</select>


<!-- List<User> getAllUser(); -->
<select id="getAllUser" resultType="com.shiguang.mybatis.pojo.User">
select * from t_user
</select>

测试

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
    @Test
public void testGetUserById() throws IOException {

InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

SqlSession sqlSession = sqlSessionFactory.openSession(true);

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

//测试功能

User user = mapper.getUserById();
System.out.println(user);

}

@Test
public void testGetAllUser() throws IOException {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();

SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

SqlSession sqlSession = sqlSessionFactory.openSession(true);

UserMapper mapper = sqlSession.getMapper(UserMapper.class);

//测试功能

List<User> users = mapper.getAllUser();
// users.forEach(user -> System.out.println(user));
users.forEach(System.out::println);

}

注意:

1、查询功能的标签必须设置resultType或resultMap
resultType: 设置默认的映射关系,字段名与属性名一致时可使用resultType
resultMap: 设置自定义映射关系,字段名与属性名不一致或者处理多对一,一对多关系需用resultMap

2、当查询的数据为多条时,不能使用实体类作为返回值,只能使用集合,否则会抛出异常 TooManyResultsException;但是若查询的数据只有一条,可以使用实体类或集合作为返回值

若查询时未指定返回值类型会报错

image-20240304232050587

3.7、Idea中创建文件模板

File => Settings => Editor => File and Code templates => Files

image-20240307234639184

mybatis-config.xml模板如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<?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>

<!--引入配置文件-->
<properties resource=""/>

<typeAliases>
<!--设置类型别名-->
<package name=""/>
</typeAliases>

<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource=""/>
</mappers>
</configuration>

xxxMapper.xml 模板如下

1
2
3
4
5
6
7
8
<?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="">

</mapper>

使用时只需 New => 选择相应文件模板 即可快速创建

image-20240307234822456

3.8、封装SqlSession工具类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
package com.shiguang.mybatis.utils;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

public class SqlSessionUtils {
public static SqlSession getSqlSession() {
SqlSession sqlSession = null;
try {
InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
sqlSession = sqlSessionFactory.openSession(true);

} catch (IOException e) {
throw new RuntimeException(e);
}

return sqlSession;
}
}

四、核心配置文件详解

核心配置文件中的标签必须按照固定的顺序: properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorF actory?,plugins?,environments?,databaseIdProvider?,mappers?

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
<?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>
<!--引入properties文件,此时就可以${属性名}的方式访问属性值-->
<properties resource="jdbc.properties"></properties>
<settings>
<!--将表中字段的下划线自动转换为驼峰-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
<!--开启延迟加载-->
<setting name="lazyLoadingEnabled" value="true"/>
</settings>
<typeAliases>
<!--
typeAlias:设置某个具体的类型的别名
属性:
type:需要设置别名的类型的全类名
alias:设置此类型的别名,若不设置此属性,该类型拥有默认的别名,即类名且不区分大小

若设置此属性,此时该类型的别名只能使用alias所设置的值
-->
<!--<typeAlias type="com.atguigu.mybatis.bean.User"></typeAlias>-->
<!--<typeAlias type="com.atguigu.mybatis.bean.User" alias="abc">
</typeAlias>-->
<!--以包为单位,设置改包下所有的类型都拥有默认的别名,即类名且不区分大小写-->
<package name="com.atguigu.mybatis.bean"/>
</typeAliases>
<!--
environments:设置多个连接数据库的环境
属性:
default:设置默认使用的环境的id
-->
<environments default="mysql_test">
<!--
environment:设置具体的连接数据库的环境信息
属性:
id:设置环境的唯一标识,可通过environments标签中的default设置某一个环境的id,
表示默认使用的环境
-->
<environment id="mysql_test">
<!--
transactionManager:设置事务管理方式
属性:
type:设置事务管理方式,type="JDBC|MANAGED"
type="JDBC":设置当前环境的事务管理都必须手动处理
type="MANAGED":设置事务被管理,例如spring中的AOP
-->
<transactionManager type="JDBC"/>
<!--
dataSource:设置数据源
属性:
type:设置数据源的类型,type="POOLED|UNPOOLED|JNDI"
type="POOLED":使用数据库连接池,即会将创建的连接进行缓存,下次使用可以从
缓存中直接获取,不需要重新创建
type="UNPOOLED":不使用数据库连接池,即每次使用连接都需要重新创建
type="JNDI":调用上下文中的数据源
-->
<dataSource type="POOLED">
<!--设置驱动类的全类名-->
<property name="driver" value="${jdbc.driver}"/>
<!--设置连接数据库的连接地址-->
<property name="url" value="${jdbc.url}"/>
<!--设置连接数据库的用户名-->
<property name="username" value="${jdbc.username}"/>
<!--设置连接数据库的密码-->
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!--引入映射文件-->
<mappers>
<mapper resource="UserMapper.xml"/>
<!--
以包为单位,将包下所有的映射文件引入核心配置文件
注意:此方式必须保证mapper接口和mapper映射文件必须在相同的包下
-->
<package name="com.atguigu.mybatis.mapper"/>
</mappers>
</configuration>

3.1 properties引入配置文件

新建 jdbc.properties配置文件 ,可以直接通过 new => File手动创建 .properties 后缀的配置文件,

也可通过 new => Resource Bundle 创建,通过该方式创建的后缀均为 .properties

文件路径为 src/main/resources/jdbc.properties

image-20240307222617700

由于可能存在多个配置文件,为了避免配置文件key 重复,可以统一为每个配置文件添加个前缀以作区分

比如以文件名作为前缀

1
2
3
4
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/MyBatis?useUnicode=true&characterEncoding=UTF8&serverTimezone=Asia/Shanghai&useSSL=false
jdbc.username=root
jdbc.password=shiguang

通过 <properties resource="jdbc.properties"></properties> 引入配置文件

引入配置文件后,可以通过 ${属性名} 的方式访问属性

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!-- 驱动名称  mysql8之前版本: com.mysql.jdbc.Driver mysql8之后:com.mysql.cj.jdbc.Driver -->
<!-- <property name="driver" value="com.mysql.jdbc.Driver"/>-->
<!-- <property name="driver" value="com.mysql.cj.jdbc.Driver"/>-->
<property name="driver" value="${jdbc.driver}"/>
<!-- 连接地址 mysql8 之后需指定时区 GMT%2B8 或 Asia/Shanghai -->
<!-- <property name="url" value="jdbc:mysql://localhost:3306/MyBatis"/>-->
<!-- <property name="url" value="jdbc:mysql://localhost:3306/MyBatis?useUnicode=true&amp;characterEncoding=UTF8&amp;serverTimezone=Asia/Shanghai&amp;useSSL=false"/>-->
<property name="url" value="${jdbc.url}"/>
<!-- 用户名 -->
<!-- <property name="username" value="root"/>-->
<property name="username" value="${jdbc.username}"/>
<!-- 登录密码 -->
<!-- <property name="password" value="shiguang"/>-->
<property name="password" value="${jdbc.password}"/>

3.2 typeAliases设置类型别名

  1. typeAlias:设置某个具体的类型的别名
    属性:
    type:需要设置别名的类型的全类名
    alias:设置此类型的别名,若不设置此属性,该类型拥有默认的别名,即类名且不区分大小写
    若设置此属性,此时该类型的别名只能使用alias所设置的值
  2. package:

​ 以包为单位,设置改包下所有的类型都拥有默认的别名,即类名且不区分大小写-

1
2
3
4
5
6
7
<typeAliases>
<!--<typeAlias type="com.atguigu.mybatis.bean.User"></typeAlias>-->
<!--<typeAlias type="com.atguigu.mybatis.bean.User" alias="abc">
</typeAlias>-->

<package name="com.atguigu.mybatis.bean"/>
</typeAliases>

3.3 mappers引入映射文件

  1. 逐个引入:

<mapper resource="xxxMapper.xml"/>

  1. 以包为单位引入映射文件:

    要求:

    1. mapper接口所在的包要和映射文件所在的包一致
    2. mapper接口要和映射文件的名称一致

<package name="xxx.xxx.xxx.mapper"/>

层级创建包时不能用点比如 xxx.xxx.mapper而应以目录的形式创建比如 xxx/xxx/mapper

1
2
3
4
5
6
7
8
<mappers>
<mapper resource="UserMapper.xml"/>
<!--
以包为单位,将包下所有的映射文件引入核心配置文件
注意:此方式必须保证mapper接口和mapper映射文件必须在相同的包下
-->
<package name="com.atguigu.mybatis.mapper"/>
</mappers>

五、MyBatis获取参数的两种方式(重点)

MyBatis获取参数值的两种方式:**${}#{}**

${}的本质就是字符串拼接,#{}的本质就是占位符赋值

${}使用字符串拼接的方式拼接sql,若为字符串类型或日期类型的字段进行赋值时,需要手动加单引 号;

但是#{}使用占位符赋值的方式拼接sql,此时为字符串类型或日期类型的字段进行赋值时,可以自 动添加单引号

5.1、单个字面量类型的参数

若mapper接口中的方法参数为单个的字面量类型

此时可以使用${}和#{}以任意的名称获取参数的值,注意${}需要手动加单引号

1
Usr getUsrByName(String name);
1
2
3
4
<select id = "getUsrByName" resultType="usr">
<!-- select * from t_user where username = '${name}' -->
select * from t_user where username = #{name}
</select>

5.2、多个字面量类型的参数

若mapper接口中的方法参数为多个时 此时MyBatis会自动将这些参数放在一个map集合中,

以arg0,arg1…为键,以参数为值;以 param1,param2…为键,以参数为值;

因此只需要通过${}和#{}访问map集合的键就可以获取相对应的 值,注意${}需要手动加单引号

1
Usr checkLogin(String username,String password);
1
2
3
4
<select id="checkLogin" resultType="com.shiguang.mybatis.pojo.Usr">
<!-- select * from t_user where username = #{arg0} and password = #{arg1} -->
select * from t_user where username = #{param1} and password = #{param2}
</select>

5.3、map集合类型的参数

若mapper接口中的方法需要的参数为多个时,此时可以手动创建map集合,

将这些数据放在map中 只需要通过${}和#{}访问map集合的键就可以获取相对应的值,注意${}需要手动加单引号

1
Usr checkLoginByMap(Map<String,Object> map);
1
2
3
<select id="checkLoginByMap" resultType="com.shiguang.mybatis.pojo.Usr">
select * from t_user where username = #{username} and password = #{password}
</select>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
@Test
public void testCheckLoginByMap(){
SqlSession sqlSession = SqlSessionUtils.getSqlSession();

UsrMapper mapper = sqlSession.getMapper(UsrMapper.class);

Map<String,Object> map = new HashMap<>();

map.put("username","张三0");
map.put("password","123");

Usr usr = mapper.checkLoginByMap(map);

System.out.println(usr);

}

5.4、实体类类型的参数 (常用)

若mapper接口中的方法参数为实体类对象时 此时可以使用${}和#{},

通过访问实体类对象中的属性名(有相应的get,set方法)获取属性值,注意${}需要手动加单引号

1
int insertUsr(Usr usr);
1
2
3
<insert id="insertUsr" >
insert into t_user values (null,#{username},#{password},#{age},#{sex},#{email})
</insert>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@Test
public void testInsertUsr() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();

UsrMapper mapper = sqlSession.getMapper(UsrMapper.class);

Usr user = new Usr();
user.setUsername("王五");
user.setPassword("wangwu");
user.setSex("男");
user.setAge(18);
user.setEmail("wangwu@163.com");

int code = mapper.insertUsr(user);

System.out.println(code);
}

5.5、使用@Param标识参数

可以通过@Param注解标识mapper接口中的方法参数 此时,会将这些参数放在map集合中,

@Param注解的value属性值为键,以参数为值;以 param1,param2…为键,以参数为值;

只需要通过${}和#{}访问map集合的键就可以获取相对应的值, 注意${}需要手动加单引号

1
Usr checkLoginByParam(@Param("username") String username,@Param("password") String password);
1
2
3
4
<select id="checkLoginByParam" resultType="com.shiguang.mybatis.pojo.Usr">
<!-- select * from t_user where username = #{param1} and password = #{param2} -->
select * from t_user where username = #{username} and password = #{password}
</select>
1
2
3
4
5
6
7
8
9
10
11
 @Test
public void testCheckLoginByParam() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession();

UsrMapper mapper = sqlSession.getMapper(UsrMapper.class);

Usr usr = mapper.checkLoginByParam("张三0", "123");

System.out.println(usr);

}

【尚硅谷】MyBatis零基础入门教程(细致全面,快速上手mybatis)

Maven仓库