- 简介
SqlMapConfig.xml是MyBatis的全局配置文件,在前面的文章中我们可以看出,在SqlMapConfig.xml主要是配置了数据源、事务和映射文件,其实在SqlMapConfig.xml中还可以配置很多信息,如:
(属性)
(全局配置参数)
(类型别名)
(类型处理器)
(对象工厂)
(插件)
(环境集合属性对象)
(环境子属性对象)
(事务管理)
(数据源)
(映射器)
- properties
db.properties中,只需要在SqlMapConfig.xml中加载db.properties的属性值,在SqlMapConfig.xml中就不需要对数据库连接参数硬编码,将数据库连接参数只配置在db.properties中,原因:方便对参数进行统一管理,其它xml可以引用该db.properties。这样如果有多处修改数据源信息的话,只需要修改db.properties配置文件即可。
在classpath下定义db.properties文件如下:
1 jdbc.driver=com.mysql.jdbc.Driver
2 jdbc.url=jdbc:mysql://localhost:3306/shop
3 jdbc.username=root
4 jdbc.password=
SqlMapConfig.xml引用如下:
1 <properties resource="db.properties"/>
2 <environments default="development">
3 <environment id="development">
4 <transactionManager type="JDBC"/>
5 <dataSource type="POOLED">
6 <property name="driver" value="${jdbc.driver}"/>
7 <property name="url" value="${jdbc.url}"/>
8 <property name="username" value="${jdbc.username}"/>
9 <property name="password" value="${jdbc.password}"/>
10 </dataSource>
11 </environment>
12 </environments>
特性:
MyBatis 将按照下面的顺序来加载属性:
1、在 properties 元素体内定义的属性首先被读取。
properties 元素中resource或 url 加载的属性,它会覆盖已读取的同名属性。
3、最后读取parameterType传递的属性,它会覆盖已读取的同名属性。
resource或 url 加载的属性次之,最低优先级的是 properties 元素体内定义的属性。
一般不要在properties元素体内添加任何属性值,只将属性值定义在properties文件中。在properties文件中定义属性名要有一定的特殊性,如:XXXXX.XXXXX.XXXX。
- settings(全局配置参数)
mybatis框架在运行时可以调整一些运行参数。比如:开启二级缓存、开启延迟加载。全局参数将会影响mybatis的运行行为。具体需要可以查看MyBatis的文档。
- typeAliases(类型别名)
在mapper.xml中,定义很多的statement,statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterType或resultType指定的类型定义一些别名,在mapper.xml中通过别名定义,方便开发。
1、MyBatis默认支持的别名:
别名 | 映射的类型 |
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | String |
byte | Byte |
long | Long |
short | Short |
int | Integer |
integer | Integer |
double | Double |
float | Float |
boolean | Boolean |
date | Date |
decimal | BigDecimal |
bigdecimal | BigDecimal |
2、自定义别名:
1 <typeAliases>
2 <!-- 单个别名 -->
3 <typeAlias type="com.luchao.mybatis.first.po.User" alias="user"/>
4 </typeAliases>
3、批量别名:
1 <typeAliases>
2 <!-- 批量别名定义,扫描整个包下的类,别名为类名(首字母大写或小写都可以) -->
3 <package name="com.luchao.mybatis.first.po"/>
4 </typeAliases>
- typeHandlers(类型处理器)
类型处理器用于java类型和jdbc类型映射,如下:
1 <select id="findUserById" parameterType="int" resultType="user">
2 select * from user where id = #{id}
3 </select>
自带的类型处理器基本上满足日常需求,不需要单独定义。
支持类型处理器:
类型处理器 | Java类型 | JDBC类型 |
BooleanTypeHandler | Boolean,boolean | 任何兼容的布尔值 |
ByteTypeHandler | Byte,byte | 任何兼容的数字或字节类型 |
ShortTypeHandler | Short,short | 任何兼容的数字或短整型 |
IntegerTypeHandler | Integer,int | 任何兼容的数字和整型 |
LongTypeHandler | Long,long | 任何兼容的数字或长整型 |
FloatTypeHandler | Float,float | 任何兼容的数字或单精度浮点型 |
DoubleTypeHandler | Double,double | 任何兼容的数字或双精度浮点型 |
BigDecimalTypeHandler | BigDecimal | 任何兼容的数字或十进制小数类型 |
StringTypeHandler | String | CHAR和VARCHAR类型 |
ClobTypeHandler | String | CLOB和LONGVARCHAR类型 |
NStringTypeHandler | String | NVARCHAR和NCHAR类型 |
NClobTypeHandler | String | NCLOB类型 |
ByteArrayTypeHandler | byte[] | 任何兼容的字节流类型 |
BlobTypeHandler | byte[] | BLOB和LONGVARBINARY类型 |
DateTypeHandler | Date(java.util) | TIMESTAMP类型 |
DateOnlyTypeHandler | Date(java.util) | DATE类型 |
TimeOnlyTypeHandler | Date(java.util) | TIME类型 |
SqlTimestampTypeHandler | Timestamp(java.sql) | TIMESTAMP类型 |
SqlDateTypeHandler | Date(java.sql) | DATE类型 |
SqlTimeTypeHandler | Time(java.sql) | TIME类型 |
ObjectTypeHandler | 任意 | 其他或未指定类型 |
EnumTypeHandler | Enumeration类型 | VARCHAR-任何兼容的字符串类型,作为代码存储(而不是索引)。 |
- mappers(映射器)
配置的几种方法:
1、<mapper resource=" " />
使用相对于类路径的资源,如:<mapper resource="sqlmap/User.xml" />
2、<mapper url=" " />
使用完全限定路径,如:<mapper url="file:///D:\workspace_spingmvc\mybatis_01\config\sqlmap\User.xml" />
<mapper class=" " />
mapper接口类路径,如:<mapper class="com.luchao.mybatis.first.mapper.UserMapper"/>
注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
通过mapper接口加载单个 映射文件遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录中
上边规范的前提是:使用的是mapper代理方法
<package name=""/>
mapper接口,如:<package name="cn.itcast.mybatis.mapper"/>
注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
批量加载mapper,指定mapper接口的包名,mybatis自动扫描包下边所有mapper接口进行加载,遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中
上边规范的前提是:使用的是mapper代理方法