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

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