配置文件详解
1.1 核心配置文件
这些配置会影响Mybatis的行为和属性,注意元素节点的顺序!顺序不对会报错
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
可以使用properties读取properties配置文件。使用其中的resource属性来设置配置文件的路径。然后使用${key}来获取配置文件中的值
jdbc.url=jdbc:mysql://localhost:3306/mybatis_db
jdbc.driver=com.mysql.jdbc.Driver
jdbc.username=root
jdbc.password=root
mybatis-config.xml文件
<?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>
<!--设置配置文件所在的路径-->
<properties resource="jdbc.properties"></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>
1.1.1 environment
如果配置Mybatis的多套运行环境,将Sql映射到多个不同的数据库上,必须指定其中一个为默认运行环境(可通过default来指定)
id | 唯一标识 |
---|---|
transactionManager | 事务管理器,[JDBC 、MANAGED] 不需要设置任何属性 |
dataSource | [ UNPOOLED、POOLED、JNDI ]三种内置数据源类型 |
unpooled: 这个数据源的实现只是每次被请求时打开和关闭连接。
pooled: 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
数据源还有很多第三方实现
1.2 settings
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/> <!--开启自动驼峰命名映射-->
<setting name="lazyLoadingEnabled" value="true"/> <!-- 懒加载 -->
</settings>
更多设置参考地址 https://mybatis.org/mybatis-3/zh/configuration.html#settings
1.3 typeAliases
可以用来为全类名设置别名,简化书写。一般设置一个包下的类全部具有默认别名。默认别名是类目首字母小写,eg:com.lzy.entities.User别名为user
其中的java Bean 在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名,若有注解,则别名为其注解值
@Alias("user")
public class User {
...
}
<typeAliases>
<package name="com.sangeng.dao"></package>
</typeAliases>
1.4 environments
配置数据库相关的环境—事务、连接池
<!--设置默认环境-->
<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>
1.5 mappers
加载映射;几种方式中主要使用第一种,即定义映射SQL语句文件
1.5.1配置
1.5.1.1将包内的映射器接口实现全部注册为映射器
<!-- 定义dao接口所在的包。要求xml文件存放的路径和dao接口的包名要对应 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
1.5.1.2 使用相对于类路径的资源引用
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
</mappers>
1.5.1.3 使用映射器接口实现类的完全限定类名
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>
1.5.1.4 使用完全限定资源定位符(URL)
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>
1.5.2 mapper文件
<?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.kuang.mapper.UserMapper">
</mapper>
- namespace :命名空间,namespace和子元素的id联合保证唯一 , 区别不同的mapper
- namespace的命名必须跟某个接口同名
- 接口中的方法与映射文件中sql语句id应该一一对应
- namespace命名规则 : 包名+类名
1.6 properties优化
创建 db.properties文件
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?
useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
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="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
1.7 类型处理器(了解)
无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。
1.8 对象工厂(了解)
MyBatis 每次创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成。
默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认构造方法,要么在参数映射存在的时候通过有参构造方法来实例化。