首页 > 代码库 > 五 mybatis的SqlMapConfig.xml详解
五 mybatis的SqlMapConfig.xml详解
SqlMapConfig.xml
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE configuration 3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-config.dtd"> 5 <configuration> 6 7 <!-- 加载属性文件 --> 8 <properties resource="db.properties"> 9 <!--properties中还可以配置一些属性名和属性值 --> 10 <!-- <property name="jdbc.driver" value=""/> --> 11 </properties> 12 <!-- 全局配置参数,需要时再设置 --> 13 <!-- <settings> 14 15 </settings> --> 16 17 <!-- 别名定义 --> 18 <typeAliases> 19 20 <!-- 针对单个别名定义 21 type:类型的路径 22 alias:别名 23 --> 24 <!-- <typeAlias type="cn.itcast.mybatis.po.User" alias="user"/> --> 25 <!-- 批量别名定义 26 指定包名,mybatis自动扫描包中的po类,自动定义别名,别名就是类名(首字母大写或小写都可以) 27 --> 28 <package name="cn.itcast.mybatis.po"/> 29 30 </typeAliases> 31 32 <!-- 和spring整合后 environments配置将废除--> 33 <environments default="development"> 34 <environment id="development"> 35 <!-- 使用jdbc事务管理,事务控制由mybatis--> 36 <transactionManager type="JDBC" /> 37 <!-- 数据库连接池,由mybatis管理--> 38 <dataSource type="POOLED"> 39 <property name="driver" value="${jdbc.driver}" /> 40 <property name="url" value="${jdbc.url}" /> 41 <property name="username" value="${jdbc.username}" /> 42 <property name="password" value="${jdbc.password}" /> 43 </dataSource> 44 </environment> 45 </environments> 46 <!-- 加载 映射文件 --> 47 <mappers> 48 <mapper resource="sqlmap/User.xml"/> 49 50 <!--通过resource方法一次加载一个映射文件 --> 51 <!-- <mapper resource="mapper/UserMapper.xml"/> --> 52 53 <!-- 通过mapper接口加载单个 映射文件 54 遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中 55 上边规范的前提是:使用的是mapper代理方法 56 --> 57 <!-- <mapper class="cn.itcast.mybatis.mapper.UserMapper"/> --> 58 59 <!-- 批量加载mapper 60 指定mapper接口的包名,mybatis自动扫描包下边所有mapper接口进行加载 61 遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中 62 上边规范的前提是:使用的是mapper代理方法 63 --> 64 <package name="cn.itcast.mybatis.mapper"/> 65 66 </mappers> 67 68 </configuration>
SqlMapConfig.xml
mybatis的全局配置文件SqlMapConfig.xml,配置内容如下:
properties(属性)
settings(全局配置参数)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境集合属性对象)
environment(环境子属性对象)
transactionManager(事务管理)
dataSource(数据源)
mappers(映射器)
1.1 properties属性
需求:
将数据库连接参数单独配置在db.properties中,只需要在SqlMapConfig.xml中加载db.properties的属性值。
在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。
将数据库连接参数只配置在db.properties中,原因:方便对参数进行统一管理,其它xml可以引用该db.properties。
1 jdbc.driver=com.mysql.jdbc.Driver 2 jdbc.url=jdbc:mysql://localhost:3306/mybatis 3 jdbc.username=root 4 jdbc.password=mysql
在sqlMapConfig.xml加载属性文件:
1 <properties resource="db.properties"> 2 <!--properties中还可以配置一些属性名和属性值 --> 3 <!-- <property name="jdbc.driver" value=""/> --> 4 </properties> 5 6 <!-- 和spring整合后 environments配置将废除--> 7 <environments default="development"> 8 <environment id="development"> 9 <!-- 使用jdbc事务管理,事务控制由mybatis--> 10 <transactionManager type="JDBC" /> 11 <!-- 数据库连接池,由mybatis管理--> 12 <dataSource type="POOLED"> 13 <property name="driver" value="${jdbc.driver}" /> 14 <property name="url" value="${jdbc.url}" /> 15 <property name="username" value="${jdbc.username}" /> 16 <property name="password" value="${jdbc.password}" /> 17 </dataSource> 18 </environment> 19 </environments>
properties特性:
注意: MyBatis 将按照下面的顺序来加载属性:
① 在 properties 元素体内定义的属性首先被读取。
② 然后会读取properties 元素中resource或 url 加载的属性,它会覆盖已读取的同名属性。
③ 最后读取parameterType传递的属性,它会覆盖已读取的同名属性。
建议:
不要在properties元素体内添加任何属性值,只将属性值定义在properties文件中。
在properties文件中定义属性名要有一定的特殊性,如:XXXXX.XXXXX.XXXX
1.2 settings全局参数配置
mybatis框架在运行时可以调整一些运行参数。
比如:开启二级缓存、开启延迟加载。。
全局参数将会影响mybatis的运行行为。
详细参见“学习资料/mybatis-settings.xlsx”文件
1.3 typeAliases(别名)重点
1.3.1 需求
在mapper.xml中,定义很多的statement,statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。
如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterType或resultType指定的类型定义一些别名,在mapper.xml中通过别名定义,方便开发。
1.3.2 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 |
1.3.3 自定义别名
1.3.3.1 单个别名定义
引用别名:
1.3.3.2 批量定义别名(常用)
1.4 typeHandlers(类型处理器)
mybatis中通过typeHandlers完成jdbc类型和java类型的转换。
通常情况下,mybatis提供的类型处理器满足日常需要,不需要自定义.
mybatis支持类型处理器:
类型处理器 |
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-任何兼容的字符串类型,作为代码存储(而不是索引)。 |
1.5 mappers(映射配置)
1.5.1 通过resource加载单个映射文件
1.5.2 通过mapper接口加载单个mapper
按照上边的规范,将mapper.java和mapper.xml放在一个目录 ,且同名。
1.5.3 批量加载mapper(推荐使用)
五 mybatis的SqlMapConfig.xml详解