mybatis-config.xml
是 MyBatis 的核心配置文件,用于配置整个 MyBatis 框架的全局行为,比如环境(数据源)、事务、类型别名、插件、Mapper 映射等。
示例:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 映入外部的properties文件 --><properties resource="db.properties"/><!-- 开启Mybatis对标准日志的视线 --><settings><setting name="logImpl" value="SLF4J"/></settings><environments default="development"><!-- 每一个environment对应一个SqlSessionFactory --><environment id="development"><!-- 事务管理器 --><transactionManager type="JDBC"/><dataSource type="POOLED"><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><!-- 执行XxxMapper.xml文件的路径 --><!-- resource路径自动会从根路径下开始查找资源 --><mappers><mapper resource="CarMapper.xml"/></mappers>
</configuration>
一、xml配置文件的开头:
1、任意的xml文件的首行,都是如下的配置:
<?xml version="1.0" encoding="UTF-8" ?>
2、xml文件中根标签的名字
3、dtd是对xml文件的约束:能有什么标签,标签的顺序,标签的属性,有哪些子标签......
二、<environments>:环境标签
可以配置多个环境,一个环境对应一个sqlsessionFactory对象。
在java中创建sqlSessionFactory的时候,可以指定环境的id,表明,用哪一个数据库创建的sqlSessionFactory:
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();// 两种方式创建sqlSessionFactory
// 1、没有指明具体的environment中的id,则用默认的environment
SqlSessionFactory sqlSessionFactory1 = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));// 2、指明具体的environment中的id
SqlSessionFactory sqlSessionFactory2 = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"),
三、Mybatis的事务管理器
<transactionManager>标签:
1、作用:配置事务管理器。指定mybatis具体使用什么方式去管理事务。
2、type属性有两个值:
第一个:JDBC:使用原生的JDBC代码来管理事务。
第二个:MANAGED:mybatis不再负责事务的管理,将事务管理交给其它的JEE(JavaEE)容器来管理。例如:spring
3、大小写无所谓。不区分大小写。但是不能写其他值。只能是二选一: jdbc、managed
4、在mybatis中提供了一个事务管理器接口:Transaction 该接口下有两个实现类:
- JdbcTransaction
- ManagedTransaction
如果type="JDBC",那么底层会实例化JdbcTransaction对象。
如果type="MANAGED",那么底层会实例化ManagedTransaction。
四、dataSource配置
3-1、基本配置介绍
1、dataSource被称为数据源。
2、dataSource作用是什么?
为程序提供Connection对象。
【注意】:
但凡是给程序提供Connection对象的,都叫做数据源。
3、数据源实际上是一套规范(接口)。
JDK中有这套规范:javax.sql.DataSource(这个数据源的规范,这套接口实际上是JDK规定的。)
4、我们自己也可以编写数据源组件,只要实现javax.sql.DataSource接口就行了。实现接口当中所有的方法。这样就有了自己的数据源。
比如你可以写一个属于自己的数据库连接池(数据库连接池是提供连接对象的,所以数据库连接池就是一个数据源)。
5、常见的数据源组件有哪些呢【常见的数据库连接池有哪些呢】?
阿里巴巴的德鲁伊连接池:druid
c3p0
dbcp
....
6、type属性用来指定数据源的类型,就是指定具体使用什么方式来获取Connection对象:
type属性有三个值:必须是三选一。
type="[UNPOOLED|POOLED|JNDI]"
- UNPOOLED:不使用数据库连接池技术。每一次请求过来之后,都是创建新的Connection对象。
- POOLED:使用mybatis自己实现的数据库连接池。
- JNDI:集成其它第三方的数据库连接池。
3-2、JNDI
JNDI是一套规范,大部分web容器都实现了这个规范:例如Tomcat、Jetty、WebLogic、WebSphere。这些服务器(容器)都实现了JNDI规范。
所以,可以把对应的连接池,配置到服务器(容器)中,如:druid配置到Tomcat中,然后Tomcat会给druid提供一个上下文的名称,将上下文的名称配到对应的<datasource>位置即可。
使用
<dataSource type="JNDI">
就是告诉 MyBatis:别自己创建数据库连接了,去应用服务器(Tomcat/GlassFish/WebLogic)拿现成的连接池资源。
3-3、type = "POOLED"和UNPOOLED对比
测试代码:
@Testpublic void testType() throws Exception{SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(Resources.getResourceAsStream("mybatis-config.xml"));// SqlSessionFactory可以创建多个SqlSession!SqlSession sqlSession = sqlSessionFactory.openSession();Object selectById = sqlSession.selectOne("selectById", 12);System.out.println(selectById);sqlSession.commit();sqlSession.close();// 第二次创建SqlSession sqlSession2 = sqlSessionFactory.openSession();Object selectById2 = sqlSession2.selectOne("selectById", 12);System.out.println(selectById2);sqlSession2.commit();sqlSession2.close();}
情况一:type = "UNPOOLED"
两个connection对象不一样!
情况二:type = "POOLED"
同一个connection对象!
五、property标签
在 MyBatis 的 mybatis-config.xml
配置文件中,<properties>
标签用于引入外部属性文件或者在 XML 中内联配置参数,这些参数可以被用于整个配置文件中的占位符(${}
)替换,例如数据库连接、分页插件参数等。
一句话理解:
<properties>
就是给 MyBatis 提供参数值的地方,支持从外部.properties
文件读取,也可以直接在 XML 中写死键值对,用于${xxx}
占位符替换。
4-1、用法示例 1:引入外部属性文件
文件结构
src/
├── mybatis-config.xml
└── db.properties
db.properties 内容:
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mydb
jdbc.username=root
jdbc.password=123456
mybatis-config.xml 内容:
<configuration><!-- 映入外部的properties文件 --><properties resource="db.properties"/><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><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></configuration>
resource 路径是 classpath 相对路径
示例:resource="db.properties"
表示类路径下的db.properties
【备注】:
![]()
不建议!
4-2、用法示例 2:在 XML 中内联写属性
<configuration><properties><property name="jdbc.driver" value="com.mysql.cj.jdbc.Driver"/><property name="jdbc.url" value="jdbc:mysql://localhost:3306/mydb"/><property name="jdbc.username" value="root"/><property name="jdbc.password" value="123456"/></properties><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><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></configuration>
4-3、属性优先级(默认行为):
如果你同时指定了外部文件(resource
或 url
)和内联属性(<property>
子标签),那么:
内联属性优先,会覆盖外部文件中相同的属性值。
4-4、常见属性用途
位置 | 用途 |
---|---|
<dataSource> | 数据库连接参数 |
插件(如分页插件) | 配置插件行为 |
<settings> | 配置全局行为开关 |