mybatis学习之全局配置文件（五）

1.Mybatis全局配置文件

---

SqlMapConfig.xml是mybatis的全局配置文件，它的名称可以是任意命名的。

1.全部配置内容

SqlMapConfig.xml的配置内容和顺序如下（顺序不能乱）：

Properties（属性）
Settings（全局参数设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境信息集合）
    environment（单个环境信息）
        transactionManager（事物）
        dataSource（数据源）
mappers（映射器）

2.常用配置详解

---

1.Properties

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

db.properties配置信息如下：

db.driver=com.mysql.jdbc.Driver
db.url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8
db.username=root
db.password=root

SqlMapConfig.xml使用properties标签后，如下所示：

<!-- 通过properties标签，读取java配置文件的内容 -->
<!-- properties加载顺序比property标签声明更晚故和下面不冲突 -->
<properties resource="db.properties" >
<property name="username" value="111"/>
</properties>


<!-- 配置mybatis的环境信息 -->
<environments default="development">
    <environment id="development">
        <!-- 配置JDBC事务控制，由mybatis进行管理 -->
        <transactionManager type="JDBC"></transactionManager>
        <!-- 配置数据源，采用dbcp连接池 -->
        <dataSource type="POOLED">
            <property name="driver" value="${db.driver}"/>
            <property name="url" value="${db.url}"/>
            <property name="username" value="${db.username}"/>
            <property name="password" value="${db.password}"/>
        </dataSource>
    </environment>
</environments>

使用${}，可以引用已经加载的java配置文件中的信息。

注意：mybatis将按照下面的顺序加载属性： Properties标签体内定义的属性首先被读取
Properties引用的属性会被读取，如果发现上面已经有同名的属性了，那后面会覆盖前面的值
parameterType接收的值会最后被读取，如果发现上面已经有同名的属性了，那后面会覆盖前面的值

所以说，mybatis读取属性的顺序由高到低分别是：parameterType接收的属性值、properties引用的属性、properties标签内定义的属性。

2.Settings

---

mybatis全局配置参数，全局参数将会影响mybatis的运行行为。

Setting(设置)	Description（描述）	Valid Values(验证值组)	Default(默认值)
cacheEnabled	在全局范围内启用或禁用缓存配置任何映射器在此配置下。	true | false	TRUE
lazyLoadingEnabled	在全局范围内启用或禁用延迟加载。禁用时，所有协会将热加载。	true | false	TRUE
aggressiveLazyLoading	启用时，有延迟加载属性的对象将被完全加载后调用懒惰的任何属性。否则，每一个属性是按需加载。	true | false	TRUE
multipleResultSetsEnabled	允许或不允许从一个单独的语句（需要兼容的驱动程序）要返回多个结果集。	true | false	TRUE
useColumnLabel	使用列标签，而不是列名。在这方面，不同的驱动有不同的行为。参考驱动文档或测试两种方法来决定你的驱动程序的行为如何。	true | false	TRUE
useGeneratedKeys	允许JDBC支持生成的密钥。兼容的驱动程序是必需的。此设置强制生成的键被使用，如果设置为true，一些驱动会不兼容性，但仍然可以工作。	true | false	FALSE
autoMappingBehavior	指定MyBatis的应如何自动映射列到字段/属性。NONE自动映射。 PARTIAL只会自动映射结果没有嵌套结果映射定义里面。 FULL会自动映射的结果映射任何复杂的（包含嵌套或其他）。	NONE, PARTIAL, FULL	PARTIAL
defaultExecutorType	配置默认执行人。SIMPLE执行人确实没有什么特别的。 REUSE执行器重用准备好的语句。 BATCH执行器重用语句和批处理更新。	SIMPLE REUSE BATCH	SIMPLE
defaultStatementTimeout	设置驱动程序等待一个数据库响应的秒数。	Any positive integer	Not Set (null)
safeRowBoundsEnabled	允许使用嵌套的语句RowBounds。	true | false	FALSE
mapUnderscoreToCamelCase	从经典的数据库列名A_COLUMN启用自动映射到骆驼标识的经典的Java属性名aColumn。	true | false	FALSE
localCacheScope	MyBatis的使用本地缓存，以防止循环引用，并加快反复嵌套查询。默认情况下（SESSION）会话期间执行的所有查询缓存。如果localCacheScope=STATMENT本地会话将被用于语句的执行，只是没有将数据共享之间的两个不同的调用相同的SqlSession。	SESSION | STATEMENT	SESSION
dbcTypeForNull	指定为空值时，没有特定的JDBC类型的参数的JDBC类型。有些驱动需要指定列的JDBC类型，但其他像NULL，VARCHAR或OTHER的工作与通用值。	JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER	OTHER
lazyLoadTriggerMethods	指定触发延迟加载的对象的方法。	A method name list separated by commas
defaultScriptingLanguage	指定所使用的语言默认为动态SQL生成。	A type alias or fully qualified class name.	org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver
callSettersOnNulls	指定如果setter方法​​或地图的put方法时，将调用检索到的值是null。它是有用的，当你依靠Map.keySet（）或null初始化。注意原语（如整型，布尔等）不会被设置为null。	true | false	FALSE
logPrefix	指定的前缀字串，MyBatis将会增加记录器的名称。	Any String	Not set
logImpl	指定MyBatis的日志实现使用。如果此设置是不存在的记录的实施将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING	COMMONS_LOGGING | STDOUT_LOGGING
proxyFactory	指定代理工具，MyBatis将会使用创建懒加载能力的对象。	CGLIB | JAVASSIST

3.typeAliases

---

别名是使用是为了在映射文件中，更方便的去指定入参和结果集的类型，不再用写很长的一段全限定名。

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

2.自定义别名

SqlMapConfig.xml配置信息如下：

  < !-- 定义别名 -->
    < typeAliases>
        < !-- 单个定义别名 -->
        < typeAlias type="cn.itcast.mybatis.po.User" alias="user"/>

    <!-- 批量定义别名（推荐） -->
    <!-- [name]：指定批量定义别名的类包，别名为类名（首字母大小写都可） -->
    <package name="cn.itcast.mybatis.po"/>
</typeAliases>

配置别名后可以在文档中使用别名代替

案例：
首先：你最好把你的实体类里面的变量名称和你的表里面字段写成一致。
然后：在SqlMapConfig.xml中
< typeAliases >
< typeAlias alias=”game” type=”实体类路径”/>
< /typeAliases>
这就是把你的实体类写了个别名
最后：在你写查询添加的时候：
< select id=”gameDao” resultType=”game”>返回你的实体类对象
select * from tb_game
< /select>
这样查出的结果就对应上你的数据了。

4.mappers

---

1. < mapper resource=’’/>

使用相对于类路径的资源
如：< mapper resource=”sqlmap/User.xml” />

2. < mapper url=’’/>

使用完全限定路径
如：

3. < mapper class=”“/>

使用mapper接口的全限定名
如：

注意：此种方法要求mapper接口和mapper映射文件要名称相同，且放到同一个目录下；

4. < package name=’’/>（推荐）

注册指定包下的所有映射文件
如：< package name=”cn.itcast.mybatis.mapper”/>

    <!-- 加载映射文件 -->
      <mappers>   
        <package name="com.mybatis1.mapper"/>
      </mappers> 

注意：此种方法要求mapper接口和mapper映射文件要名称相同，且放到同一个目录下；