MyBatis的SqlMapConfig.xml配置文件详解

本文记录Java学习过程中遇到的MyBatis的SqlMapConfig.xml配置文件详解~

常用配置

SqlMapConfig.xml中配置的内容和顺序如下:

properties(属性)
settings(全局配置参数)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境集合属性对象)
	environment(环境子属性对象)
		transactionManager(事务管理)
		dataSource(数据源)
mappers(映射器)

properties(属性)

SqlMapConfig.xml可以引用Java属性文件中的配置信息。

db.properties配置文件内容如下:

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8
jdbc.username=root
jdbc.password=123456

SqlMapConfig.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>
	<!-- 是用resource属性加载外部配置文件 -->
	<properties resource="db.properties">
		<!-- 在properties内部用property定义属性 -->
		<!-- 如果外部配置文件有该属性,则内部定义属性被外部属性覆盖 -->
		<property name="jdbc.username" value="root" />
		<property name="jdbc.password" value="123456" />
	</properties>

	<!-- 和spring整合后 environments配置将废除 -->
	<environments default="development">
		<environment id="development">
			<!-- 使用jdbc事务管理 -->
			<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>

	<!-- 加载映射文件 -->
	<mappers>
		<mapper resource="sqlmap/User.xml" />
		<mapper resource="mapper/UserMapper.xml" />
	</mappers>
</configuration>

MyBatis 将按照下面的顺序来加载属性:

  • 在properties元素体内定义的属性首先被读取;
  • 然后会读取properties元素中resource或url加载的属性,它会覆盖已读取的同名属性。 

typeAliases(类型别名)

mybatis支持别名:

  • _byte:byte;
  • _long:long;
  • _short:short;
  • _int:int;
  • _integer:int;
  • _double:double;
  • _float:float;
  • _boolean:boolean;
  • string:String;
  • byte:Byte;
  • long:Long;
  • short:Short;
  • int:Integer;
  • integer:Integer;
  • double:Double;
  • float:Float;
  • boolean:Boolean;
  • date:Date;
  • decimal:BigDecimal;
  • bigdecimal:BigDecimal;
  • map:Map。

自定义别名:

<typeAliases>
	<!-- 单个别名定义 -->
	<typeAlias alias="user" type="ren.oliver.mybatis.pojo.User" />
	<!-- 批量别名定义,扫描整个包下的类,别名为类名(大小写不敏感) -->
	<package name="ren.oliver.mybatis.pojo" />
	<package name="其它包" />
</typeAliases>

在mapper.xml配置文件中,就可以使用设置的别名了,别名大小写不敏感。

mappers(映射器)

Mapper配置的几种方法:

  • <mapper resource=" " />:使用相对于类路径的资源。
<mapper resource="sqlmap/User.xml" />
  • <mapper class=" " />:使用mapper接口类路径。
<mapper class="ren.oliver.mybatis.mapper.UserMapper"/>

注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。

  • <package name=""/>:注册指定包下的所有mapper接口。
<package name="ren.oliver.mybatis.mapper"/>

注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。

标签: none