Mybatis配置详细解析
作者:鱼仔
博客首页: https://codeease.top
公众号:Java鱼仔
# (一)概述
Mybatis的核心配置文件是mybatis-config.xml。我还是先把Mybatis官方中文网站的地址拿出来:
mybatis官方中文网站:https://mybatis.org/mybatis-3/zh/configuration.html
上面的地址对应于Mybatis的配置属性,MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
其中environments和mappers我们已经在前面介绍了,这里对比较重要的几个配置项做介绍。
# (二)属性(properties)
在最开始写mybatis-config.xml的时候,我们写了下面一段代码:
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
2
3
4
这里将各种属性写死在了xml配置文件里,如果想修改就会很麻烦,这时就可以用到properties属性。在resources目录下新建一个db.properties:
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
2
3
4
接着在mybatis-config.xml中添加properties节点,注意这个节点的位置必须放在首位
<properties resource="db.properties">
</properties>
2
接着就可以用properties中的属性去代替xml中的属性
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
2
3
4
# (三)设置(settings)
MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为,官网中列出了所有设置项,这里就介绍几个常用的:
设置cacheEnabled可以全局的开启或关闭配置文件的缓存。
设置是否开启驼峰命名规则
是否开启懒加载
指定所使用的日志
设置的配置方式如下:
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="logImpl" value="LOG4J"/>
</settings>
2
3
4
5
6
# (四)类型别名(typeAliases)
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写。
类型别名有两种方式,第一种是对类取别名,第二种是指定一个包名。比如拿出之前写的sql
<select id="getUserById" resultType="com.javayz.pojo.User" parameterType="int">
select * from user where id=#{id};
</select>
2
3
这里的resultType写的是类的全限定名,我们可以在mybatis-config.xml中使用类型别名来简化。
<typeAliases>
<typeAlias type="com.javayz.pojo.User" alias="user"/>
</typeAliases>
2
3
这样设置之后就可以在resultType中直接使用user。
第二种方式是指定一个包名,Mybatis会在指定的包名路径下搜索需要的JavaBean。 修改上面的代码,使用包名来指定
<typeAliases>
<package name="com.javayz.pojo"/>
</typeAliases>
2
3
官方文档里有这样一句话,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名,意思就是如果我们使用@Alias制定了别名,就可以使用指定的别名,如果没有指定,就是用当前实体类名的小写作为别名。
例如下面这种写法不管加不加注解,别名都是user
@Alias("user")
public class User {
...
}
2
3
4
下面是java类型内建的别名
# (五)映射器(mappers)
在前面我们已经讲了mapper的使用,每编写一个mapper.xml,都需要在mybatis-config.xml中增加一个mapper标签。
mappers有四种引入方式:
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
2
3
4
5
6
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
<mapper url="file:///var/mappers/BlogMapper.xml"/>
<mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
2
3
4
5
6
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
2
3
4
5
6
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
2
3
4
# (六)总结
以上对Mybatis的常用几个属性进行了介绍,日常使用时掌握上面的这几个属性已经完全足够了,还是建议大家动手敲代码,以官方文档为总的学习方向,再结合博客内容学习。