首页 > 代码库 > 五 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详解