03_mybatis配置文件详解
1. SqlMapConfig.xml
mybatis全局配置文件SqlMapConfig.xml,配置内容如下:
*properties(属性)
setting(全局配置参数)
typeAliases(类型别名)
typeHandlers(类型处理器)
plugins(插件)
enviroments(环境集合对象)
enviroment(环境子属性对象)
transactionManager(事务管理)
datasource(数据源)
mappers(映射器)
1.1 properties属性
可将数据库连接参数单独配置在db.properties中,只需要在SqlMapConfig.xml中加载db.properties的属性值。
在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。
db.properties:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybaties?characterEncoding=utf-8
jdbc.username=root
jdbc.password=123456
在SqlMapConfig.xml中加载属性文件:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--加载属性文件-->
<properties resource="com/mybatis/config/db.properties"></properties>
<settings>
<setting name="logImpl" value="LOG4J"/>
</settings>
.....
.....
properties特性:注意: MyBatis 将按照下面的顺序来加载属性:
在 properties元素体内定义的属性首先被读取。
然后会读取properties 元素中resource或 url 加载的属性,它会覆盖已读取的同名属性。
最后读取parameterType传递的属性,它会覆盖已读取的同名属性。
建议:不要在properties元素体内添加任何属性值,只将属性值定义在properties文件中。在properties文件中定义属性名要有一定的特殊性,如:XXXXX.XXXXX.XXXX
1.2 settings全局配置参数
mybatis框架在运行时可以调整一些运行参数。
比如:开启二级缓存、开启延迟加载、全局参数将会影响mybatis
1.3 typeAliases(别名)
在mapper.xml中,定义很多的statement,statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。
如果在指定类型时输入类型全路径,不方便进行开发,可以针对parameterType或resultType指定的类型定义一些别名,在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)自定义别名
单个别名定义:
<!--别名-->
<typeAliases>
<!--针对单个别名定义-->
<typeAlias type="com.mybatis.po.User" alias="user"></typeAlias>
</typeAliases>
批量别名定义:批量别名定义mybatis:自动扫描包中的po类,别名就是类名(首字母大写小写都可以)
<!--别名-->
<typeAliases>
<!--批量别名定义
mybatis:自动扫描包中的po类,别名就是类名(首字母大写小写都可以)
-->
<package name="com.mybatis.po"></package>
</typeAliases>
引用别名:
<select id="findUserByName" parameterType="java.lang.String" resultType="user">
SELECT * FROM USER WHERE USERNAME LIKE '%${value}%'
</select>
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(映射配置)
通过resource加载单个映射文件
<!--加载映射文件-->
<mappers>
<mapper resource="com/mybatis/config/mapper/UserMapper.xml"></mapper>
</mappers>
通过mapper接口加载单 个mapper
通过mapper接口加载映射文件,遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在同一个目录中,按照这个规范:将mapper.java和mapper.xml放在一个目录中,且同名。
<!--加载映射文件-->
<mappers>
<mapper class="com.mybatis.mapper.UserMapper"></mapper>
</mappers>
批量加载mapper(推荐使用)
指定mapper接口的包名,mybatis自动扫描包下所有mapper接口进行加载;
遵循规范:使用mapper代理开发、mapper.java和mapper.xml在同一个包中、mapper接口类名和mapper.xml映射文件名称保持一致
<!--加载映射文件-->
<mappers>
<!--批量加载mapper映射文件-->
<package name="com.mybatis.mapper"/>
</mappers>
…补充中