一、配置解析
1、核心配置文件
- mybatis-config.xml
- MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
- configuration(配置)
- properties(属性)
- settings(设置)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境配置)
- environment(环境变量)
- transactionManager(事务管理器)
- dataSource(数据源)
- databaseIdProvider(数据库厂商标识)
- mappers(映射器)
2、环境配置(environments)
MyBatis 可以配置成适应多种环境
尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。
学会使用配置多套运行环境
Mybatis默认的事务管理器是JDBC,连接池:POOLED
注意一些关键点:
- 默认使用的环境 ID(比如:default="development")。
- 每个 environment 元素定义的环境 ID(比如:id="development")。
- 事务管理器的配置(比如:type="JDBC")。
- 数据源的配置(比如:type="POOLED")。
环境可以随意命名,但务必保证默认的环境 ID 要匹配其中一个环境 ID。
3、属性(properties)
我们可以通过properties属性来实现引用配置文件
这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,也可以在 properties 元素的子元素中来传递。【db.properties】
编写一个配置文件
db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
在核心配置文件中引入
<!-- 引入外部配置文件 -->
<properties resource="db.properties"/>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<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>
- 可以直接引入外部文件
- 可以在其中增加一些属性配置
- 如果两个文件有同一个字段,优先使用外部配置文件
4、类型别名(typeAliases)
- 类型别名是为 Java 类型设置一个缩写名字
- 存在的意义仅在于用来减少类完全限定名的冗余
<!--可以给实体类别名-->
<typeAliases>
<typeAlias type="com.oykq.pojo.User" alias="User"/>
</typeAliases>
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
扫描实体类的包,它的默认别名就为这个类的 类名,首字母小写(大写也可以)
<!-- 可以给实体类起别名 -->
<typeAliases>
<package name="com.oykq.pojo"/>
</typeAliases>
在实体类比较少的情况,使用第一种方式
如果实体类十分多,建议使用第二种
第一种可以DIY别名,第二种则不行,如果非要改,需要在实体类上增加注解
@Alias("hello")
public class User {
}
5、设置(settings)
6、其他配置
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
7、映射器(mappers)
MapperRegistry:注册绑定我们的Mapper文件;
方式一:【推荐使用】
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
<mapper resource="com/oykq/dao/UserMapper.xml"/>
</mappers>
方式二:使用class文件进行绑定
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
注意点:
- 接口和其对应的Mapper配置文件必须同名
- 接口和其对应的Mapper配置文件必须在同一个包下
方式三:使用扫描包进行注入绑定
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
注意点:
- 接口和其对应的Mapper配置文件必须同名
- 接口和其对应的Mapper配置文件必须在同一个包下
8、生命周期和作用域
生命周期和作用域是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder
- 一旦创建了 SqlSessionFactory,就不再需要它了。
- 局部变量
SqlSessionFactory
- 可以想象为:数据库连接池
- SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- SqlSessionFactory 的最佳作用域是应用作用域。
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession
- 可以想象为:连接到连接池的一个请求
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 使用完需要关闭请求,否则资源会被占用
这里的每一个Mpaaer,代表一个具体的业务
二、解决属性名和字段名不一致的问题
1、问题
数据库中的字段
新建一个项目,拷贝之前的,测试实体类字段不一致的情况
public class User {
private int id;
private String name;
private String pwd;
}
sql语句中进行类型处理
select * from mybatis.user where id = #{id};
类型处理器
select id,name,pwd from mybatis.user where id = #{id};
解决方案:
- 起别名:
select id,name,pwd as password from mybatis.user where id = #{id};
2、resultMap
结果集映射
<!-- 结果集映射 -->
<resultMap id="UserMap" type="com.fj.pojo.User">
<!-- column:数据库中的字段;property:实体类中的属性 -->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
<select id="getUserByID" parameterType="int" resultMap="UserMap">
select * from mybatis.user where id = #{id};
</select>
- resultMap 元素是 MyBatis 中最重要最强大的元素。
- ResultMap 的设计思想是,对简单的语句根本不需要配置显式的结果映射,对于复杂一点的语句,只需要描述语句之间的关系就行了。
- 这就是 ResultMap 的优秀之处——你完全可以不用显式地配置它们。
高级结果集映射参考官方目录XML 映射器_MyBatis中文网