mybatis-3学习笔记

0x00 笔注

本篇笔记纯参考B站UP主“狂神”的教程进行总结记录。

(纯参考教程视频和公众号笔记)

公众号文章:http://mp.weixin.qq.com/mp/homepage?__biz=Mzg2NTAzMTExNg==&hid=3&sn=456dc4d66f0726730757e319ffdaa23e&scene=18#wechat_redirect

bilibili视频站地址:https://www.bilibili.com/video/BV1NE411Q7Nx

本篇笔记源码:暂无找到,等找见了再添加;

感慨:不得不承认翻了那么多教程,狂神的教程给人通俗易懂,而且教程也不太占时间。

:本笔记由于个人精力情况,搁置到分页章节,待有机会再继续更新吧。

0x01 搭建一个Demo

① 创建一个MySQL的数据库表(数据库版本应大于5.0):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
CREATE DATABASE `mybatis`;

USE `mybatis`;

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

insert into `user`(`id`,`name`,`pwd`) values (1,'shiyan01','qazwsx'),(2,'shiyan02','edcrfv'),(3,'shiyan03','tgbyhn');

② 在IDEA中创建1个maven项目:

参考文章:https://www.cnblogs.com/qinxu/p/9648429.html

③ 在 pom.xml 文件中添加依赖:

1
2
// 路径地址:(项目源码目录)/pom.xml
// 文件名:pom.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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<?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>top.sh1yan</groupId>
<artifactId>IDEA_MyBatis_Dome</artifactId>
<version>1.0-SNAPSHOT</version>

<dependencies>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
</dependencies>

<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>

</project>

④ 编写 MyBatis 连接数据库的 xml 配置文件

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:mybatis-config.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?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.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
<property name="username" value="root"/>
<property name="password" value=""/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="UserMapperImpl.xml"/>
</mappers>
</configuration>

⑤ 编写调用数据库的共用工具类

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
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\utils
// 文件名:MybatisUtils.java

package top.sh1yan.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 MybatisUtils {

private static SqlSessionFactory sqlSessionFactory;

static {
try {
System.out.println("开始加载!");
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
System.out.println("查看是否加载成功:"+inputStream);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}

//获取SqlSession连接
public static SqlSession getSession(){
return sqlSessionFactory.openSession();
}

}

⑥ 编写数据的存储类

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
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\pojo
// 文件名:User.java

package top.sh1yan.pojo;

public class User {

private int id; //id
private String name; //姓名
private String pwd; //密码

public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}

public User() {
}

public void setId(int id) {
this.id = id;
}

public void setName(String name) {
this.name = name;
}

public void setPwd(String pwd) {
this.pwd = pwd;
}

public int getId() {
return id;
}

public String getName() {
return name;
}

public String getPwd() {
return pwd;
}
}

⑦ 编写Mapper接口类

1
2
3
4
5
6
7
8
9
10
11
12
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java
// 说明:该接口类主要为读取数据库后,存储相应数据对象到具体对象内存中

package top.sh1yan.dao;

import top.sh1yan.pojo.User;
import java.util.List;

public interface IUserMapper {
List<User> selectUser();
}

⑧ 配置具体的 SQL 语句 xml 配置文件

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.xml
1
2
3
4
5
6
7
8
9
10
<?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="top.sh1yan.dao.IUserMapper">
<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>
</mapper>

⑨ 编写测试类并运行测试下,查看是否能正常数据连接并读取

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

import java.util.List;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
//方法一:
//List<User> users = session.selectList("top.sh1yan.dao.IUserMapper.selectUser");
//方法二:
IUserMapper mapper = session.getMapper(IUserMapper.class);
List<User> users = mapper.selectUser();

for (User user: users){
System.out.println("账号:"+user.getName()+" "+"密码:"+user.getPwd());
}
session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@1b9e1916
账号:shiyan01 密码:qazwsx
账号:shiyan02 密码:edcrfv
账号:shiyan03 密码:tgbyhn

Process finished with exit code 0

到这里一个简单的 demo 就完成了。

0x02 增删改查

1.1 查询操作

① 在 IUserMapper.java 文件中增加通过ID查询函数

1
2
3
4
5
6
7
8
9
10
11
12
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import top.sh1yan.pojo.User;
import java.util.List;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

