首页 > 技术文章 > MyBatis学习--SqlMapConfig.xml配置文件

lcngu 2016-05-09 20:05 原文

  • 简介

  SqlMapConfig.xml是MyBatis的全局配置文件,在前面的文章中我们可以看出,在SqlMapConfig.xml主要是配置了数据源、事务和映射文件,其实在SqlMapConfig.xml中还可以配置很多信息,如:

  1、properties(属性)

  2、settings(全局配置参数)

  3、typeAliases(类型别名)

  4、typeHandlers(类型处理器)

  5、objectFactory(对象工厂)

  6、plugins(插件)

  7、environments(环境集合属性对象)

    7.1、environment(环境子属性对象)

    7.2、transactionManager(事务管理)

    7.3、dataSource(数据源)

  8、mappers(映射器)

 

  • 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>

  properties特性:

  MyBatis 将按照下面的顺序来加载属性:

  1、在 properties 元素体内定义的属性首先被读取。

  2、然后会读取properties 元素中resource或 url 加载的属性,它会覆盖已读取的同名属性。

  3、最后读取parameterType传递的属性,它会覆盖已读取的同名属性。

  因此,通过parameterType传递的属性具有最高优先级,resource或 url 加载的属性次之,最低优先级的是 properties 元素体内定义的属性。

  一般不要在properties元素体内添加任何属性值,只将属性值定义在properties文件中。properties文件中定义属性名要有一定的特殊性,如:XXXXX.XXXXX.XXXX。

 

  • settings(全局配置参数)

  mybatis框架在运行时可以调整一些运行参数。比如:开启二级缓存、开启延迟加载。全局参数将会影响mybatis的运行行为。具体需要可以查看MyBatis的文档。

 

  • typeAliases(类型别名)

  mapper.xml中,定义很多的statementstatement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterTyperesultType指定的类型定义一些别名,在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>

 

  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-任何兼容的字符串类型,作为代码存储(而不是索引)。

  • mappers(映射器)

  Mapper配置的几种方法:

  1、<mapper resource=" " />

  使用相对于类路径的资源,如:<mapper resource="sqlmap/User.xml" />

  2、<mapper url=" " />

  使用完全限定路径,如:<mapper url="file:///D:\workspace_spingmvc\mybatis_01\config\sqlmap\User.xml" />

  3、 <mapper class=" " />

  单个别名定义,使用mapper接口类路径,如:<mapper class="com.luchao.mybatis.first.mapper.UserMapper"/>

  注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。

  通过mapper接口加载单个 映射文件遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录中

  上边规范的前提是:使用的是mapper代理方法

  4、<package name=""/>

  注册指定包下的所有mapper接口,如:<package name="cn.itcast.mybatis.mapper"/>

  注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。

  批量加载mapper,指定mapper接口的包名,mybatis自动扫描包下边所有mapper接口进行加载,遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中

上边规范的前提是:使用的是mapper代理方法

 

推荐阅读