Mybatis之配置文件与映射文件的“那些事”,你真的知道吗?(上)

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群版 2核4GB 100GB
推荐场景:
搭建个人博客
云数据库 RDS MySQL,高可用版 2核4GB 50GB
简介: Mybatis之配置文件与映射文件的“那些事”,你真的知道吗?(上)

编译软件:IntelliJ IDEA 2019.2.4 x64

操作系统:win10 x64 位 家庭版

Maven版本:apache-maven-3.6.3

Mybatis版本:3.5.6

一.详解Mybatis的核心配置文件【mybatis-config.xml】

1.1 核心配置文件概述

MyBatis的配置文件包含了会深深影响MyBatis行为的设置和属性等相关信息

1.2 核心配置文件之根标签

作用:

在根标签内部设置所有的子标签

语法:

<configuration>
</configuration>

1.3核心配置文件之常用子标签

1.3.1 properties子标签

作用:

可以定义属性或引入外部属性文件

为什么要引入外部属性文件?

实现数据库连接属性的解耦

应用场景:

①在properties 元素中设置相应属性

怎么设置?

在properties 元素的子元素中设置数据库连接对象的driver与与ur的属性值

设好的属性driver与url可以在dataSource标签下相同的属性中动态替换它们的属性值,如下图所示。

用法案例:在核心配置文件中使用properties子标签设置数据库连接需要的driver与url属性,将其属性值引用至environments标签下的dataSource子标签中相应的属性中,运行测试。

示例代码如下:

①在核心配置文件中使用properties子标签设置数据库连接需要的driver与url属性,将其属性值引用至environments标签下的dataSource子标签中相应的属性中

<properties>
    <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/0411db?serverTimezone=UTC"/>
</properties>
<environments default="development">
    <environment id="development">
        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <!--   下面是mysql8版本            -->
            <property name="driver" value="${driver}"/>
            <!--    url后要加时区 ?serverTimezone=UTC" ,不然报错           -->
            <property name="url" value="${url}"/>
        <!-- 下面是mysql5版本的写法
             <property name="driver"value="com.mysql.jdbc.Driver"/>
             <property name="url"value="jdbc:mysql://localhost:3306/0411db"/>
            -->
            <property name="username" value="root"/>
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
</environments>

②运行测试

②引入外部属性文件

如何在外部定义并引入数据库连接的属性文件?

  1. 例如在resources目录下定义一个db.properties文件,用以存放数据库连接的相关属性值

  1. 在核心配置文件中使用properties标签引入外部的属性文件db.properties

注意:properties标签内两种引用文件的方式resource与url)的区别,如下图所示:

示例代码如下:

<properties resource="db.properties"></properties>
<environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <!--   下面是mysql8版本            -->
                <property name="driver" value="${db.driver}"/>
                <!--    url后要加时区 ?serverTimezone=UTC" ,不然报错           -->
                <property name="url" value="${db.url}"/>
            <!-- 下面是mysql5版本的写法
                 <property name="driver"value="com.mysql.jdbc.Driver"/>
                 <property name="url"value="jdbc:mysql://localhost:3306/0411db"/>
                -->
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>

1.3.2 settings 子标签

作用:

这是MyBatis中极为重要的调整设置,它会改变MyBatis的运行时行为。

常用属性:

mapUnderscoreToCamelCase属性是否开启驼峰命名自动映射,默认值为false,如设置true会自动将数据库中的字段a_col与Java对象中的aCol属性自动映射

注意:

只能将字母相同的字段与属性自动映射

示例代码如下;

a.在核心配置文件中的settings里未设置mapUnderscoreToCamelCase的值时:

b.在核心配置文件中设置mapUnderscoreToCamelCase的属性为true时:

<settings>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

1.3.3 typeAliases(类型别名)子标签

作用:

类型别名可为Java类型设置一个别名

语法及特点:

①为Java pojo(Java bean【实体类】)设置别名(不常用)

