mybatis学习笔记

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
云数据库 RDS MySQL,高可用系列 2核4GB
简介: 自学笔记

一、MyBatis

1、MyBatis简介

1.1、MyBatis特性:

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

1.2、和其他持久化层技术对比

  • JDBC

    • SQL 夹杂在Java代码中耦合度高,导致硬编码内伤
    • 维护不易且实际开发需求中 SQL 有变化,频繁修改的情况多见
    • 代码冗长,开发效率低
  • Hibernate 和 JPA

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

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

2、搭建MyBatis

2.1、开发环境

IDE:idea 2019.2

构建工具:maven 3.5.4

MySQL版本:MySQL 8

MyBatis版本:MyBatis 3.5.7

  • MySQL不同版本的注意事项
    • 1、驱动类driver-class-name
    • MySQL 5版本使用jdbc5驱动,驱动类使用:com.mysql.jdbc.Driver
    • MySQL 8版本使用jdbc8驱动,驱动类使用:com.mysql.cj.jdbc.Driver
    • 2、连接地址url MySQL 5版本的url: jdbc:mysql://localhost:3306/ssm
    • MySQL 8版本的url: jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC
    • 否则运行测试用例报告如下错误:
    • java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more

2.2、创建maven工程

  • 添加打包方式:jar
<packaging>jar</packaging>
  • 引入依赖
<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.12</version>
<scope>test</scope>
</dependency>

<!-- MySQL驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.49</version>
</dependency>
</dependencies>
  • 配置好映射后建立对应数据库和表,再创建实体类和其达成映射关系

2.3、创建MyBatis的核心配置文件

  • 核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息
  • 核心配置文件存放的位置是src/main/resources目录下
<?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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/ssm?
serverTimezone=UTC"/>
<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仅仅是接口,我们不需要 提供实现类。
public interface UserMapper {
   
    //添加用户信息
    int insertUser();
}

2.5、创建MyBatis的映射文件

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

  • 对象:Java的实体类对象
  • 关系:关系型数据库
  • 映射:二者之间的对应关系
Java概念 数据库概念
属性 字段/列
对象 记录/行
  • 映射文件的命名规则:
    • 表所对应的实体类的类名+Mapper.xml
    • 例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
    • 因此一个映射文件对应一个实体类,对应一张表的操作
    • MyBatis映射文件用于编写SQL,访问以及操作表中的数据
    • MyBatis映射文件存放的位置是src/main/resources/mappers目录下
      • MyBatis中可以面向接口操作数据,要保证两个一致:
      • mapper接口的全类名和映射文件的命名空间(namespace)保持一致
      • mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致
<?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.xujicheng.mybatis.mapper.UserMapper">
    <!--int insertUser();-->
    <insert id="insertUser">
        INSERT INTO t_user VALUES(null,'admin','123456','23','女','123456@qq.com')
    </insert>
</mapper>

2.6、通过junit测试功能

public class MyBatisTest {
   
    @Test
    public void testInsert() throws IOException {
   
        //获取核心配置文件的输入流
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

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

        //获取sqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = sqlSessionFactory.openSession();

        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        //然后就可以调用mapper接口中的方法,实现添加用户信息的功能
        int result = mapper.insertUser();
        System.out.println("结果:" + result);

        //提交事务
        sqlSession.commit();
        //关闭sqlSession
        sqlSession.close();
    }
}
  • SqlSession:代表Java程序和数据库之间的会话。(HttpSession是Java程序和浏览器之间的 会话)
  • SqlSessionFactory:是“生产”SqlSession的“工厂”。
  • 工厂模式:如果创建某一个对象,使用的过程基本固定,那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中,以后都使用这个工厂类来“生产”我们需要的对象。

2.7、加入log4j日志功能

  • 1、加入依赖
<!-- log4j日志 -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
  • 2、加入log4j的配置文件
    • log4j的配置文件名为log4j.xml,存放的位置是src/main/resources目录下
<?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>
  • 日志的级别
  • FATAL(致命)>ERROR(错误)>WARN(警告)>INFO(信息)>DEBUG(调试)
  • 从左到右打印的内容越来越详细

3、核心配置文件详解

3.1、核心配置文件中的标签必须按照固定的顺序:

properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,refl
ectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?

3.2、properties标签

  • 引入properties文件,此后就可以在当前文件中使用${key}的方式来访问value
  • properties文件的配置
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?useSSL=false
jdbc.username=root
jdbc.password=123456
<!--引入properties文件,此后就可以在当前文件中使用${key}的方式来访问value-->
<properties resource="jdbc.properties"/>

3.3、typeAliases标签

