mybatis-Config.xml全局配置文件解析

蔚落 2022-09-26 03:06 229阅读 0赞

## 一：mybatis-Config.xml配置文件的内容和配置顺序如下 ##

1.  properties(属性)
2.  settings(全局配置参数)
3.  typeAiases(类型别名)
4.  typeHandlers(类型处理器)
5.  objectFactory(对象工厂)
6.  plugins(插件)
7.  environments(环境集合属性对象)mappers(映射器)
    
    1.  environment(环境子属性对象)
    2.  transactionManager(事物管理)
    3.  datesource(数据源
8.  mappers(映射器)

## 二：properties属性 ##

作用：将数据连接单独配置在db.properties中，只需要在mybatis-Config.xml中加载db.properties的属性值，在mybatis-Config.xml中就不需要对数据库连接参数进行硬编码。数据库连接参数只配置在db.properties中，方便对参数进行统一管理，其它xml可以引用该db.properties。

**db.properties的内容：**

jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mybatis jdbc.username=root jdbc.password=root

**在mybatis-Config.xml中加载db.properties**

<properties resource="db.properties">
 
 
 </properties>
 
 <environments default="development">
 <environment id="development">
 
 <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>

**properties特性：**

**注意：**

*  在properties元素体内定义的属性优先读取。
 *  然后读取properties元素中resource或url加载的属性，它会覆盖已读取的同名属性。
 *  最后读取parameterType传递的属性，它会覆盖已读取的同名属性

**建议：**

不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。

在properties文件中定义属性名要有一定的特殊性，如xxxx.xxxx(jdbc.driver)

## 三:settings全局参数配置 ##

mybatis框架运行时可以调整一些运行参数。比如，开启二级缓存，开启延迟加载等等。全局参数会影响mybatis的运行行为。

**mybatis-settings的配置属性以及描述**

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

官方文档settings的例子

![ContractedBlock.gif][]

## 四:typeAiases(别名)--重点掌握 ##

在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。

如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

**4.1.mybatis默认支持的别名**

<table style="width:265px; height:783px"> 
 <tbody> 
 <tr> 
 <td> 别名 </td> 
 <td> 映射的类型 </td> 
 </tr> 
 <tr> 
 <td> _byte&nbsp; </td> 
 <td> byte&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _long&nbsp; </td> 
 <td> long&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _short&nbsp; </td> 
 <td> short&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _int&nbsp; </td> 
 <td> int&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _integer&nbsp; </td> 
 <td> int&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _double&nbsp; </td> 
 <td> double&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _float&nbsp; </td> 
 <td> float&nbsp; </td> 
 </tr> 
 <tr> 
 <td> _boolean&nbsp; </td> 
 <td> boolean&nbsp; </td> 
 </tr> 
 <tr> 
 <td> string&nbsp; </td> 
 <td> String&nbsp; </td> 
 </tr> 
 <tr> 
 <td> byte&nbsp; </td> 
 <td> Byte&nbsp; </td> 
 </tr> 
 <tr> 
 <td> long&nbsp; </td> 
 <td> Long&nbsp; </td> 
 </tr> 
 <tr> 
 <td> short&nbsp; </td> 
 <td> Short&nbsp; </td> 
 </tr> 
 <tr> 
 <td> int&nbsp; </td> 
 <td> Integer&nbsp; </td> 
 </tr> 
 <tr> 
 <td> integer&nbsp; </td> 
 <td> Integer&nbsp; </td> 
 </tr> 
 <tr> 
 <td> double&nbsp; </td> 
 <td> Double&nbsp; </td> 
 </tr> 
 <tr> 
 <td> float&nbsp; </td> 
 <td> Float&nbsp; </td> 
 </tr> 
 <tr> 
 <td> boolean&nbsp; </td> 
 <td> Boolean&nbsp; </td> 
 </tr> 
 <tr> 
 <td> date&nbsp; </td> 
 <td> Date&nbsp; </td> 
 </tr> 
 <tr> 
 <td> decimal&nbsp; </td> 
 <td> BigDecimal&nbsp; </td> 
 </tr> 
 <tr> 
 <td> bigdecimal&nbsp; </td> 
 <td> BigDecimal&nbsp; </td> 
 </tr> 
 </tbody> 
</table>

**4.2.自定义别名**

**　　4.2.1:单个别名定义(在mybatis-Config.xml)****　　**

<typeAliases><typeAlias type="com.mybatis.entity.User" alias="user"/></typeAliases>

**　　　　UserMapper.xml引用别名:**

<select id="findUserById" parameterType="int" resultType="user" >
 　　select * from t_user where id=#{id}
 </select>

**　4.2.2:批量定义别名(常用)****　**

<typeAliases>
 <package name="com.mybatis.entity"/>
 <package name="其它包"/>
 </typeAliases>

## 五：typeHandlers(类型处理器) ##

mybatis中通过typeHandlers完成jdbc类型和java类型的转换。

通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.

**mybatis支持类型处理器：**

<table style="width:587px; height:971px"> 
 <tbody> 
 <tr> 
 <td> 类型处理器 </td> 
 <td> Java类型 </td> 
 <td> JDBC类型 </td> 
 </tr> 
 <tr> 
 <td> BooleanTypeHandler&nbsp; </td> 
 <td> Boolean，boolean&nbsp; </td> 
 <td> 任何兼容的布尔值 </td> 
 </tr> 
 <tr> 
 <td> ByteTypeHandler&nbsp; </td> 
 <td> Byte，byte&nbsp; </td> 
 <td> 任何兼容的数字或字节类型 </td> 
 </tr> 
 <tr> 
 <td> ShortTypeHandler&nbsp; </td> 
 <td> Short，short&nbsp; </td> 
 <td> 任何兼容的数字或短整型 </td> 
 </tr> 
 <tr> 
 <td> IntegerTypeHandler&nbsp; </td> 
 <td> Integer，int&nbsp; </td> 
 <td> 任何兼容的数字和整型 </td> 
 </tr> 
 <tr> 
 <td> LongTypeHandler&nbsp; </td> 
 <td> Long，long&nbsp; </td> 
 <td> 任何兼容的数字或长整型 </td> 
 </tr> 
 <tr> 
 <td> FloatTypeHandler&nbsp; </td> 
 <td> Float，float&nbsp; </td> 
 <td> 任何兼容的数字或单精度浮点型 </td> 
 </tr> 
 <tr> 
 <td> DoubleTypeHandler&nbsp; </td> 
 <td> Double，double&nbsp; </td> 
 <td> 任何兼容的数字或双精度浮点型 </td> 
 </tr> 
 <tr> 
 <td> BigDecimalTypeHandler&nbsp; </td> 
 <td> BigDecimal&nbsp; </td> 
 <td> 任何兼容的数字或十进制小数类型 </td> 
 </tr> 
 <tr> 
 <td> StringTypeHandler&nbsp; </td> 
 <td> String&nbsp; </td> 
 <td> CHAR和VARCHAR类型 </td> 
 </tr> 
 <tr> 
 <td> ClobTypeHandler&nbsp; </td> 
 <td> String&nbsp; </td> 
 <td> CLOB和LONGVARCHAR类型 </td> 
 </tr> 
 <tr> 
 <td> NStringTypeHandler&nbsp; </td> 
 <td> String&nbsp; </td> 
 <td> NVARCHAR和NCHAR类型 </td> 
 </tr> 
 <tr> 
 <td> NClobTypeHandler&nbsp; </td> 
 <td> String&nbsp; </td> 
 <td> NCLOB类型 </td> 
 </tr> 
 <tr> 
 <td> ByteArrayTypeHandler&nbsp; </td> 
 <td> byte[]&nbsp; </td> 
 <td> 任何兼容的字节流类型 </td> 
 </tr> 
 <tr> 
 <td> BlobTypeHandler&nbsp; </td> 
 <td> byte[]&nbsp; </td> 
 <td> BLOB和LONGVARBINARY类型 </td> 
 </tr> 
 <tr> 
 <td> DateTypeHandler&nbsp; </td> 
 <td> Date（java.util） </td> 
 <td> TIMESTAMP类型 </td> 
 </tr> 
 <tr> 
 <td> DateOnlyTypeHandler&nbsp; </td> 
 <td> Date（java.util） </td> 
 <td> DATE类型 </td> 
 </tr> 
 <tr> 
 <td> TimeOnlyTypeHandler&nbsp; </td> 
 <td> Date（java.util） </td> 
 <td> TIME类型 </td> 
 </tr> 
 <tr> 
 <td> SqlTimestampTypeHandler&nbsp; </td> 
 <td> Timestamp（java.sql） </td> 
 <td> TIMESTAMP类型 </td> 
 </tr> 
 <tr> 
 <td> SqlDateTypeHandler&nbsp; </td> 
 <td> Date（java.sql） </td> 
 <td> DATE类型 </td> 
 </tr> 
 <tr> 
 <td> SqlTimeTypeHandler&nbsp; </td> 
 <td> Time（java.sql） </td> 
 <td> TIME类型 </td> 
 </tr> 
 <tr> 
 <td> ObjectTypeHandler&nbsp; </td> 
 <td> 任意 </td> 
 <td> 其他或未指定类型 </td> 
 </tr> 
 <tr> 
 <td> EnumTypeHandler&nbsp; </td> 
 <td> Enumeration类型 </td> 
 <td> VARCHAR-任何兼容的字符串类型，作为代码存储（而不是索引）。 </td> 
 </tr> 
 </tbody> 
</table>

## **六：mappers(映射配置)** ##

**6.1:通过resource加载单个映射文件**

<mappers>
 
 <mapper resource="sqlmap/User.xml"/>
 <mapper resource="mapper/UserMapper.xml"/>
 </mappers>

**6.2:通过mapper接口加载单个映射文件**

<mapper class="com.mybatis.mapper.UserMapper"/>

按照上边的规范，将mapper.java和mapper.xml放在一个目录 ，且同名。

![291142267287085.png][]

**6.3:批量加载mapper(推荐使用)**

<package name="com.mybatis.mapper"/>

[ContractedBlock.gif]: /images/20220717/e66fa4ecb1f94bcfb497b9bc2e1f1d1e.png
[291142267287085.png]: /images/20220717/e45865042cb244328c18240c9c80a45b.png