import java.util.List;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 查询某个用户信息
User user = mapper.selectUserById(1);
System.out.println(user.getName());
session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
shiyan01

进程已结束,退出代码0

1.2 通过账号和密码判断是否登录成功

1.2.1 直接在方法中传递参数

在接口方法的参数前加 @Param属性。

Sql语句编写的时候,直接取@Param中设置的值即可,不需要单独设置参数类型。

① 在 IUserMapper.java 文件中增加通过账号密码查询函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import org.apache.ibatis.annotations.Param;
import top.sh1yan.pojo.User;
import java.util.List;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
User selectUserByNP(@Param("name") String username, @Param("pwd") String pwd);
}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

<select id="selectUserByNP" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

import java.util.List;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 通过账号密码查询信息1
User user = mapper.selectUserByNP("shiyan01", "qazwsx");
if (user == null){
System.out.println("查无结果!");
}else {
System.out.println(user.getId());
}

session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
1

进程已结束,退出代码0

1.2.2 使用Map类型传递参数

① 在 IUserMapper.java 文件中增加通过账号密码查询函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import org.apache.ibatis.annotations.Param;
import top.sh1yan.pojo.User;
import java.util.List;
import java.util.Map;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
User selectUserByNP(@Param("name") String username, @Param("pwd") String pwd);
User selectUserByNP1(Map<String,Object> map);
}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.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
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

<select id="selectUserByNP" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<select id="selectUserByNP1" parameterType="map" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 通过账号密码查询信息2
Map<String, Object> map = new HashMap<String, Object>();
map.put("name","shiyan02");
map.put("pwd","edcrfv");
User user = mapper.selectUserByNP1(map);
if (user == null){
System.out.println("查无结果!");
}else {
System.out.println(user.getId());
}

session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
2

进程已结束,退出代码0

2.1 增加操作

① 在 IUserMapper.java 文件中增加插入函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import org.apache.ibatis.annotations.Param;
import top.sh1yan.pojo.User;
import java.util.List;
import java.util.Map;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
User selectUserByNP(@Param("name") String username, @Param("pwd") String pwd);
User selectUserByNP1(Map<String,Object> map);
int addUser(User user);

}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.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
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

<select id="selectUserByNP" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<select id="selectUserByNP1" parameterType="map" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<insert id="addUser" parameterType="top.sh1yan.pojo.User">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 插入1条数据
User user = new User(4,"shiyan04","zxcvbn");
int i = mapper.addUser(user);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库

session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
1

进程已结束,退出代码0

3.1 修改操作

① 在 IUserMapper.java 文件中增加修改函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import org.apache.ibatis.annotations.Param;
import top.sh1yan.pojo.User;
import java.util.List;
import java.util.Map;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
User selectUserByNP(@Param("name") String username, @Param("pwd") String pwd);
User selectUserByNP1(Map<String,Object> map);
int addUser(User user);
int updateUser(User user);

}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.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
32
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

<select id="selectUserByNP" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<select id="selectUserByNP1" parameterType="map" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<insert id="addUser" parameterType="top.sh1yan.pojo.User">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>

<update id="updateUser" parameterType="top.sh1yan.pojo.User">
update user set name=#{name},pwd=#{pwd} where id = #{id}
</update>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.pojo.User;
import top.sh1yan.utils.MybatisUtils;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 修改密码
User user = mapper.selectUserById(1);
user.setPwd("aaaaaaaaaa");
int i = mapper.updateUser(user);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库


session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
1

进程已结束,退出代码0

4.1 删除操作

① 在 IUserMapper.java 文件中增加删除函数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// 路径地址:(项目源码目录)\src\main\java\top\sh1yan\dao
// 文件名:IUserMapper.java

package top.sh1yan.dao;

import org.apache.ibatis.annotations.Param;
import top.sh1yan.pojo.User;
import java.util.List;
import java.util.Map;

public interface IUserMapper {
List<User> selectUser();
User selectUserById(int id);
User selectUserByNP(@Param("name") String username, @Param("pwd") String pwd);
User selectUserByNP1(Map<String,Object> map);
int addUser(User user);
int updateUser(User user);
int deleteUser(int id);

}

② 在 UserMapperImpl.xml 配置文件中增加对应SQL语句

1
2
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:UserMapperImpl.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
32
33
34
35
36
<?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="top.sh1yan.dao.IUserMapper">

