在MyBatis中的XML分为两类，一类是基础配置文件，通常只有一个，主要是配置一些基本的上下文参数和运行环境；另一类是映射文件，它可以配置映射关系、SQL、参数等信息。

一、基础配置文件

MyBatis配置文件元素清单

<?xml version="1.0" encoding="UTF-8"?>
<configuration><!-- 配置 --><properties/><!-- 属性 --><settings/><!-- 设置 --><typeAliases/><!-- 类型命名 --><typeHandlers/><!--类型处理器--><objectFactory/><!--对象工厂--><plugins/><!--插件--><environments><!--配置环境--><environment><!--环境变量--><transactionManager/><!--事务管理器--><dataSource/><!--数据源--></environment></environments><databaseIdProvider/><!--数据库厂商标识--><mappers/><!--映射器-->
</configuration>

MyBatis配置项的顺序不能颠倒，如果颠倒了他们的顺序，那么在MyBatis的启动阶段就会发生异常，导致程序无法运行。

1、properties 属性

MyBatis提供了三种方式供我们使用properties:
（1）property子元素

<properties><property name="database.driver" value="com.mysql.jdbc.Driver"/><property name="database.url" value="jdbc:mysql://localhost:3306/ssm"/><property name="database.username" value="root"/><property name="database.password" value="123456"/>
</properties>
<!-- 数据库环境 -->
<environments default="development"><environment id="development"><transactionManager type="JDBC" /><dataSource type="POOLED"><property name="driver" value="${database.driver}" /><property name="url" value="${database.url}" /><property name="username" value="${database.username}" /><property name="password" value="${database.password}" /></dataSource></environment>
</environments>

（2）使用properties文件（推荐）
properties文件：jdbc.properties

database.driver=com.mysql.jdbc.Driver
database.url=jdbc:mysql://localhost:3306/ssm
database.username=root
database.password=123456

然后将配置文件中的<properties>修改为

<properties resource="jdbc.properties"/>

（3）使用程序传递方式传递参数
假设用户名和密码已经加密，并且系统提供了CodeUtils.decode(str)进行解密

String resource = "mybatis-config.xml";
InputStream inputStream;
//读取jdbc.properties文件
InputStream in = Resources.getResourceAsStream("jdbc.properties");
Properties props = new Properties();
props.load(in);
String username = props.getProperty("database.username");
String password = props.getProperty("database.password");
// 解密用户和密码，并在属性中重置
props.put("database.username", CodeUtils.decode(username));
props.put("database.password", CodeUtils.decode(password));
inputStream = Resources.getResourceAsStream(resource);
// 使用程序传递的方式覆盖原有的properties属性参数
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream, props);

2、setting 设置

全样setting配置样例

<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="25"/><setting name="defaultFetchSize" value="100"/><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>

setting配置项说明

