当前位置：首页 > news >正文

Mybatis的核心配置文件

news 2025/7/19 21:50:44

MyBatis的全局配置文件mybatis-config.xml，配置内容如下：

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

properties(属性)标签

作用：加载propertis配置文件

配置了此标签后，在mybatis-config.xml中就不需要对数据库连接参数硬编码了。

应用：①将连接数据库的信息配置到一个单独的属性文件db.properties中(假设在类的根路径下创建db.properties文件)，配置如下：

db.propertiesjdbc.mysql.driver=com.mysql.jdbc.Driver
jdbc.mysql.url=jdbc:mysql://localhost:3306/ssm?characterEncoding=utf8&useSSL=false
jdbc.mysql.username=root
jdbc.mysql.password=root将来用${}通过key把对应的值从这个文件中取出来

②再在mybatis的核心配置文件中用properties标签加载属性文件，再用${key}通过key把属性文件中对应的值取出来用即可：

properties标签的两个属性，在mapper标签中也有：
- resource：从类的根路径下开始加载资源。【常用的。】
- url：从指定的url加载资源，假设文件放在d:/jdbc.properties，这个url可以写成：file:///d:/jdbc.properties。注意是三个斜杠哦。

mybatis-config4.xml<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!--加载属性文件--><properties resource="jdbc.properties"/><environments default="dev"><environment id="dev"><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="CarMapper.xml"/></mappers>
</configuration>

注意：如果不知道mybatis-config.xml文件中标签的编写顺序的话，可以有两种方式知道它的顺序：

第一种方式：查看dtd约束文件。
第二种方式：通过idea的报错提示信息。【一般采用这种方式】

settings全局配置参数

MyBatis框架在运行时可以调整一些运行参数，比如：开启二级缓存、开启延迟加载。

可配置参数如下：

常用的就是开启下划线与驼峰命名的转换：

概念：使数据库列名自动映射成 java类的属性名
使用这种方式的前提是：属性名遵循Java的命名规范，数据库表列名要遵循SQL的命名规范。
- Java命名规范：首字母小写，后面每个单词首字母大写，遵循驼峰命名方式。
- SQL命名规范：全部小写，单词之间采用下划线分割。

比如以下的对应关系：

实体类中的属性名	数据库表的列名
carNum	car_num
carType	car_type
produceTime	produce_time

如何开启这个功能？

<settings><setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

typeAliases(类型别名)标签

在mapper.xml映射文件中，会定义很多的statement。statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。如果在指定类型时输入类型的全限定类名，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

MyBatis默认支持别名

自定义别名

使用 typeAliases标签来给类起别名，包括两种方式：

第一种方式：嵌套typeAlias标签

：为单个类型起别名

<typeAliases><typeAlias type="com.powernode.mybatis.pojo.Car" alias="Car"/>
</typeAliases>

typeAliases标签可以嵌套多个typeAlias标签
typeAlias标签的属性：
- type属性：要起别名的类的全限定类名
- alias属性：别名。
  - alias属性可以缺省，起的别名就是该类的类名，如上述的就是Car（不区分大小写）

第二种方式：嵌套package标签

：批量给类型起别名

<typeAliases><package name="com.powernode.mybatis.pojo"/>
</typeAliases>

package单标签的name属性：指定给哪个包下的所有类自动起别名，自动起的别名就是：该类的类名，首字母大小均可。
package也可以配置多个的。

总结

所有的别名都不区分大小写
namespace不能使用别名机制

typeHandlers类型处理器

MyBatis中通过typeHandlers完成JDBC类型和Java类型的转换，MyBatis自带的类型处理器基本上满足日常需求，不需要单独定义。

作用：将数据库中列的类型自动转化为 java中的类型

MyBatis支持类型处理器：

mappers映射器标签

作用：在MyBatis核心配置文件中加载SQL映射文件。

SQL映射文件的配置方式包括四种：

resource：从类路径下加载
url：从指定的全限定资源路径中加载
class：使用映射器接口实现类的完全限定类名
package：将包内的映射器接口实现全部注册为映射器

mapper标签的resource属性

这种方式从类路径下开始加载资源，要求配置文件必须放在resources目录下或其子目录下。

<mappers><mapper resource="org/mybatis/builder/AuthorMapper.xml"/><mapper resource="org/mybatis/builder/BlogMapper.xml"/><mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

mapper标签的url属性

这种方式使用配置文件的绝对路径来加载资源，对SQL映射文件的存放位置没有要求。

<mappers><mapper url="file:///var/mappers/AuthorMapper.xml"/><mapper url="file:///var/mappers/BlogMapper.xml"/><mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>

mapper标签的class属性

<!-- class属性：配置mapper接口的全限定名，通过Java中的Mapper接口来加载映射文件 -->
<mappers><mapper class="org.mybatis.builder.AuthorMapper"/><mapper class="org.mybatis.builder.BlogMapper"/><mapper class="org.mybatis.builder.PostMapper"/>
</mappers>

使用这种方式必须满足以下前提：

SQL映射文件和mapper接口需存放在同一个目录下。因为mybatis会自动去Mapper接口所在的目录下去找SQL映射文件
SQL映射文件的名字和mapper接口名一致。
必须使用mapper代理的开发方式。

注意：同一个目录是指编译之后的目录，并非开发时的目录。

将CarMapper.xml文件移动到和mapper接口同一个目录下：

在resources目录下新建一个和mapper接口包名一样的多级目录：com/powernode/mybatis/mapper【这里千万要注意：不能这样新建 com.powernode.mybatis.dao】
将CarMapper.xml文件移动到mapper目录下

mappers标签嵌套package标签

如果class较多，使用 package标签的方式批量加载SQL映射文件

此种配置使mapper扫描指定包，并在此包下获取所有的接口以及与接口名称相同mapper文件，
并加载；

<mappers>
<!-- name属性：存放Mapper接口与mapper.xml文件的包名 --><package name="com.powernode.mybatis.mapper"/>
</mappers>

要求：与mapper接口加载单个映射文件(class方式)一致。

Mybatis配置文件的标签顺序

Mybatis配置文件中各标签的位置顺序如下：

properties?,
settings?,
typeAliases?,
typeHandlers?,
objectFactory?,
objectWrapperFactory?,
reflectorFactory?,
plugins?,
environments?,
databaseIdProvider?,
mappers?
具体可以参考 http://mybatis.org/dtd/mybatis-3-config.dtd 文件。