mybatis 的SqlMapConfig.xml配置文件(精华) 小结

SqlMapConfig.xml配置文件(精华)

配置内容

SqlMapConfig.xml中配置的内容和顺序如下：

properties（属性）（常用，需要掌握）

settings（全局配置参数）

typeAliases（类型别名）（常用，需要掌握）

typeHandlers（类型处理器）

objectFactory（对象工厂）

plugins（插件）

environments（环境集合属性对象）

environment（环境子属性对象）

transactionManager（事务管理）

dataSource（数据源）

mappers（映射器）（常用，需要掌握）

  properties（属性）

SqlMapConfig.xml可以引用java属性文件中的配置信息如下：

在SqlMapConfig.xml中加载属性文件

<!-- 加载属性文件 -->

    <properties resource="db.properties">

    <!-- properties中还可以配置其他属性 -->

<!--   <propertyname="url" value="" /> -->

    </properties>

在classpath下定义db.properties文件，

配置数据库信息，方便以后修改。提高代码的可维护性

jdbc.driver=com.mysql.jdbc.Driver

jdbc.url=jdbc:mysql://localhost:3306/mybatis

jdbc.username=root

jdbc.password=mysql

SqlMapConfig.xml引用如下：

<properties resource="db.properties"/>

    <environments default="development">

       <environment id="development">

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

 

注意： MyBatis 将按照下面的顺序来加载属性：

在 properties 元素体内定义的属性首先被读取。 
然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。 
最后读取parameterType传递的属性，它会覆盖已读取的同名属性。

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

定义properties的属性名称时需要特别定义，比如加一个前缀jdbc.name避免冲突

settings（配置）(了解)

mybatis全局配置参数，全局参数将会影响mybatis的运行行为。

 

详细参见“学习资料/mybatis-settings.xlsx”文件

typeAliases（类型别名）(了解)

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

 

自定义别名：（掌握）

在SqlMapConfig.xml中配置：批量别名定义，扫描整个包下的类，别名为类名（首字母大写或小写都可以）

<typeAliases>

    <!-- 单个别名定义 -->

    <typeAlias alias="user" type="cn.hpu.mybatis.po.User"/>

<!-- 批量别名定义

指定报名，mybatis自动扫描包中的po类，自动定义别名，别名就是类名（首字母大写或小写都可以）

    -->

    <package name="cn.hpu.mybatis.po"></package>

    <!-- 可多包扫描<packagename="cn.hpu.mybatis.po"></package> -->

</typeAliases>

typeHandlers（类型处理器）（了解）

类型处理器用于java类型和jdbc类型映射，如下：

 

<selectid="findUserById"parameterType="int" resultType="user">

       select * from user where id = #{id}

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

 

1.2    mappers（映射器）（掌握）

Mapper配置的几种方法：

1.3    <mapper resource="" />（掌握）

<mappers>

    <!-- 通过resource一次加载一个，单个映射文件的加载 -->

       <mapper resource="sqlmap/User.xml"></mapper>

</mappers>

1.3.1  <mapper url=" "/>

使用完全限定路径

如：<mapperurl="file:///D:\workspace_spingmvc\mybatis_01\config\sqlmap\User.xml"/>

 

1.3.2  <mapper class=" "/>（掌握）

<mappers>

    <!-- 通过 mapper接口加载映射文件

遵循mapper代理规范，需要将mapper接口类名和mapper.xml映射文件名车个保持一致，且在同一个目录中

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

    -->

<mapper class="cn.hpu.mybatis.mapper.UserMapper"/>

   </mappers>

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

1.3.3  <packagename=""/>（推荐）

注册指定包下的所有mapper接口

<mappers>

<!-- 批量加载mapper  推荐

       指定mapper接口的报名，mybatis自动扫描包下的所有的mapper接口进行加载

遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名车个保持一致，且在同一个目录中

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

     -->

    <package name="cn.hpu.mybatis.mapper"/>

</mappers>

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