<typeAliases>
  //为指定类型定义别名,前者是类的全类名,后者是该类的别名(小名)
    <typeAlias type="mybatis.mapper.EmployeeMapper" alias="employee"
</typeAliases>

②为指定包下的所有pojo起别名(常用)

<typeAliases>
  //为指定包【mybatis.pojo】下所有的类定义别名。
  //默认将类名作为别名,不区分大小写【推荐使用小写字母】
    <package name="mybatis.pojo"/>
</typeAliases>

1.3.3.1 Mybatis 常用的自定义别名

别名 类型
_int int
integer或int Integer
string String
list或arraylist ArrayList
map或hashmap HashMap

注:Java的其他基本数据类型与int的Mybatis自定义别名的命名风格雷同,包装类型也是如此,这里不做赘述。

1.3.4 environments(环境配置)子标签

作用:

设置数据库连接环境

示例代码如下:

//设置数据库的连接环境
<environments default="development">
  //可设置多个<environment></environment>
    <environment id="development">
      //设置事务管理器的相应属性
        <transactionManager type="JDBC"/>
        //设置数据源
        <dataSource type="POOLED">
          //设置数据库连接的相应属性 
            <!--   下面是mysql8版本            -->
            //设置数据库连接的driver(驱动)
            <property name="driver" value="${db.driver}"/>
            <!--    url后要加时区 ?serverTimezone=UTC" ,不然报错  ->
             //设置数据库连接的url
            <property name="url" value="${db.url}"/>
          <!-- 下面是mysql5版本的写法
             <property name="driver"value="com.mysql.jdbc.Driver"/>
             <property name="url"value="jdbc:mysql://localhost:3306/0411db"/>
            -->
             //设置数据库连接所需要的能够登录MySQL的用户名
            <property name="username" value="root"/>
             //设置密码
            <property name="password" value="123456"/>
        </dataSource>
    </environment>
</environments>

1.3.5 mappers(映射器)子标签

作用:

设置加载映射文件的路径

示例代码如下:

<mappers>
  <mapper resource="mapper/EmployeeMapper.xml"/>
  //有些老项目可能会这么写
  <!--要求:接口的包名与陕射义件的包名需要致-->
  <package name="com.atguigu.mybatis.mapper"/>
</mappers>

注意:

核心配置文件中的子标签,是有顺序要求的

默认顺序如下:

不信,大可以试试!


二. 详解Mybatis的映射文件

2.1 映射文件概述

Mybatis的真正强大在于它的语句映射,这是它的魔力所在。如果拿它跟具有相同功能的JDBC代码进行对比,你会立即发现省掉了将近95%的代码。(摘自官方文档)

2.2 映射文件之根标签

根标签:mapper标签

注意:

mapper中的namespace要求与接口的全类名一致

如何获取接口(方法/ pojo)的全类名?

①将光标置于要获取的接口名上

如下图所示:

②鼠标右击打开下面的选项栏,点击"copy Reference“

③”mybatis.mapper.DeptMapper"就是刚才接口名的全名称

2.3 映射文件子标签

2.3.1 insert标签

功能:

定义添加sql语句

用法案例:

使用insert标签插入一条数据(employee对象)到数据库中

①在EmployeeMapper接口中先定义添加数据的方法

代码示例如下:

//添加员工
public void insertEmployee(Employee employee);

②在上述接口对应的映射文件中使用insert标签

代码示例如下:

