编译软件: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>
②运行测试
②引入外部属性文件
如何在外部定义并引入数据库连接的属性文件?
- 例如在resources目录下定义一个db.properties文件,用以存放数据库连接的相关属性值
- 在核心配置文件中使用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() 这句代码是非常必要的,否则可能出现数据插入失败的情况。