MyBatis的全局配置文件mybatis-config.xml,配置内容如下:
- properties(属性)
- settings(全局配置参数)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境集合属性对象)
- environment(环境子属性对象)
- transactionManager(事务管理)
- dataSource(数据源)
- environment(环境子属性对象)
- mappers(映射器)
properties(属性)标签
作用:加载propertis配置文件
配置了此标签后,在mybatis-config.xml中就不需要对数据库连接参数硬编码了。
应用:①将连接数据库的信息配置到一个单独的属性文件db.properties中(假设在类的根路径下创建db.properties文件),配置如下:
db.propertiesjdbc.mysql.driver=com.mysql.jdbc.Driver
jdbc.mysql.url=jdbc:mysql://localhost:3306/ssm?characterEncoding=utf8&useSSL=false
jdbc.mysql.username=root
jdbc.mysql.password=root将来用${}通过key把对应的值从这个文件中取出来
②再在mybatis的核心配置文件中 用properties标签 加载属性文件 ,再用${key}通过key把属性文件中对应的值取出来用即可:
- properties标签的两个属性,在mapper标签中也有:
- resource:从类的根路径下开始加载资源。【常用的。】
- url:从指定的url加载资源,假设文件放在d:/jdbc.properties,这个url可以写成:file:///d:/jdbc.properties。注意是三个斜杠哦。
mybatis-config4.xml<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><!--加载属性文件--><properties resource="jdbc.properties"/><environments default="dev"><environment id="dev"><transactionManager type="JDBC"/><dataSource type="POOLED"><property name="driver" value="${jdbc.driver}"/><property name="url" value="${jdbc.url}"/><property name="username" value="${jdbc.username}"/><property name="password" value="${jdbc.password}"/></dataSource></environment></environments><mappers><mapper resource="CarMapper.xml"/></mappers>
</configuration>
注意:如果不知道mybatis-config.xml文件中标签的编写顺序的话,可以有两种方式知道它的顺序:
-
第一种方式:查看dtd约束文件。
-
第二种方式:通过idea的报错提示信息。【一般采用这种方式】
settings全局配置参数
MyBatis框架在运行时可以调整一些运行参数,比如:开启二级缓存、开启延迟加载。
可配置参数如下:
常用的就是开启下划线与驼峰命名的转换:
-
概念:使数据库列名 自动映射成 java类的属性名
-
使用这种方式的前提是:属性名遵循Java的命名规范,数据库表列名要遵循SQL的命名规范。
-
Java命名规范:首字母小写,后面每个单词首字母大写,遵循驼峰命名方式。
-
SQL命名规范:全部小写,单词之间采用下划线分割。
-
-
比如以下的对应关系:
实体类中的属性名 | 数据库表的列名 |
---|---|
carNum | car_num |
carType | car_type |
produceTime | produce_time |
-
如何开启这个功能?
<settings><setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
typeAliases(类型别名)标签
在mapper.xml映射文件中,会定义很多的statement。statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。如果在指定类型时输入类型的全限定类名,不方便进行开发,可以针对parameterType或resultType指定的类型定义一些别名,在mapper.xml中通过别名定义,方便开发。
MyBatis默认支持别名
自定义别名
使用 typeAliases标签 来给类起别名,包括两种方式:
第一种方式:嵌套typeAlias标签
:为单个类型起别名
<typeAliases><typeAlias type="com.powernode.mybatis.pojo.Car" alias="Car"/>
</typeAliases>
-
typeAliases标签可以嵌套多个typeAlias标签
-
typeAlias标签的属性:
-
type属性:要起别名的类的全限定类名
-
alias属性:别名。
-
alias属性可以缺省,起的别名就是该类的类名,如上述的就是Car(不区分大小写)
-
-
第二种方式:嵌套package标签
:批量给类型起别名
<typeAliases><package name="com.powernode.mybatis.pojo"/>
</typeAliases>
- package单标签的name属性:指定给哪个包下的所有类自动起别名,自动起的别名就是:该类的类名,首字母大小均可。
- package也可以配置多个的。
总结
-
所有的别名都不区分大小写
-
namespace不能使用别名机制
typeHandlers类型处理器
MyBatis中通过typeHandlers完成JDBC类型和Java类型的转换,MyBatis自带的类型处理器基本上满足日常需求,不需要单独定义。
作用:将数据库中列的类型 自动转化为 java中的类型
MyBatis支持类型处理器:
mappers映射器标签
作用:在MyBatis核心配置文件中加载SQL映射文件。
SQL映射文件的配置方式包括四种:
-
resource:从类路径下加载
-
url:从指定的全限定资源路径中加载
-
class:使用映射器接口实现类的完全限定类名
-
package:将包内的映射器接口实现全部注册为映射器
mapper标签的resource属性
这种方式从类路径下开始加载资源,要求配置文件必须放在resources目录下或其子目录下。
<mappers><mapper resource="org/mybatis/builder/AuthorMapper.xml"/><mapper resource="org/mybatis/builder/BlogMapper.xml"/><mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
mapper标签的url属性
这种方式使用配置文件的绝对路径来加载资源,对SQL映射文件的存放位置没有要求。
<mappers><mapper url="file:///var/mappers/AuthorMapper.xml"/><mapper url="file:///var/mappers/BlogMapper.xml"/><mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
mapper标签的class属性
<!-- class属性:配置mapper接口的全限定名,通过Java中的Mapper接口来加载映射文件 -->
<mappers><mapper class="org.mybatis.builder.AuthorMapper"/><mapper class="org.mybatis.builder.BlogMapper"/><mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
使用这种方式必须满足以下前提:
-
SQL映射文件和mapper接口需存放在同一个目录下。因为mybatis会自动去Mapper接口所在的目录下去找SQL映射文件
-
SQL映射文件的名字和mapper接口名一致。
-
必须使用mapper代理的开发方式。
注意:同一个目录是指编译之后的目录,并非开发时的目录。
将CarMapper.xml文件移动到和mapper接口同一个目录下:
-
在resources目录下新建一个和mapper接口包名一样的多级目录:com/powernode/mybatis/mapper【这里千万要注意:不能这样新建 com.powernode.mybatis.dao】
-
将CarMapper.xml文件移动到mapper目录下
mappers标签嵌套package标签
如果class较多,使用 package标签的方式 批量加载SQL映射文件
此种配置使mapper扫描指定包,并在此包下获取所有的接口以及与接口名称相同mapper文件,
并加载;
<mappers>
<!-- name属性:存放Mapper接口与mapper.xml文件的包名 --><package name="com.powernode.mybatis.mapper"/>
</mappers>
要求:与mapper接口加载单个映射文件(class方式)一致。
Mybatis配置文件的标签顺序
Mybatis配置文件中各标签的位置顺序如下:
properties?,
settings?,
typeAliases?,
typeHandlers?,
objectFactory?,
objectWrapperFactory?,
reflectorFactory?,
plugins?,
environments?,
databaseIdProvider?,
mappers?
具体可以参考 http://mybatis.org/dtd/mybatis-3-config.dtd 文件。