<!--
    typeAliases:设置类型别名,为某个具体的类型设置一个别名
    在Mybatis的范围中,就可以使用别名表示一个具体的类型
-->
<typeAliases>
    <!--
        type:设置需要起别名的类型
        alias:设置某个类型的别名
    -->
    <!--<typeAlias type="com.zylai.mybatis.pojo.User" alias="abc"/>-->
    <!--如果不设置alias属性,那么默认的别名就是类名且不区分大小写-->
    <!--<typeAlias type="com.zylai.mybatis.pojo.User"/>-->

    <!--通过包来设置类型别名,指定包下所有的类型将全部拥有默认的别名,即类名且不区分大小写-->
    <package name="com.zylai.mybatis.pojo"/>
</typeAliases>

3.4 environment标签

<!--    配置连接数据库的环境-->
<!--
        environments:配置连接数据库的环境
        属性:
            default:指定默认使用的环境,比如选择开发和测试
-->
    <environments default="development">
<!--        environment:设置一个具体的连接数据库的环境
            属性:
            id:设置环境的唯一标识,不能重复
-->
        <environment id="development">
            <!--
               transactionManager:设置事务管理器
               属性:
               type:设置事务管理的方式。JDBC或MANAGED
               JDBC:表示使用JDBC中原生的事务管理方式
               MANAGED: 被管理,例如Spring
            -->
            <transactionManager type="JDBC"/>
            <!--
            dataSource:设置数据源
            属性:
             type:设置数据源的类型;
             值:POOLED,UNPOOLED,JNDI
             POOLED:表示使用数据库连接池
             UNPOOLED:不使用数据库连接池,每一次获取连接时都重新创建连接
             JNDI:(了解)表示使用上下文中的数据源
            -->
            <dataSource type="POOLED">
                <!--注意,这里是mysql8.0的配置,如果是mysql5,就是com.mysql.jdbc.Driver-->
                <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>

        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <!--注意,这里是mysql8.0的配置,如果是mysql5,就是com.mysql.jdbc.Driver-->
                <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>

3.5、mappers

  • 使用package起别名
<!--    引入mybatis的映射文件,映射文件中是操作数据库的SQL语句,需要通过
当前的核心配置文件引入映射文件-->
    <mappers>
        <!--<mapper resource="mappers/UserMapper.xml"/>-->
        <!--
        相当于typeAliases给mapper起别名
            以包的方式引入映射文件,但是必须满足两个条件:
             1.mapper接口和映射文件所在的包必须一致
             2.mapper接口的名字和映射文件的名字必须一致

             这样一来mapper映射文件和mapper接口的类加载之后会在同一个目录下
        -->
        <package name="com.zylai.mybatis.mapper"/>
    </mappers>

4、MyBatis的增删改查

  • 首先编写一个工具类用来封装增删改查功能
public class SqlSessionUtil {
   
    public static SqlSession getSqlSession(){
   
        //需要将SqlSession返回就要把它的作用域向上提级
        SqlSession sqlSession = null;
        try {
   
            //获取核心配置文件的输入流,来使用Resources中的getResourceAsStream方法,参数放入核心配置文件
            InputStream is = Resources.getResourceAsStream("mybatis-config.xml");

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

            //获取SessionFactory通过sqlSessionFactoryBuilder.build方法把字节输入流放入即可获取
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);

            //获取SqlSession对象,参数写入true表示它会自动提交事务,无需再手动提交
            sqlSession = sqlSessionFactory.openSession(true);
        } catch (IOException e) {
   
            e.printStackTrace();
        }
        return sqlSession;
    }
    //至此工具类创建完成,创建测试方法去测试一下功能

4.1、新增

  • 在UserMapper接口中加入方法
public interface UserMapper {
   
    //添加用户信息
    int insertUser();
  • 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
    <!--int insertUser();-->
    <insert id="insertUser">
        INSERT INTO t_user VALUES(null,'admin','123456','23','女','123456@qq.com')
    </insert>
  • 通过测试来实现新增功能
    @Test
    public void testInsert(){
   
        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //然后就可以调用mapper接口中的方法,实现添加用户信息的功能
        mapper.insertUser();
        //使用完毕后记得关闭
        sqlSession.close();
    }

4.2、删除

  • 在UserMapper接口中新增方法
public interface UserMapper {
   
    //删除用户信息
    void DeleteUser();
}
  • 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
 <!-- void DeleteUser();-->
    <delete id="DeleteUser">
        DELETE FROM t_user WHERE id = 8
    </delete>
  • 通过测试来实现删除功能
  @Test
    public void testDeleteUser(){
   
        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //然后就可以调用mapper接口中的方法,实现删除用户信息的功能
        mapper.DeleteUser();
        //使用完毕后记得关闭
        sqlSession.close();
    }

4.3、修改