<insert id="insertEmployee">
    insert into
        tbl_employee(last_name,email,salary)
    <!--  这里是要将employee对象中的属性值传到mysql中    -->
    values(#{lastName},#{email},#{salary})
</insert>

③测试

@Test
public void testInsertEmployee(){
    try {
        String resource = "mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new                           SqlSessionFactoryBuilder().build(inputStream);
        //通过SqlSessionFactory对象调用openSession();
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //获取EmployeeMapper的代理对象
        EmployeeMapper employeeMapper = sqlSession.getMapper(EmployeeMapper.class);
        employeeMapper.insertEmployee(new Employee("张三","hdfjf@163.com",9000.0));
        //开启事务,数据才能真正存进数据库中,why?
        sqlSession.commit();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

这里有一个问题:即使用mybatis,添加数据到MySQL数据库中时,代码中为什么要加sqlSession.commit()这句代码后,数据才能真正存进数据库中?

解释:

在使用 Mybatis 操作数据时,调用插入或更新方法后,SQL 语句并不会立即执行,而是被缓存到当前的 SqlSession 对象中。这个字面意义上的 Session 就像一个会话,预计会涉及多个数据库操作,其生命周期通常是跨越过多个请求和响应 (request,response) 阶段。

因此,如果想要将数据真正存入数据库中,需要手动触发一次提交 (commit) 动作。Mybatis 中 SqlSession 接口提供了 commit() 方法来提交事务,以便将所有未提交的 SQL 语句立即执行,并将结果存入数据库。

也就是说,sqlSession.commit() 可以将之前缓存的 SQL 语句批量地发送给数据库进行处理。同时,如果没有提交事务,之前所做的更改全部都将被回滚,并且数据库不会有任何变化。

因此,在使用 Mybatis 进行数据操作时,添加 sqlSession.commit() 这句代码是非常必要的,否则可能出现数据插入失败的情况。

相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
2月前
|
XML Java 数据库连接
MyBatis入门——MyBatis XML配置文件(3)
MyBatis入门——MyBatis XML配置文件(3)
44 6
|
23天前
|
SQL Java 数据库连接
idea中配置mybatis 映射文件模版及 mybatis plus 自定义sql
idea中配置mybatis 映射文件模版及 mybatis plus 自定义sql
38 3
|
2月前
|
SQL XML Java
后端数据库开发JDBC编程Mybatis之用基于XML文件的方式映射SQL语句实操
后端数据库开发JDBC编程Mybatis之用基于XML文件的方式映射SQL语句实操
45 3
若依修改,集成mybatisplus报错,若依集成mybatisplus,总是找不到映射是怎么回事只要是用mp的方法就找报,改成mybatisPlus配置一定要改
若依修改,集成mybatisplus报错,若依集成mybatisplus,总是找不到映射是怎么回事只要是用mp的方法就找报,改成mybatisPlus配置一定要改
|
1月前
|
XML Java 数据格式
支付系统----微信支付20---创建案例项目--集成Mybatis-plus的补充,target下只有接口的编译文件,xml文件了,添加日志的写法
支付系统----微信支付20---创建案例项目--集成Mybatis-plus的补充,target下只有接口的编译文件,xml文件了,添加日志的写法
|
1月前
|
Java 数据库连接 Maven
Private method ‘getVideoList()‘ is never used,mybatis必须指定Mapper文件和实体目录,在参考其他人写的代码,要认真分析别人的代码,不要丢失
Private method ‘getVideoList()‘ is never used,mybatis必须指定Mapper文件和实体目录,在参考其他人写的代码,要认真分析别人的代码,不要丢失
|
3月前
|
算法 BI 数据库
MyBatisPlus查询条件设置、映射匹配兼容性、id生成策略、多数据操作
MyBatisPlus查询条件设置、映射匹配兼容性、id生成策略、多数据操作
101 3
|
3月前
|
SQL Java 数据库连接
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射
【Mybatis】深入学习MyBatis:概述、主要特性以及配置与映射
|
3月前
|
SQL Java 数据库连接
Mybatis快速入门,Mybatis的核心配置文件
Mybatis快速入门,Mybatis的核心配置文件
36 1
|
3月前
|
SQL Java 数据库连接
15:MyBatis对象关系与映射结构-Java Spring
15:MyBatis对象关系与映射结构-Java Spring
66 4