配置项	说明	配置选项	默认值
cacheEnabled	全局地开启或关闭配置文件中的所有映射器已经配置的任何缓存。	true，false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态。	true，false	false
aggressiveLazyLoading	当开启时，任何方法调用都会加载该对象的所有属性。否则，每个属性会按需加载（参考lazyLoadTriggerMethods）	true，false	版本3.4.1（不包含）之前true，之后false
multipleResultSetsEnabled	是否允许单一语句返回多结果集（需要兼容驱动）	true，false	true
useColumnLabel	使用列标签代替列名。不同的驱动在这方面会有不同的表现，具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。	true，false	true
useGeneratedKeys	允许JDBC支持自动生成主键，需要驱动兼容。如果设置为true则这个设置强制使用自动生成主键，尽管一些驱动不能兼容但仍可正常工作（比如Derby）	true，false	false
autoMappingBehavior	指定MyBatis应如何自动映射列到字段或属性。NONE表示取消自动映射；PARTIAL只会自动映射没有定义嵌套结果集映射的结果集。FULL会自动映射任意复杂的结果集（无论是否嵌套）	NONE,PARTIAL,FULL	PARTIAL
autoMappingUnknownColumnBehavior	指定发现自动映射目标未知列（或者未知属性类型）的行为。NONE：不做任何反应 WARNING：输出提醒日志 (‘org.apache.ibatis.session.AutoMappingUnknownColumnBehavior’的日志等级必须设置为WARN) FAILING：映射失败（抛出SqlSessionException）	NONE,WARNING,FAILING	NONE
defaultExecutorType	配置默认的执行器。SIMPLE就是普通的执行器；REUSE执行器会重用预处理语句（prepared statements）；BATCH执行器将重用语句并执行批量更新。	SIMPLE,REUSE,BATCH	SIMPLE
defaultStatementTimeout	设置超时时间，它决定驱动等待数据库响应的秒数	任意正整数	Not Set(null)
defaultFetchSize	为驱动的结果集获取数量（fetchSize）设置一个提示值。此参数只可以在查询设置中被覆盖。	任意正整数	Not Set(null)
safeRowBoundsEnabled	允许在嵌套语句中使用分页（RowBounds）。如果允许使用则设置为false。	true ，false	False
safeResultHandlerEnabled	允许在嵌套语句中使用分页（ResultHandler）。如果允许使用则设置为false。	true ，false	True
mapUnderscoreToCamelCase	是否开启自动驼峰命名规则（camel case）映射，既从经典数据库列名A_COLUMN到经典java属性名aColumn的类似映射。	true ， false	False
localCacheScope	MyBatis利用本地缓存机制（Local Cache）防止循环引用（circular references）和加速重复嵌套查询。默认值为SESSION，这种情况下会缓存一个会话中执行的所有查询。若设置值为STATEMENT，本地会话仅用在语句执行上，对相同SqlSession的不同调用将不会共享数据。	SESSION ， STATEMENT	SESSION
jdbcTypeForNull	当没有为参数提供特定的JDBC类型时，为空值指定JDBC类型。某些驱动需要指定列的JDBC类型，多数情况直接用一般类型即可，比如NULL，VARCHAR或OTHER。	jdbc Type 常量，大多都为：NULL，VARCHAR and OTHER	OTHER
lazyLoadTriggerMethods	指定哪个对象的方法触发一次延迟加载。	用逗号分隔的方法列表	equals,clone,hashCode,toString
defaultScriptingLanguage	指定动态SQL生成的默认语言。	一个类型别名或完全限定类名	org.apache.ibatis.scripting.xmltags.XMLLanguageDriver
defaultEnumTypeHandler	指定Enum使用的默认TypeHandler.（从3.4.5开始）	一个类型别名或完全限定类名	org.apache.ibatis.type.EnumTypeHandler
callSettersOnNulls	指定当结果集中值为null的时候是否调用映射对象的setter（map对象时为put）方法，这对于有Map.keySet()依赖或null值初始化的时候是有用的。注意基本类型（int，boolean等）是不能设置成null的。	true ， false	false
returnInstanceForEmptyRow	当返回行的所有列都是空时，MyBatis默认返回null。当开启这个设置时，MyBatis会返回一个空实例。请注意，它也适用于嵌套的结果集（i.e.collection and association）。（从3.4.2开始）	true ，false	false
logPrefix	指定MyBatis增加到日志名称的前缀。	任何字符串	Not set
logImpl	指定MyBatis所用日志的具体实现，未指定时将自动查找。	SLF4J ， LOG4J ， LOG4J2 ，JDK_LOGGING ，COMMONS_LOGGING ， STDOUT_LOGGING ， N0_LOGGING	Not set
proxyFactory	指定MyBatis创建具有延迟加载能力的对象所用到的代理工具。	CGLIB ， JAVASSIST	JAVASSIST(MyBatis 3.3 or above)
vfsImpl	指定VFS的实现	自定义VFS的实现的类全限定名，以逗号分隔	Not set
useActualParamName	允许使用方法签名中的名称作为语句参数名称。为了使用该特性，工程必须采用java 8编译，并加上-parameters选项（从3.4.1开始）	true ，false	true
configurationFactory	指定一个提供Configuration实例的类。这个被返回的Configuration实例用来加载被反序列化对象的懒加载属性值。这个类必须包含一个签名方法static Configuration getConfiguration()。（从3.2.3版本开始）	类型别名或者全类名	Not set

3、typeAliases 别名

由于类的全限定名很长，总写那么长的名称不方便，MyBatis中允许定义一个简写来代表这个类，这就是别名。
在MyBatis中，别名不区分大小写。
自定义别名有两种方法：
（1）配置文件定义

<typeAliases><!--别名--><typeAlias alias="role" type="com.learn.ssm.chapter4.pojo.Role"/><typeAlias alias="user" type="com.learn.ssm.chapter4.pojo.User"/>
</typeAliases>

（2）扫描别名

<typeAliases><!--别名--><typeAlias name="com.learn.ssm.chapter4.pojo"/>
</typeAliases>

MyBatis将扫描这个包里面的类，将其第一个字母变为小写作为其别名

有时会出现重名，可以使用注解进行区分：

@Alias("user3")
public Class User{
......
}

4、typeHandler 类型转换器

在typeHandler中，分为jdbcType和javaType，其中jdbcType用于定义数据库类型，而javaType用于定义java类型，那么typeHandler的作用就是承担jdbcType和javaType之间的相互转换。

自定义typeHandler
要实现typeHandler就需要实现接口typeHandler，或者继承BaseTypeHandler
步骤1：实现typeHandler

