MyBatis学习笔记--上篇

MyBatis学习

1、简介

1.1、什么是MyBatis

• MyBatis 是一款优秀的持久层框架
• 它支持自定义 SQL、存储过程以及高级映射。
• MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。
• MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

如何获得MyBatis？

• Maven仓库：https://mvnrepository.com/

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.6</version>
</dependency>

• Github：https://github.com/mybatis/mybatis-3
• 中文文档：https://mybatis.org/mybatis-3/zh/index.html

1.2、持久化

数据持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
- 内存：断电即失
- 数据库（Jdbc）、io文件持久化
为什么需要持久化？（一些对象不能丢失）

1.3、持久层

Dao层，Service层，Controller层…

• 完成持久化工作的代码
• 层界限十分明显

1.4、为什么需要MyBatis

• 帮助程序员将数据存入到数据库中。
• 方便
• 传统的JDBC代码太复杂。简化。框架。自动化。
• 更容易上手。

优点：

• 简单易学。
• 灵活
• sql和代码的分离，提高了可维护性。
• 提供映射标签，支持对象与数据库的ORM字段关系映射。
• 提供对象关系映射标签，支持对象关系组建维护。
• 提供xml标签，支持编写动态sql。

2、第一个MyBatis程序

思路：搭建环境、导入依赖、编码测试。

2.1、搭建数据库环境

DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
  `id` int NOT NULL,
  `name` varchar(255) DEFAULT NULL,
  `pwd` varchar(255) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

-- ----------------------------
-- Records of user
-- ----------------------------
INSERT INTO `user` VALUES ('1', 'radan', '1');
INSERT INTO `user` VALUES ('2', 'zs', '1');
INSERT INTO `user` VALUES ('3', 'ls', '1');

2.2、新建项目

1. 创建一个普通的Maven项目
2. 删除src设定为父工程
3. 导入maven依赖

<dependencies>
    <!--      mysql包-->
      <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.31</version>
      </dependency>
    <!--  mybatis包    -->
      <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.6</version>
      </dependency>

      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
      </dependency>
    </dependencies>

2.3、创建一个子模块

• 编写mybatis核心配置文件

<?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/mybatis?useSSl=true&amp;useUnicode=true&amp;characterEncoding=utf8&amp;serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>

    </environments>
<!--     每一个Mapper.xml都需要在MyBatis核心配置文件中注册！ 这里是斜杠  -->
    <mappers>
        <mapper resource="com/yjr/dao/UserMapper.xml"/>
    </mappers>
</configuration>

• 编写mybatis的工具类

public class MyBatisUtils {
    private  static SqlSessionFactory sqlSessionFactory;
    //1.获取SqlSessionFactory对象
    //既然有了sqlSessionFactory，通过下面方法获取到一个SqlSession实例
    //SQLSession完全包含了面向数据库执行SQ命令所需的所有方法
    public static SqlSession getSqlSession() throws IOException {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

        return sqlSessionFactory.openSession();
    }


}

2.4、编写代码

• 实体类

package com.yjr.pojo;

//实体类
public class User {
    private int id;
    private String name;
    private String pwd;
}

• Dao接口

public interface USerMapper{
    List<User> getAllUsers();
}

• 接口实现类由原来的UserDaoImpl转变为一个Mapper配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
        <!--namespace绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.yjr.dao.UserDao">
    <!--    查询语句-->
    <select id="getAllUsers" resultType="com.yjr.pojo.User">
        select * from user
    </select>
</mapper>

2.5、测试（Junit）

注意点：
org,apache.ibatis.binding.BindingException: Type interface com.kuang.dao.UserDao is not known to theMapperRegistry.
MapperRegistry

• Junit测试

    @Test
    public void getAllUsersTest() throws IOException {
        //1.获取SQLSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        //方式一：getMapper-----目前最好用
//        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//        System.out.println(mapper.getAllUsers());
//        sqlSession.close();
        //方式二：
        List<User> users = sqlSession.selectList("com.yjr.dao.UserMapper.getAllUsers");
        System.out.println(users);
        sqlSession.close();
    }

可能遇到的问题：

• 配置文件没有注册
• 绑定就扣错误
• 方法名不对
• 返回类型不对
• Maven到处资源问题

    <!-- 在build中配置resources。来防止我们资源导出失败的问题 资源过滤问题-->
    <build>
        <resources>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>

3、CRUD

注意点：

3.1、namespace(命名空间)

namespace中的包名要和Dao/Mapper接口的包名一致！(且连接符是点)

3.2、select

• id：就是对应的namespace中的方法名；
• resultType：Sql语句执行的返回值！
• ParameterTye：参数类型！

编写步骤：

1. 编写Mapper接口

public interface UserMapper {
    //查询所有用户
    List<User> getAllUsers();
}

2. 编写对应的Mapper中的sql语句

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
        <!--namespace绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.yjr.dao.UserMapper">
    <!--    查询语句-->
    <select id="getAllUsers" resultType="com.yjr.pojo.User">
        select * from user
    </select>
</mapper>

3. 测试

public class UserDaoTest {
    @Test
    public void getAllUsersTest() throws IOException {
        //1.获取SQLSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        //方式一：getMapper-----目前最好用
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        System.out.println(mapper.getAllUsers());
        sqlSession.close();
    }
}

3.3、Insert

<!--增删改需要提交事务-->
<insert id="addUser" parameterType="com.yjr.pojo.User">
        insert into user (id,name,pwd) values(#{id},#{name},#{pwd})
</insert>

3.4、Delete

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

3.5、Update

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

3.6、注意点

• MyBatis配置文件的resource绑定Mapper需要使用路径！如果是包-路径那就是点

<!--     每一个Mapper.xml都需要在MyBatis核心配置文件中注册！ 这里是斜杠  -->
    <mappers>
        <mapper resource="com/yjr/dao/UserMapper.xml"/>
<!--        <package name="com.yjr.dao"/>-->
    </mappers>

• 程序配置文件必须书写规范
• 输出的Xml文件中存在乱码问题

3.7、万能Map

假设，我们的实体类，或者数据库中的表、字段参数过多， 我们应当考虑用Map传参！

• Mapper接口

//万能Map实现对用户的添加
    int addUser2(Map<String,Object> map);

• Mapper.xml

    <!--对象的属性可以直接取出来-->
    <insert id="addUser2" parameterType="map">
        insert into user (id,name,pwd) values(#{id},#{username},#{pwd})
    </insert>

• 测试

   @Test
    public void  addUser2() throws IOException {


        //1.获取SQLSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        //方式一：getMapper-----目前最好用
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        HashMap<String, Object> userHashMap = new HashMap<String, Object>();
        userHashMap.put("id","5");
        userHashMap.put("username","ww");
        userHashMap.put("pwd","w11w");
        System.out.println(mapper.addUser2(userHashMap));
        //提交事务
        sqlSession.commit();
        sqlSession.close();
    }

Map传递参数，直接在sql中取出key即可！[parameterType=“map”]

对象传递蚕食，直接在sql中取出对象的属性即可！[parameterType=“com.yjr.pojo.User”]

只有一个基本类型参数的情况下，可以直接在sql中取到！[parameterType=“int”(也可省略)]

多个参数用Map或者注解

3.8、模糊查询

模糊查询的写法：

• Java代码执行的时候，传递通配符% %

select * from user  where name like "%"#{value}"%"

• 在sql拼接中使用通配符

mapper.getUserLikeValue("%李%")