mybatis学习总结4 mybatis的xml配置

在mybatis的配置xml文件中，
首先需声明xml的类型

<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">

configuration

除头部和xml文件类型声明外，整个文件被一对configuration标签包围。
查看mybatis 的xml配置规范文件http://mybatis.org/dtd/mybatis-3-config.dtd

<!ELEMENT configuration (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?, reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)>

可以看到configuration 元素下包含 properties，settings 等多个标签元素。
且这些标签的书写需要遵循dtd文件中的顺序。

properties属性标签

我们可以使用properties标签引入外部的.properties文件，这个应用经常用于datasource的值引用
jdbc.properties文件

# mysql Driver
mysql.jdbc.driverClass=com.mysql.cj.jdbc.Driver
# mysql db connection url
mysql.jdbc.url=jdbc:mysql://localhost:3306/kern?useSSL=true&serverTimezone=UTC
# mysql db connection username
mysql.jdbc.username=root
# mysql db connection password
mysql.jdbc.password=password

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">
     <!--引入外部properties文件-->
    <properties resource="resource/common/jdbc.properties" /> 
    
    <!--环境集标签-->
    <environments default="development" >
        <!--环境标签 连接环境信息，取一个任意唯一的名字-->
        <environment id="development">
            <!--mybatis使用JDBC的事务管理-->
            <transactionManager type="JDBC"/>
            <!-- 配置数据库连接信息 type="POOLED" mybatis使用连接池方式来获取连接 -->
            <dataSource type="POOLED">
                <property name="driver" value="${mysql.jdbc.driverClass}" />
                <property name="url" value="${mysql.jdbc.url}" />
                <property name="username" value="${mysql.jdbc.username}" />
                <property name="password" value="${mysql.jdbc.password}" />
            </dataSource>
        </environment>
    </environments>

使用美元符号 $前缀 并连接 由{}包围的外部文件属性键值，就可以将外部文件的属性引入到配置文件中
例如

${mysql.jdbc.driverClass}

也可以通过声明property 的 name属性以及value属性来使用内部声明的上下文属性.

<?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">
	<properties resource="resource/common/jdbc.properties">
		<!--xml内部声明属性 -->
		<property name="username" value="root"/>
		<property name="password" value="password"/>
	</properties>

	<!--环境集标签-->
    <environments default="development" >
        <!--环境标签 连接环境信息，取一个任意唯一的名字-->
        <environment id="development">
            <!--mybatis使用JDBC的事务管理-->
            <transactionManager type="JDBC"/>
            <!-- 配置数据库连接信息 type="POOLED" mybatis使用连接池方式来获取连接 -->
            <dataSource type="POOLED">
                <property name="driver" value="${mysql.jdbc.driverClass}" />
                <property name="url" value="${mysql.jdbc.url}" />

				<!--使用内部声明的属性 -->
                <property name="username" value="${username}" />
                <property name="password" value="${password}" />
            </dataSource>
        </environment>
    </environments>

也可以使用java代码，在代码中将参数传递到配置中，
获取SqlSessionFactory实例的时候，我们调用new SqlSessionFactoryBuilder().build()方法，如下

可以看到有多个含属性对象的调用，其中用到的java.util.properties类，

该类继承于Hashtable，以键值对的方式存储属性。具体形式这里不做讨论。

需要注意的是mybatis的属性加载方式

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

settings 设置标签

转载自 https://blog.csdn.net/fageweiketang/article/details/80767532



配置一个完整的 settings 元素，参考代码如下：

<settings>
    <setting name="cacheEnabled" value="true"/>
    <setting name="lazyLoadingEnabled" value="true"/>
    <setting name="multipleResultSetsEnabled" value="true"/>
    <setting name="useColumnLabel" value="true"/>
    <setting name="useGeneratedKeys" value="false"/>
    <setting name="autoMappingBehavior" value="PARTIAL"/>
    <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
    <setting name="defaultExecutorType" value="SIMPLE"/>
    <setting name="defaultStatementTimeout" value="30"/>
    <setting name="defaultFetchSize" value="200"/>
    <setting name="safeRowBoundsEnabled" value="false"/>
    <setting name="mapUnderscoreToCamelCase" value="false"/>
    <setting name="localCacheScope" value="SESSION"/>
    <setting name="jdbcTypeForNull" value="OTHER"/>
    <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

typeAliases 类型别名标签

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如：

<typeAliases>
  <package name="Model"/>
</typeAliases>

/**
 * @author Kern
 * @Title: UsersBO
 * @ProjectName MyBatis_Study
 * @Description: TODO
 * @date 2019-4-1011:10
 */
@Alias("userBO")
public class UsersBO {

指定报名配合@Alias标签，则可以在xml中使用别名注解中指定的别名
例如：

	<select id="getUser" parameterType="long" resultType="userBO">
        SELECT * from users where id = #{id}
    </select>

如果未使用注解，则别名为Model.UsersBO去除包名 == UsersBO

environments 环境配置标签

mybatis支持在environments中配置多个environment标签，也就是配置多个数据源。实际上开发工作还是经常遇到这种情况的，
不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
关键点：

1. 默认使用的环境 ID（比如：default=“development”）。
2. 每个 environment 元素定义的环境 ID（比如：id=“development”）。
3. 事务管理器的配置（比如：type=“JDBC”）。
4. 数据源的配置（比如：type=“POOLED”）。

事务管理器（transactionManager）

1. JDBC – 这个配置就是直接使用了 JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
2. MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。例如:

<transactionManager type="MANAGED">
  <property name="closeConnection" value="false"/>
</transactionManager>

数据源（dataSource）

type 属性:

1. UNPOOLED 无连接池：这个数据源的实现只是每次被请求时打开和关闭连接。
2. POOLED 连接池：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。
3. JNDI： 这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

mappers 映射器标签

<mappers>
	<!-- 使用相对于类路径的资源引用 -->
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
	<!-- 使用完全限定资源定位符（URL） -->
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
	<!-- 使用映射器接口实现类的完全限定类名 -->
  <mapper class="org.mybatis.builder.AuthorMapper"/>
	<!-- 将包内的映射器接口实现全部注册为映射器 -->
  <package name="org.mybatis.builder"/>
</mappers>