核心配置文件
- Mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="12345"/>
</dataSource>
</environment>
</environments>
<!-- 每一个mapper.xml都需要在这注册-->
<mappers>
<mapper resource="com/wang/dao/UserMapper.xml"/>
</mappers>
</configuration>
- MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
环境配置(environments)
MyBatis 可以配置成适应多种环境
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
- environments 元素定义了如何配置环境
<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>
注意一些关键点:
默认使用的环境 ID(比如:default=“development”)。
每个 environment 元素定义的环境 ID(比如:id=“development”)。
事务管理器的配置(比如:type=“JDBC”)。
数据源的配置(比如:type=“POOLED”)。
默认环境和环境 ID 顾名思义。 环境可以随意命名,但务必保证默认的环境 ID 要匹配其中一个环境 ID。
default="development"就是指默认启用development这套环境
Mybatis默认的事务管理器是JDBC ,连接池是POOLED
属性(properties)
我们可以使用properties属性来引用外部配置文件
- 在资源配置文件(resources)中新建db.properties文件
- 编写db.properties文件
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&;useUnicode=true&;characterEncoding=UTF-8&;serverTimezone=UTC
username=root
password=123456
- 在核心配置文件(Mybatis-config.xml)中引入db.properties文件
注意:
当properties标签放到最下面时,核心配置文件会报错
而报错原因就是我们标签的顺序必须遵从Mybatis-config.xml文件中规定的顺序
也就是说properties标签必须在最上方
引入之后我们就可以将dataSource标签下的value值做些修改
如果在db.properties文件里属性没有编写完全,还可以在Mybatis-config.xml文件中的properties标签做些添加
如果两个文件有同一个字段,优先使用外部配置文件
类型别名(typeAliases)
类型别名可为 Java 类型设置一个缩写名字。
它仅用于 XML 配置,意在降低冗余的全限定类名书写。
在我们的项目中,User是实体类
我们的UserMapper.xml文件中,resultType返回值类型是com.wang.pojo.User
当我们在Mybatis-config.xml文件中使用typeAliases标签给User实体类设置别名,我们的UserMapper.xml文件中,resultType返回值类型就可以使用别名
typeAliases也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean(类)
每一个在包 中的 Java Bean(类),在没有注解的情况下,会使用 Bean(类) 的首字母小写的非限定类名来作为它的别名
它会扫描到我们pojo包下的User类,会生成默认别名(首字母小写:user)
在实体类较少的情况下可以使用typeAliases标签起别名
当实体类较多的情况下,我们只需要利用typeAliases标签扫描包下的类,会自动生成默认的别名
我们还可以使用注解给实体类起别名,如下
设置(settings)
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为
可以到Mybatis官方文档中查看
列举几个settings较为重要的属性
映射器(mappers)
注册绑定我们的Mapper文件
- 方式一(推荐使用)
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
- 方式二
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
<mapper url="file:///var/mappers/BlogMapper.xml"/>
<mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
- 方式三
注意点- 接口和他的配置文件必须同名
- 接口和他的配置文件必须在同一个包下
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
- 方式四
注意点- 接口和他的配置文件必须同名
- 接口和他的配置文件必须在同一个包下
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>