Mybatis从入门到精通——配置文件和映射文件说明（4）

骑猪看日落 2023-07-12 09:27 10阅读 0赞

# 一、mybatis-config配置说明 #

mybatis-config的configuration标签下的常用子标签说明

<table> 
 <tbody> 
  <tr> 
   <td style="text-align:center;width:67px;">序号</td> 
   <td style="text-align:center;width:192px;">标签名</td> 
   <td style="text-align:center;width:198px;">说明</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">1</td> 
   <td style="text-align:center;width:192px;"> <pre>properties</pre> </td> 
   <td style="text-align:center;width:198px;">引入外部配置文件，可以通过${}表达式引用</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">2</td> 
   <td style="text-align:center;width:192px;">settings</td> 
   <td style="text-align:center;width:198px;">设置Mybatis的全局配置属性，它能改变Mybatis运行时行为</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">3</td> 
   <td style="text-align:center;width:192px;"> <pre>typeAliases</pre> </td> 
   <td style="text-align:center;width:198px;">别名定义，为java类定义简单的名字，在mapper.xml中使用</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">4</td> 
   <td style="text-align:center;width:192px;"> <pre>typeHandlers</pre> </td> 
   <td style="text-align:center;width:198px;">类型转换处理器，定义jdbc类型和java类型转换的处理，一般不需要配置。</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">5</td> 
   <td style="text-align:center;width:192px;"> <pre>objectFactory</pre> </td> 
   <td style="text-align:center;width:198px;">对象工厂，用于创建mapper接口方法中返回值是接口的实例对象。</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">6</td> 
   <td style="text-align:center;width:192px;"> <pre>plugins</pre> </td> 
   <td style="text-align:center;width:198px;">插件，对Mybatis内部运行的方法进行拦截增强的类，一般只配置一个分页插件。</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">7</td> 
   <td style="text-align:center;width:192px;"> <pre>environments</pre> </td> 
   <td style="text-align:center;width:198px;">环境配置，主要是配置数据源和事务</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;width:67px;">8</td> 
   <td style="text-align:center;width:192px;"> <pre>mappers</pre> </td> 
   <td style="text-align:center;width:198px;">mapper.xml文件的配置</td> 
  </tr> 
 </tbody> 
</table>

# 二、settings标签说明 #

Mybatis配置文件中configuration标签下的settings标签内容过于繁多，单独拿出来说明。

该标签主要是设置configuration中的属性配置，常见的属性配置如下表：

<table> 
 <tbody> 
  <tr> 
   <td style="text-align:center;">序号</td> 
   <td style="text-align:center;">属性名</td> 
   <td style="text-align:center;">说明</td> 
   <td style="text-align:center;">默认值</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">1</td> 
   <td style="text-align:center;"> <pre>cacheEnabled</pre> </td> 
   <td style="text-align:center;">全局二级缓存是否开启，还需要在mapper.xml文件中单独添加缓存标签才有效</td> 
   <td style="text-align:center;">true</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">2</td> 
   <td style="text-align:center;"> <pre>lazyLoadingEnabled</pre> </td> 
   <td style="text-align:center;">全局延迟加载是否开启，需要和aggressiveLazyLoading属性配合使用，需要使用延迟加载则设置为true</td> 
   <td style="text-align:center;">false</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">3</td> 
   <td style="text-align:center;"> <pre>lazyLoadTriggerMethods</pre> </td> 
   <td style="text-align:center;">延迟加载对象在调用哪些方法时触发加载</td> 
   <td style="text-align:center;"> <pre>equals,clone,hashCode,toString</pre> </td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">4</td> 
   <td style="text-align:center;"> <pre>aggressiveLazyLoading</pre> </td> 
   <td style="text-align:center;">延迟加载的对象是否立马加载，需要使用延迟加载设置为false</td> 
   <td style="text-align:center;">true</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">5</td> 
   <td style="text-align:center;"> <pre>useColumnLabel</pre> </td> 
   <td style="text-align:center;">使用列标签替代列名</td> 
   <td style="text-align:center;">true</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">6</td> 
   <td style="text-align:center;"> <pre>mapUnderscoreToCamelCase</pre> </td> 
   <td style="text-align:center;">是否开启驼峰命名规则</td> 
   <td style="text-align:center;">false</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">7</td> 
   <td style="text-align:center;"> <pre>autoMappingUnknownColumnBehavior</pre> </td> 
   <td style="text-align:center;">当检测出未知列或未知属性时如何处理，可选NONE：不做任何处理，FAILING：映射失败抛出异常，WARNING：警告</td> 
   <td style="text-align:center;">WARNING</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">8</td> 
   <td style="text-align:center;"> <pre>defaultExecutorType</pre> </td> 
   <td style="text-align:center;">默认的执行器，可选SIMPLE：简单执行器，REUSE：可复用Statement执行器，BATCH：批量处理执行器</td> 
   <td style="text-align:center;">SIMPLE</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">9</td> 
   <td style="text-align:center;"> <pre>defaultStatementTimeout</pre> </td> 
   <td style="text-align:center;">设置超时时间，单位秒</td> 
   <td style="text-align:center;">null</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">10</td> 
   <td style="text-align:center;"> <pre>logImpl</pre> </td> 
   <td style="text-align:center;">指定日志实现类，SLF4J、LOG4J、COMMONS_LOGGING、LOG4J2等</td> 
   <td style="text-align:center;">null，不过会自动查找</td> 
  </tr> 
  <tr> 
   <td style="text-align:center;">11</td> 
   <td style="text-align:center;"> <pre>logPrefix</pre> </td> 
   <td style="text-align:center;">Mybatis日志打印前缀，可以是任意字符串</td> 
   <td style="text-align:center;">null</td> 
  </tr> 
 </tbody> 
</table>

# 三、mapper映射文件配置说明 #

<table> 
 <tbody> 
  <tr> 
   <td>序号</td> 
   <td>标签名</td> 
   <td>说明</td> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td> <pre>cache</pre> </td> 
   <td> <pre>该命名空间开启二级缓存并设置缓存属性</pre> </td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td> <pre>cache-ref</pre> </td> 
   <td> <pre>对其它命名空间的缓存配置引用</pre> </td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td> <pre>resultMap</pre> </td> 
   <td> <pre>对象关系映射</pre> </td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td> <pre>sql</pre> </td> 
   <td> <pre>可被其它语句复用的sql语句块</pre> </td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td> <pre>insert</pre> </td> 
   <td> <pre>映射插入sql</pre> </td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td> <pre>update</pre> </td> 
   <td> <pre>映射更新sql</pre> </td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td> <pre>delete</pre> </td> 
   <td> <pre>映射删除sql</pre> </td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td> <pre>select</pre> </td> 
   <td> <pre>映射查询sql</pre> </td> 
  </tr> 
 </tbody> 
</table>