MyBatis复习笔记2：配置文件详解

配置文件详解

属性（properties）

MyBatis可以使用 properties 来引入外部 properties 配置文件的内容
resource：引入类路径下的资源
url：引入网络路径或者磁盘路径下的资源

properties 有三种方式使用：
1、通过 resource/url 属性指定配置文件

<properties resource="dbconfig.properties"></properties>

2、properties 元素体内指定的属性

<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>

3、通过 SqlSessionFactoryBuilder.build() 方法中传入属性值。例如：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, props);

//或者
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, props);

如果一个属性在不只一个地方进行了配置，那么，MyBatis 将按照下面的顺序来加载：

• 首先读取在 properties 元素体内指定的属性。
• 然后根据 properties 元素中的 resource 属性读取类路径下属性文件，或根据 url 属性指定的路径读取属性文件，并覆盖之前读取过的同名属性。
• 最后读取作为方法参数传递的属性，并覆盖之前读取过的同名属性。

因此，通过方法参数传递的属性具有最高优先级，resource/url 属性中指定的配置文件次之，最低优先级的则是 properties 元素中指定的属性。

设置（settings）

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

想要详细了解 settings 中各项设置的含义、默认值等可以访问MyBatis的官方文档：
https://mybatis.org/mybatis-3/zh/configuration.html#settings

name：设置项名
value：设置项取值

	<!-- 
		name：设置项名
		value：设置项取值
	 -->
	<settings>
		<setting name="mapUnderscoreToCamelCase" value="true"/>
	</settings>

类型别名（typeAliases）

类型别名可为 Java 类型设置一个缩写名字，意在降低冗余的全限定类名书写，别名不区分大小写（注：最好不要使用别名，能用全限定类名就用全限定类名）

1、typeAlias:为某个java类型起别名
type:指定要起别名的类型全类名;默认别名就是类名小写
alias:指定新的别名

<typeAliases>
	<typeAlias type="com.gcl.entity.Person" alias="per"/>
</typeAliases>

2、package:为某个包下的所有类批量起别名
name：指定包名（为当前包以及下面所有的后代包的每一个类都起一个默认别名（类名小写））

<typeAliases>
	<package name="com.gcl.entity"/>
</typeAliases>

3、批量起别名的情况下，使用@Alias注解为某个类型指定新的别名

@Alias("per")
public class Person {
    private String name;
    private int age;
}

环境配置（environments）

MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置。
注意：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境

标签说明：
environments 标签定义了如何配置环境，default指定使用某种环境，可以快速切换环境。
environment：配置一个具体的环境信息，id代表当前环境的唯一标识；内部必须有两个标签（transactionManager 和 dataSource）：

• transactionManager：事务管理器：
  • type：事务管理器的类型，共有两种，分别是JDBC(JdbcTransactionFactory) 和 MANAGED(ManagedTransactionFactory)
    • JDBC：这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域。
    • MANAGED：这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接。
    • 自定义事务管理器：实现 TransactionFactory 接口，type指定为全类名

注意：如果使用 Spring + MyBatis，则没有必要配置事务管理器，因为 Spring 模块会使用自带的管理器来覆盖前面的配置。

• dataSource：数据源;
  • type：数据源类型;
    • UNPOOLED(UnpooledDataSourceFactory)：不使用连接池
    • POOLED(PooledDataSourceFactory)：使用连接池
    • JNDI(JndiDataSourceFactory)
    • 自定义数据源：实现DataSourceFactory接口，type是全类名

	<environments default="dev_mysql">
	
		<environment id="dev_mysql">
			<transactionManager type="JDBC"></transactionManager>
			<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>
	
		<environment id="dev_oracle">
			<transactionManager type="JDBC" />
			<dataSource type="POOLED">
				<property name="driver" value="${orcl.driver}" />
				<property name="url" value="${orcl.url}" />
				<property name="username" value="${orcl.username}" />
				<property name="password" value="${orcl.password}" />
			</dataSource>
		</environment>
	</environments>

数据库厂商标识（databaseIdProvider）

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。 MyBatis 会加载带有匹配当前数据库 databaseId 属性和所有不带 databaseId 属性的语句。 如果同时找到带有 databaseId 和不带 databaseId 的相同语句，则后者会被舍弃。 为支持多厂商特性，只要在 mybatis-config.xml 文件中加入 databaseIdProvider 即可。

type=“DB_VENDOR”：VendorDatabaseIdProvider
作用就是得到数据库厂商的标识(驱动getDatabaseProductName())，MyBatis就能根据数据库厂商标识来执行不同的SQL

<databaseIdProvider type="DB_VENDOR">
	<!-- 为不同的数据库厂商起别名 -->
	<property name="MySQL" value="mysql"/>
	<property name="Oracle" value="oracle"/>
	<property name="SQL Server" value="sqlserver"/>
</databaseIdProvider>

映射器（mappers）

将 SQL 映射注册到全局配置中。
注册配置文件：

• resource：引用类路径下的 SQL 映射文件
  • mybatis/mapper/PersonMapper.xml

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="com/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="com/mybatis/builder/BlogMapper.xml"/>
</mappers>

• url：引用网路路径或者磁盘路径下的sql映射文件
  • file:///var/mappers/AuthorMapper.xml

<!-- 使用完全限定资源定位符（URL） -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
</mappers>

注册接口
class：引用（注册）接口，
1、有 SQL 映射文件，映射文件名必须和接口同名，并且放在与接口同一目录下；
2、没有 SQL 映射文件，所有的 SQL 都是利用注解写在接口上;

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="com.mybatis.builder.AuthorMapper"/>
  <mapper class="com.mybatis.builder.BlogMapper"/>
</mappers>

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="com.mybatis.builder"/>
</mappers>

推荐：
比较重要的，复杂的Dao接口我们来写 SQL 映射文件
不重要，简单的Dao接口为了开发快速可以使用注解；