Code Ease Code Ease
  • 个人博客网站 (opens new window)
  • 好用的工具网站 (opens new window)
  • Java核心基础
  • 框架的艺术
  • 分布式与微服务
  • 开发经验大全
  • 设计模式
  • 版本新特性
数据库系列
大数据+AI
  • xxl-job
运维与Linux
  • 基于SpringBoot和BootStrap的论坛网址
  • 基于VuePress的个人博客网站
  • 基于SpringBoot开发的小功能
  • 做一个自己的IDEA插件
程序人生
关于我
  • 分类
  • 标签
  • 归档

神秘的鱼仔

你会累是因为你在走上坡路
  • 个人博客网站 (opens new window)
  • 好用的工具网站 (opens new window)
  • Java核心基础
  • 框架的艺术
  • 分布式与微服务
  • 开发经验大全
  • 设计模式
  • 版本新特性
数据库系列
大数据+AI
  • xxl-job
运维与Linux
  • 基于SpringBoot和BootStrap的论坛网址
  • 基于VuePress的个人博客网站
  • 基于SpringBoot开发的小功能
  • 做一个自己的IDEA插件
程序人生
关于我
  • 分类
  • 标签
  • 归档
服务器
  • Java核心基础

  • 框架的艺术

    • Spring

    • Mybatis

      • Mybatis的原理介绍及超详细使用
      • Mybatis增删改查,这一篇足以
      • Mybatis配置详细解析
        • (一)概述
        • (二)属性(properties)
        • (三)设置(settings)
        • (四)类型别名(typeAliases)
        • (五)映射器(mappers)
        • (六)总结
      • MyBatis实现复杂环境的Sql查询
      • Mybatis日志原来是这样使用的
      • Mybatis动态Sql详解
      • Mybatis缓存详解
      • 想在一个项目中实现多数据源切换?几行代码就搞定了
      • 用了MybatisPlus后,我很久没有手写sql了
      • 用了MyBatis的项目 如何优雅地打印SQL
    • SpringBoot

    • MQ

    • Zookeeper

    • netty

  • 分布式与微服务

  • 开发经验大全

  • 版本新特性

  • Java
  • 框架的艺术
  • Mybatis
CodeEase
2023-09-20
目录

Mybatis配置详细解析

作者:鱼仔
博客首页: codeease.top (opens new window)
公众号:Java鱼仔

# (一)概述

Mybatis的核心配置文件是mybatis-config.xml。我还是先把Mybatis官方中文网站的地址拿出来:

mybatis官方中文网站:https://mybatis.org/mybatis-3/zh/configuration.html

上面的地址对应于Mybatis的配置属性,MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

3-1.png

其中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&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
1
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
1
2
3
4

接着在mybatis-config.xml中添加properties节点,注意这个节点的位置必须放在首位

<properties resource="db.properties">
</properties>
1
2

接着就可以用properties中的属性去代替xml中的属性

<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
1
2
3
4

# (三)设置(settings)

MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为,官网中列出了所有设置项,这里就介绍几个常用的:

设置cacheEnabled可以全局的开启或关闭配置文件的缓存。

3-2.png

设置是否开启驼峰命名规则

3-3.png

是否开启懒加载

3-4.png

指定所使用的日志

3-5.png

设置的配置方式如下:

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="logImpl" value="LOG4J"/>
</settings>
1
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>
1
2
3

这里的resultType写的是类的全限定名,我们可以在mybatis-config.xml中使用类型别名来简化。

<typeAliases>
    <typeAlias type="com.javayz.pojo.User" alias="user"/>
</typeAliases>
1
2
3

这样设置之后就可以在resultType中直接使用user。

第二种方式是指定一个包名,Mybatis会在指定的包名路径下搜索需要的JavaBean。 修改上面的代码,使用包名来指定

<typeAliases>
    <package name="com.javayz.pojo"/>
</typeAliases>
1
2
3

官方文档里有这样一句话,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名,意思就是如果我们使用@Alias制定了别名,就可以使用指定的别名,如果没有指定,就是用当前实体类名的小写作为别名。

例如下面这种写法不管加不加注解,别名都是user

@Alias("user")
public class User {
    ...
}
1
2
3
4

下面是java类型内建的别名

3-6.png

3-7.png

# (五)映射器(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>
1
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>
1
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>
1
2
3
4
5
6
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>
1
2
3
4

# (六)总结

以上对Mybatis的常用几个属性进行了介绍,日常使用时掌握上面的这几个属性已经完全足够了,还是建议大家动手敲代码,以官方文档为总的学习方向,再结合博客内容学习。

上次更新: 2025/04/29, 17:22:06
Mybatis增删改查,这一篇足以
MyBatis实现复杂环境的Sql查询

← Mybatis增删改查,这一篇足以 MyBatis实现复杂环境的Sql查询→

最近更新
01
AI大模型部署指南
02-18
02
半个月了,DeepSeek为什么还是服务不可用
02-13
03
Python3.9及3.10安装文档
01-23
更多文章>
Theme by Vdoing | Copyright © 2023-2025 备案图标 浙公网安备33021202002405 | 浙ICP备2023040452号
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式