  • 在UserMapper接口中新增方法
public interface UserMapper {
   
    //修改用户信息
    void UpdateUser();
}
  • 在配置文件UserMapper.xml中加入与实体类相对应的SQL语句实现映射
  <update id="UpdateUser">
        UPDATE t_user SET id='1' where id = 4
    </update>
  • 通过测试来实现修改功能
   @Test
    public void testUpdate(){
   
        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //然后就可以调用mapper接口中的方法,实现修改用户信息的功能
        mapper.UpdateUser();
        //使用完毕后记得关闭
        sqlSession.close();
    }

4.4、查询一个实体类对象

  • 在UserMapper接口中新增方法
public interface UserMapper {
   
      //根据id查询用户信息
    User getUserById();
}
  • 在配置文件UserMapper.xml中加入映射,并设置相对应的结果集
 <!--User getUserById();
    resultType:设置结果类型,即查询的数据要转换的Java类型
    resultMap:自定义映射,处理多对一或一对多的映射关系
    -->
    <select id="getUserById" resultType="com.xujicheng.mybatis.pojo.User">
        SELECT * FROM t_user WHERE id = 1
    </select>
  • 同样通过测试实现查询单个用户信息的功能
@Test
    public void TestGetUserById(){
   
        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //然后就可以调用mapper接口中的方法,实现查询用户信息的功能
        User user = mapper.getUserById();
        //使用完毕后记得关闭
        sqlSession.close();
    }

4.5、查询list集合

  • 在UserMapper接口中新增方法
public interface UserMapper {
   
    //查询多个用户信息就要用List作为容器
    List <User> getAllUser();
}
  • 在配置文件UserMapper.xml中加入映射,并设置相对应的结果集,这块需要注意的是返回的是返回的实体类已经是List类型属于映射中就不使用 resultMap映射了
 <!--List <User> getAllUser();-->
    <select id="getAllUser" resultType="com.xujicheng.mybatis.pojo.User">
        SELECT * FROM t_user
    </select>
  • 同样通过测试实现查询所有用户信息的功能,与查询单个用户稍微有些不同
    @Test
    public void TestGetAllUser(){
   
        //获取sql的会话对象sqlSession,是MyBatis提供的操作数据库的对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //由于UserMapper是一个接口,不能直接调用它的方法,所以获取此接口的代理实现类对象即可
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //然后就可以调用mapper接口中的方法,实现查询所有用户信息的功能
        List<User> list = mapper.getAllUser();
        //返回list类型并使用forEach方法去打印即可
        list.forEach(System.out::println);
        //使用完毕后记得关闭
        sqlSession.close();
    }
  • 注意:
    • 1、查询的标签select必须设置属性resultType或resultMap,用于设置实体类和数据库表的映射 关系
      • resultType:自动映射,用于属性名和表中字段名一致的情况
      • resultMap:自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
相关实践学习
如何快速连接云数据库RDS MySQL
本场景介绍如何通过阿里云数据管理服务DMS快速连接云数据库RDS MySQL,然后进行数据表的CRUD操作。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
XML Java 数据库连接
java202304java学习笔记第六十五天-ssm-声明式控制-基于xml的声明式配置-mybatis的概述2
java202304java学习笔记第六十五天-ssm-声明式控制-基于xml的声明式配置-mybatis的概述2
57 0
java202304java学习笔记第六十六天-ssm-mybatis-接口代理方法实现
java202304java学习笔记第六十六天-ssm-mybatis-接口代理方法实现
43 0
|
7月前
|
SQL Java 关系型数据库
MyBatisPlus学习笔记(SpringBoot版)
MyBatisPlus学习笔记(SpringBoot版)
514 0
|
SQL Java 关系型数据库
java202304java学习笔记第六十六天-ssm-mybatis的dao层实现1
java202304java学习笔记第六十六天-ssm-mybatis的dao层实现1
38 0
java202304java学习笔记第六十六天-ssm-mybatis中dao层实现-动态sql-foreach之2
java202304java学习笔记第六十六天-ssm-mybatis中dao层实现-动态sql-foreach之2
65 0
java202304java学习笔记第六十六天-ssm-mybatis中dao层实现-动态sql-if之1
java202304java学习笔记第六十六天-ssm-mybatis中dao层实现-动态sql-if之1
39 0
|
XML Java 数据库连接
java202304java学习笔记第六十五天-ssm-声明式控制-基于xml的声明式配置-mybatis的概述1
java202304java学习笔记第六十五天-ssm-声明式控制-基于xml的声明式配置-mybatis的概述1
65 0