Mybatis的配置解析

Mybatis的配置解析

一、核心配置文件

  • mybatis-config.xml
  • Mybatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息。
1
2
3
4
5
6
7
8
9
10
11
12
13
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)

二、环境配置(environments)

Mybatis可以配置成适应多套运行环境

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!-- default:选择默认的环境 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>

不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。

学会使用配置多套运行环境!

Mybatis默认的事务管理器就是JDBC,连接池:POOLED

三、属性(properties)

1. 注意:配置文件中的标签一定要按顺序排布

properties -> settings -> typeAliases -> typeHandlers…

这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置【db.properties】

2. 可以通过properties属性来实现引用外部配置文件

1
2
3
4
5
<!-- db.properties -->
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&;useUnicode=true&;characterEncoding=UTF-8
username=root
password=nc20011019

3. 可以直接在核心配置文件中直接设置

1
2
3
4
<properties resource="db.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
</properties>

4. 当同时配置以上两种方式时,优先使用外部配置文件!!!

四、类型别名(typeAliases)

类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写

1. 类型别名可为实体类设置一个缩写名字。 它仅用于XML配置,意在降低冗余的全限定类名书写。

1
2
3
4
<!--可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.nichu.pojo.User" alias="User"/>
</typeAliases>

2. 也可以指定一个包名,MyBatis 会在包名下面搜索需要的实体类

扫描实体类的包,它的默认别名就为这个类的类名,首字母小写!

1
2
3
4
<typeAliases>
<!-- 读取包下所有实体类 -->
<package name="com.nihcu.pojo"/>
</typeAliases>

在实体类比较少的时候使用第一种如果实体类十分多,建议使用第二种

五、其他配置

  • typeHandlers(类型处理器)
  • objectFactory(对象工厂)
  • plugins(插件)
    • mybatis-generator-core
    • mybatis-plus
    • 通用mapper

六、映射器(mappers)

MapperRegistry:注册绑定我们的Mapper文件;方式一:

1
2
3
4
5
6
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

方式二:使用class文件绑定注册

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
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>

方法二和方法三的注意点:

  • 接口和他的Mapper配置文件必须同名!
  • 接口和他的Mapper配置文件必须在同一个包下!

七、生命周期和作用域

生命周期,和作用域,是至关重要的,因为错误的使用会导致非常严重的并发问题。 SqISessionFactoryBuilder:

  • 一旦创建了SqlSessionFactory, 就不再需要它了
  • 局部变量

SqISessionFactory:

  • 说白了就是可以想象为:数据库连接池
  • SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
  • 因此SqlSessionFactory的最佳作用域是应用作用域。
  • 最简单的就是使用单例模式或者静态单例模式。

SqISession

  • 连接到连接池的一个请求!
  • SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
  • 用完之后需要赶紧关闭,否则资源被占用!

八、解决属性名和字段名不一致的问题

1. 问题

数据库中的字段(pwd)

若实体类中的字段和数据库中的不一致(password)

数据库查不出来

原因:类处理器识别不出来

1
2
3
select * from mybatis.user where id = #{id};
//类处理器
select id,name,pwd from mybatis.user where id = #{id};

解决方法:

  • 起别名,修改sql
    1
    2
    3
    <select id="getUserListById" parameterType="int" resultType="com.nichu.pojo.User">
    select id,name,pwd as password from mybatis.user where id = #{id};
    </select>

2. 解决方法 resultMap

结果集映射

1
2
id name pwd
id name password

在接口配置文件中添加结果集映射

1
2
3
4
5
6
7
8
9
10
11
<!--结果集映射-->
<resultMap id="UserMap" type="User">
<!--column数据库中的字段,property实体类中的属性-->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>

<select id="getUserListById" resultMap="UserMap">
select * from mybatis.user where id = #{id};
</select>

column对应数据库中的字段,property对应实体类的属性。

-------------本文结束感谢您的阅读-------------