<select id="selectUser" resultType="top.sh1yan.pojo.User">
select * from user
</select>

<select id="selectUserById" resultType="top.sh1yan.pojo.User">
select * from user where id = #{id}
</select>

<select id="selectUserByNP" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<select id="selectUserByNP1" parameterType="map" resultType="top.sh1yan.pojo.User">
select * from user where name = #{name} and pwd = #{pwd}
</select>

<insert id="addUser" parameterType="top.sh1yan.pojo.User">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>

<update id="updateUser" parameterType="top.sh1yan.pojo.User">
update user set name=#{name},pwd=#{pwd} where id = #{id}
</update>

<delete id="deleteUser" parameterType="int">
delete from user where id = #{id}
</delete>

</mapper>

③ 测试运行一下

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
// 路径地址:(项目源码目录)\src\test\java
// 文件名:UserMapperTest.java

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import top.sh1yan.dao.IUserMapper;
import top.sh1yan.utils.MybatisUtils;

public class UserMapperTest {
@Test
public void SelectUserShow() {
SqlSession session = MybatisUtils.getSession();
IUserMapper mapper = session.getMapper(IUserMapper.class);
// 删除1条用户信息
int i = mapper.deleteUser(4);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库


session.close();
}
}

// 运行结果

开始加载!
查看是否加载成功:java.io.BufferedInputStream@484b61fc
1

进程已结束,退出代码0

5.1 小结

所有的增删改操作都需要提交事务!

接口所有的普通参数,尽量都写上@Param参数,尤其是多个参数时,必须写上!

有时候根据业务的需求,可以考虑使用map传递参数!

为了规范操作,在SQL的配置文件中,我们尽量将Parameter参数和resultType都写上!

0x03 核心配置参数介绍

1、核心配置文件

mybatis-config.xml 系统核心配置文件:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
<!-- 注意元素节点的顺序!顺序不对会报错 -->

2、environments元素

1
2
3
4
5
6
7
8
9
10
11
12
13
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>

配置MyBatis的多套运行环境,将SQL映射到多个不同的数据库上,必须指定其中一个为默认运行环境(通过default指定)。

子元素节点:environment

  • dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
  • 数据源是必须配置的。
  • 有三种内建的数据源类型:unpooled:这个数据源的实现只是每次被请求时打开和关闭连接;pooled:这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式;jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用;数据源也有很多第三方的实现,比如dbcp,c3p0,druid等等….

3、mappers元素

映射器 : 定义映射SQL语句文件

既然 MyBatis 的行为其他元素已经配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括file:/// 的 URL),或类名和包名等。映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持xml映射器,即:所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始,还支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。

引入资源方式:

使用相对于类路径的资源引用

1
2
3
4
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

使用完全限定资源定位符(URL)

1
2
3
4
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

使用映射器接口实现类的完全限定类名

1
2
3
4
5
6
7
<!--
使用映射器接口实现类的完全限定类名
需要配置文件名称和接口名称一致,并且位于同一目录下
-->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

将包内的映射器接口实现全部注册为映射器

1
2
3
4
5
6
7
<!--
将包内的映射器接口实现全部注册为映射器
但是需要配置文件名称和接口名称一致,并且位于同一目录下
-->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>

Mapper文件:

1
2
3
4
5
6
7
<?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.kuang.mapper.UserMapper">

</mapper>

namespace中文意思:命名空间,作用如下:

  • namespace的命名必须跟某个接口同名

  • 接口中的方法与映射文件中sql语句id应该一一对应

注意事项:

① namespace和子元素的id联合保证唯一 , 区别不同的mapper。

② 绑定DAO接口。

③ namespace命名规则 : 包名+类名。

MyBatis 的真正强大在于它的映射语句,这是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近 95% 的代码。MyBatis 为聚焦于 SQL 而构建,以尽可能地为你减少麻烦。

4、Properties优化

数据库这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递。

优化配置文件步骤:

第一步 ; 在资源目录下新建一个db.properties

1
2
3
4
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=123456

第二步 : 将文件导入properties 配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<configuration>
<!--导入properties文件-->
<properties resource="db.properties"/>

<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>

5、typeAliases优化

类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。

