mybatis笔记-6、confXML配置文件详解

# conf.xml配置文件


Contents

  • properties(属性)
  • settings(全局参数配置)
  • typeAliases(类型别名)
  • typeHandlers(类型处理器)
  • mappers(映射配置)

本文主要讲解SqlMapConfig配置文件,基本是对此文档的中文翻译:http://www.mybatis.org/mybatis-3/configuration.html

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

  • properties(属性)
  • settings(全局配置参数)
  • typeAliases(类型别名)
  • typeHandlers(类型处理器)
  • objectFactory(对象工厂)
  • plugins(插件)
  • environments(环境集合属性对象)
    • environment(环境子属性对象)
      • transactionManager(事务管理)
      • dataSource(数据源)
  • mappers(映射器)

(注:粗体是重点,斜体不常用)

1、properties(属性)

将数据库连接参数单独配置在db.properties中,只需要在SqlMapConfig.xml中加载db.properties的属性值。在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。

将数据库连接参数只配置在db.properties中。这样做的原因:方便对参数进行统一管理,其它xml可以引用该db.properties。

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://120.25.162.238:3306/mybatis001?characterEncoding=utf-8
jdbc.username=root
jdbc.password=123

在sqlMapConfig.xml加载属性文件:


<properties resource="db.properties">
        
        
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>

注意:

如果property在多个地方定义,则MyBatis 将按照下面的顺序(优先级)来加载属性:

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

建议:

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

2、settings(全局参数配置)

mybatis框架在运行时可以调整一些运行参数。比如:开启二级缓存、开启延迟加载…

全局参数将会影响mybatis的运行行为。具体参考官网:

http://www.mybatis.org/mybatis-3/configuration.html#settings

3、typeAliases(类型别名)(重点)

需求:在mapper.xml中,定义很多的statement,statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。

如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterTyperesultType指定的类型定义一些别名,在mapper.xml中通过别名定义,方便开发。别名是java类的缩写。

别名可以分为默认别名、单个类的别名和整个模块的别名

别名的分类:

  • mybatis默认别名
  • 自定义单个别名定义
  • 自定义批量定义别名(常用)


    
    
    
    
    


也可以使用注解的方式声明别名:

@Alias("author")
public class Author {
    ...
}

默认别名表:

http://www.mybatis.org/mybatis-3/configuration.html#typeAliases

默认别名 映射的类型
_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

4、typeHandlers(类型处理器)

mybatis中通过typeHandlers完成jdbc类型和java类型的转换。例如:

<select id="findUserById" parameterType="int" resultType="user">
		select * from user where id = #{id}
select>

mybatis自带的类型处理器基本上满足日常需求,不需要单独定义。

mybatis笔记-6、confXML配置文件详解_第1张图片

mybatis支持类型处理器http://www.mybatis.org/mybatis-3/configuration.html#typeHandlers

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

你也可以重写类型处理器或者新建你自己的非标准类型。需要继承BaseTypeHandler这个类,实现 TypeHandler 这个接口。

5、mappers(映射配置)

  • 通过resource加载单个映射文件

<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="mapper/UserMapper.xml"/>
mappers>
  • 通过mapper接口加载单个mapper
 
<mappers>
  <mapper class="com.iot.mybatis.mapper.UserMapper"/> 
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
mappers>

目录示例

com.iot.mybatis.mapper------------------package包
           |----UserMapper.java
           |----UserMapper.xml
  • 批量加载mapper(推荐使用)

<mappers>
  <package name="com.iot.mybatis.mapper"/>
  <package name="org.mybatis.builder"/>
mappers>

你可能感兴趣的:(数据库,mybatis)