mybatis-config.xml-配置文件详解
前言
随着对MyBatis 配置文件理解的加深,越来越体会到这个文件的作用了。也终于区分开config.xml和XXmapper.xml的区别了
- config.xml是用来配置mybatis,他是总配置,配置Mapper只是他的功能之一。在配置Mapper方面,目前我用到的<mapper>是用来设置mapper.xml的路径的,<typeAliases>是用来简写XXType的
- XXmapper是用来实现XXMapper接口的,用来写sql语句的。
终于开始系统的学习xml的配置属性了,不再觉得每个<属性标签>都很陌生了。本文仅列出一些常用的属性。
参考文档:xml配置文档
一、属性<properties>
myBatis.xml配置文件
- 这儿的配置属性,指的是在resource文件夹下面的myBatis.xml中的<properties>
- property 的value,可以从外部文件读取。
- 使用value="${username}"这样的形式,读取properties中的username的值
<property name="user" value="laohan">
properties文件
- 配置在resource文件夹下面
- 文件后缀为.properties,不能是property
- username=hsp的形式连接。等号前后不加“引号”;也不要加空格,避免引用带了空格,导致出错;也不要用“;”分号结尾
- 为了能使用properties,需要在mybatis.xml文件中添加properties的位置。保存在默认resources路径下。
<properties resource="jdbc.properties"/>
- 更改为从外部引用后,出现的第一个错误就是,添加的中文信息出现乱码了。
- 猜测是“&”换了位置后不能正常解析,统一改为&后,能正常录入中文了。
pom.xml文件
- 配置在工程目录下面
- 代码运行后,文件都是从target目录下读取的,为了生成target目录下的properties,需要在pom.xml中配置:
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
</resource>
</resources>
</build>
二、设置<settings>
- logImpl,配置MyBatis自带的日志输出-查看原生的sql
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
三、类型别名<typeAliases>
- 类型别名可设置为 Java 类型设置一个SimpleName。
<typeAlias type=“com.stein.entity.Monster” alias=“Monster”/>
- 也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean。
- 这样在同一个包下,如果有多个别名需要配置,就会简化很多
<package name=“domain.blog”/>
四、类型处理器<typeHandlers>
- MyBatis 在设置预处理语句(PreparedStatement)中的参数或从结果集中取出一个值时, 都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。
- 年-月-日 时:分:秒 ,在java端可以设置Date格式,在DB端可以设置成TimeStamp(推荐)或者datetime。
五、环境配置<environments>
- 配置jdbc
六、映射器<mappers>
既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要来定义 SQL 映射语句了。 但首先,我们需要告诉 MyBatis 到哪里去找到这些语句。MyBatis通过以下4种方式查找实现了接口的XXMapper.xml文件。如果没有写,或者写错了路径、文件名,都会报错Type interface *** is not known to the MapperRegistry。
- 使用映射器接口实现类的完全限定类名。可以用来配置用@注解实现的映射器。
<mapper class=“com.stein.mapper.MonsterAnnotation”/>。
- 使用相对于类路径的资源引用
<mapper resource=“com/stein/mapper/monsterMapper.xml”/>
- 将包内的映射器接口全部注册为映射器。直接写包名,在包内搜索。
<package name=“com.stein.mapper”/>
- 使用完全限定资源定位符(URL)(不常用)
注意事项
貌似对config.xml的配置顺序有要求,需要按照文档的顺序排列,否则会报红,而且运行会出错。