1
2
3
4
<!--配置别名,注意顺序-->
<typeAliases>
<typeAlias type="com.kuang.pojo.User" alias="User"/>
</typeAliases>

当这样配置时,User可以用在任何使用top.sh1yan.pojo.User的地方。

也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:

1
2
3
<typeAliases>
<package name="top.sh1yan.pojo"/>
</typeAliases>

每一个在包 top.sh1yan.pojo 中的 Java Bean,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。

若有注解,则别名为其注解值。见下面的例子:

1
2
3
4
@Alias("user")
public class User {
...
}

6、生命周期和作用域

理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的,因为错误的使用会导致非常严重的并发问题。

执行流程图如下:

作用域理解:

SqlSessionFactoryBuilder 的作用在于创建 SqlSessionFactory,创建成功后,SqlSessionFactoryBuilder 就失去了作用,所以它只能存在于创建 SqlSessionFactory 的方法中,而不要让其长期存在。因此SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。

SqlSessionFactory 可以被认为是一个数据库连接池,它的作用是创建 SqlSession 接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作,所以 SqlSessionFactory 的生命周期存在于整个 MyBatis 的应用之中,所以一旦创建了 SqlSessionFactory,就要长期保存它,直至不再使用 MyBatis 应用,所以可以认为 SqlSessionFactory 的生命周期就等同于 MyBatis 的应用周期。

由于 SqlSessionFactory 是一个对数据库的连接池,所以它占据着数据库的连接资源。如果创建多个 SqlSessionFactory,那么就存在多个数据库连接池,这样不利于对数据库资源的控制,也会导致数据库连接资源被消耗光,出现系统宕机等情况,所以尽量避免发生这样的情况。

因此在一般的应用中我们往往希望 SqlSessionFactory 作为一个单例,让它在应用中被共享。所以说 SqlSessionFactory 的最佳作用域是应用作用域。

如果说 SqlSessionFactory 相当于数据库连接池,那么 SqlSession 就相当于一个数据库连接(Connection 对象),你可以在一个事务里面执行多条 SQL,然后通过它的 commit、rollback 等方法,提交或者回滚事务。所以它应该存活在一个业务请求中,处理完整个请求后,应该关闭这条连接,让它归还给 SqlSessionFactory,否则数据库资源就很快被耗费精光,系统就会瘫痪,所以用 try…catch…finally… 语句来保证其正确关闭。

所以 SqlSession 的最佳的作用域是请求或方法作用域。

0x04 分页设置

1、日志工厂

对于以往的开发过程,我们会经常使用到debug模式来调节,跟踪我们的代码执行过程。但是现在使用Mybatis是基于接口,配置文件的源代码执行过程。因此,我们必须选择日志工具来作为我们开发,调节程序的工具。

Mybatis内置的日志工厂提供日志功能,具体的日志实现有以下几种工具:

SLF4J → Apache Commons Logging → Log4j 2 → Log4j → JDK logging

具体选择哪个日志实现工具由MyBatis的内置日志工厂确定。它会使用最先找到的(按上文列举的顺序查找)。如果一个都未找到,日志功能就会被禁用。

① 这里使用 Log4j 进行测试使用。

② 导入log4j的包:

1
2
3
4
5
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>

③ 创建配置文件:

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
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:log4j.properties

#将等级为DEBUG的日志信息输出到console和file这两个目的地,console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file

#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n

#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/sh1yan.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n

#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

④ 在 setting设置中添加设置:

1
2
3
4
5
6
7
8
9
// 路径地址:(项目源码目录)\src\main\resources
// 文件名:mybatis-config.xml

<configuration>
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
......
</configuration>

⑤ 在测试类中进行使用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
//注意导包:org.apache.log4j.Logger
static Logger logger = Logger.getLogger(MyTest.class);

@Test
public void selectUser() {
logger.info("info:进入selectUser方法");
logger.debug("debug:进入selectUser方法");
logger.error("error: 进入selectUser方法");
SqlSession session = MybatisUtils.getSession();
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> users = mapper.selectUser();
for (User user: users){
System.out.println(user);
}
session.close();
}

⑥ 此时就使用日志记录功能 。

2、使用Limit实现分页

2021.3.20


mybatis-3学习笔记
https://sh1yan.top/2021/03/20/Mybatis-3-learning-notes/
作者
shiyan
发布于
2021年3月20日
许可协议