public class MyTypeHandler implements TypeHandler<String> {Logger logger = Logger.getLogger(MyTypeHandler.class);@Override//使用typeHandler通过PreparedStatement对象进行设置SQL参数的时候使用的具体方法//四个参数：ps -- ，i -- 参数在SQL的下标，parameter -- 参数，jdbcType -- 数据库类型	public void setParameter(PreparedStatement ps, int i, String parameter, JdbcType jdbcType) throws SQLException {logger.info("设置string参数【" + parameter+"】");ps.setString(i, parameter);}@Override//使用列名（columnName）从jdbc结果集中获取数据进行转换	public String getResult(ResultSet rs, String columnName)throws SQLException {String result = rs.getString(columnName);logger.info("读取string参数1【" + result+"】");return result;}@Override//使用下标（columnIndex）从jdbc结果集中获取数据进行转换	public String getResult(ResultSet rs, int columnIndex) throws SQLException {String result = rs.getString(columnIndex);logger.info("读取string参数2【" + result+"】");return result;}@Override//从jdbc结果集中获取数据进行转换（存储过程专用）public String getResult(CallableStatement cs, int columnIndex) throws SQLException {String result = cs.getString(columnIndex);logger.info("读取string参数3【" + result+"】");return result;}
}

步骤2：配置

<typeHandlers><typeHandler jdbcType="VARCHAR" javaType="string" handler="com.learn.ssm.chapter4.typehandler.MyTypeHandler"/>
</typeHandlers>

步骤3：两种使用方法（在映射器中）

方法1：指定与自定义typeHandler一致的jdbcType和javaType

<resultMap id="roleMapper" type="role"><result property="id" column="id" /><result property="roleName" column="role_name" jdbcType="VARCHAR" javaType="string" />
</resultMap><select id="findRoles" parameterType="string" resultMap="roleMapper">select id, role_name, note from t_role where role_name like concat('%', #{roleName, jdbcType=VARCHAR, javaType=string}, '%')
</select>

方法2：直接使用typeHandler指定具体的实现类

<resultMap id="roleMapper" type="role"><result property="id" column="id" /><result property="note" column="note" typeHandler="com.learn.ssm.chapter4.typehandler.MyTypeHandler" />
</resultMap><select id="findRoles2" parameterType="string" resultMap="roleMapper">
select id, role_name, note from t_role where note like concat('%', #{note, typeHandler=com.learn.ssm.chapter4.typehandler.MyTypeHandler}, '%')
</select>

5、ObjectFactory 对象工厂

6、plugins 插件

7、environments 配置环境

8、databaseIdProvider 数据库厂商标识

使用系统默认的databaseIdProvider
步骤1：配置databaseIdProvider属性

<databaseIdProvider type="DB_VENDOR"><property name="Oracle" value="oracle"/><property name="MySQL" value="mysql"/><property name="DB2" value="db2"/>
</databaseIdProvider>

步骤2：标识SQL适用何种数据库

<select id="getRole" parameterType="long" resultType="role" databaseId="oracle">select id,role_name as roleName, note from t_role where id = #{id}
</select>
<select id="getRole" parameterType="long" resultType="role" databaseId="mysql">select id,role_name as roleName, note from t_role where i=i and id = #{id}
</select>

当databaseIdProvider属性被配置时，系统会优先取到和数据库配置一致的SQL，如果没有，则取没有databaseId的SQL，可以把它当做默认值。

9、mappers 映射器

映射器由一个接口加上XML文件（或者注解）组成。

映射器的配置元素

元素名称	描述	备注
select	查询语句
insert	插入语句	执行后返回一个整数，代表插入的条数
update	更新语句	执行后返回一个整数，代表更新的条数
delete	删除语句	执行后返回一个整数，代表删除的条数
sql	允许定义一部分sql，然后在各个地方引用它
resultMap	用来描述从数据库结果集中来加载对象	提供映射规则
cache	给定命名空间的缓存配置
cache-ref	其它命名空间缓存配置的引用

(1）映射器的构造
——select元素（查询语句）

——insert元素（插入语句）
——update元素（更新语句）
——delete元素（删除语句）
——sql元素
——resultMap元素
resultMap元素定义的主要是一个结果集的映射关系，也就是SQL到Java Bean的映射关系定义。

resultMap元素的子元素清单

<resultMap><constructor><idArg/><arg/></constructor><id/><result/><association/><collection/><discriminator><case/></discriminator>
</resultMap>

一个POJO可能不存在没有参数的构造方法，需要使用constructor进行配置

(2）引入映射器的方法
步骤1：构造映射器

——定义Mapper接口

public interface RoleMapper{public Role getRole(Long id);
}

——定义Mapper映射规则和SQL语句

<mapper namespace="com.learn.ssm.chapter4.mapper.RoleMapper"><select id="getRole" parameterType="long" resultType="com.learn.ssm.chapter4.pojo.Role">select id, role_name as roleName, note from t_role where id = #{id}</select>
</mapper>

步骤2：引入映射器
——方法1：用文件路径引入映射器

<mappers><mapper resource="com/learn/ssm/chapter4/mapper/roleMapper.xml"/>
</mappers>

——方法2：用包名引入映射器

<mappers><package name="com.learn.ssm.chapter4.mapper"/>
</mappers>

——方法3：用类注册引入映射器

<mappers><mapper class="com.learn.ssm.chapter4.mapper.UserMapper"/><mapper class="com.learn.ssm.chapter4.mapper.RoleMapper"/>
</mappers>

————————————————————————————————————————
啊实在有点多，剩下的有时间再写吧