1.首先讲解的是MyBatis核心配置文件configuration.xml的配置
一个完整的configuration.xml配置顺序如下:
1
properties,settings,typeAliases,typeHandlers,objectFactory,objectWrapperFactory,plugins,environments,databaseIdProvider,mappers.
如果没有按照上面的标签顺序来配置,编译器会提示The content of element type "configuration" must match 的错误!!!
1)properties属性:
该属性允许我们将配置信息填写在外部文件中,然后通过动态配置来获取外部文件的配置信息,比如:
1.在src目录下创建db.properties文件 username=root password=123456 url=jdbc:mysql://localhost:3306/mybatis driver=com.mysql.jdbc.Driver
2.可以在configuration.xml中配置<properties resource="db.properties"/>来引用外部文件
3.这样我们就可以使用动态配置来获取外部文件的配置了: <dataSource type="POOLED"> <property name="username" value="${username}"/> <property name="password" value="${password}"/> <property name="url" value="${url}"/> <property name="driver" value="${driver}"/> </dataSource>
2)settings
这是MyBatis 修改操作运行过程细节的重要的步骤。下方这个表格描述了这些设置项、含义和默认值。
设置项 |
描述 |
允许值 |
默认值 |
cacheEnabled |
对在此配置文件下的所有cache 进行全局性开/关设置。 |
true | false |
true |
lazyLoadingEnabled |
全局性设置懒加载。如果设为‘false’,则所有相关联的都会被初始化加载。 |
true | false |
true |
aggressiveLazyLoading |
当设置为‘true’的时候,懒加载的对象可能被任何懒属性全部加载。否则,每个属性都按需加载。 |
true | false |
true |
multipleResultSetsEnabled |
允许和不允许单条语句返回多个数据集(取决于驱动需求) |
true | false |
true |
useColumnLabel |
使用列标签代替列名称。不同的驱动器有不同的作法。参考一下驱动器文档,或者用这两个不同的选项进行测试一下。 |
true | false |
true |
useGeneratedKeys |
允许JDBC 生成主键。需要驱动器支持。如果设为了true,这个设置将强制使用被生成的主键,有一些驱动器不兼容不过仍然可以执行。 |
true | false |
false |
autoMappingBehavior |
指定MyBatis 是否并且如何来自动映射数据表字段与对象的属性。PARTIAL将只自动映射简单的,没有嵌套的结果。FULL 将自动映射所有复杂的结果。 |
NONE, PARTIAL, FULL |
PARTIAL |
defaultExecutorType |
配置和设定执行器,SIMPLE 执行器执行其它语句。REUSE 执行器可能重复使用prepared statements 语句,BATCH执行器可以重复执行语句和批量更新。 |
SIMPLE REUSE BATCH |
SIMPLE |
defaultStatementTimeout |
设置一个时限,以决定让驱动器等待数据库回应的多长时间为超时 |
正整数 |
Not Set (null) |
例如:
1 < settings > 2 < setting name ="cacheEnabled" value ="true" /> 3 < setting name ="lazyLoadingEnabled" value ="true" /> 4 < setting name ="multipleResultSetsEnabled" value ="true" /> 5 < setting name ="useColumnLabel" value ="true" /> 6 < setting name ="useGeneratedKeys" value ="false" /> 7 < setting name ="enhancementEnabled" value ="false" /> 8 < setting name ="defaultExecutorType" value ="SIMPLE" /> 9 </ settings >
3)typeAliases类型别名
类型别名是Java 类型的简称。
它仅仅只是关联到XML 配置,简写冗长的JAVA 类名。例如:
1 < typeAliases > 2 < typeAlias alias ="UserEntity" type ="com.manager.data.model.UserEntity" /> 3 < typeAlias alias ="StudentEntity" type ="com.manager.data.model.StudentEntity" /> 4 < typeAlias alias ="ClassEntity" type ="com.manager.data.model.ClassEntity" /> 5 </ typeAliases >
所以可以再xxxMapper.xml文件中这样配置:
1 <? xml version="1.0" encoding="UTF-8" ?> 2 <! DOCTYPE mapper 3 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > 5 < mapper namespace ="com.dao.UserDao" > 6 < select id ="selectById" parameterType ="int" resultType ="UserEntity" > 7 select * from user where id=#{id} 8 </ select > 9 </ mapper >
使用这个配置,“UserEntity”就能在任何地方代替“com.manager.data.model.UserEntity”被使用。
还有一些与通用JAVA类型建立的别名。它们是大小写敏感的,注意JAVA的基本类型,使用了_来命名。
别名 |
映射的类型 |
_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 |
object |
Object |
map |
Map |
hashmap |
HashMap |
list |
List |
arraylist |
ArrayList |
collection |
Collection |
iterator |
Iterator |
4)typeHandles类型句柄
无论是MyBatis在预处理语句中设置一个参数,还是从结果集中取出一个值时,类型处理器被用来将获取的值以合适的方式转换成Java类型。
下面这个表格描述了默认的类型处理器。
类型处理器 |
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 |
Any |
其他或未指定类型 |
EnumTypeHandler |
Enumeration类型 |
VARCHAR-任何兼容的字符串类型,作为代码存储(而不是索引)。 |
你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。要这样做的话,简单实现TypeHandler接口(org.mybatis.type),然后映射新的类型处理器类到Java类型,还有可选的一个JDBC类型。然后再typeHandlers中添加这个类型处理器。
新定义的类型处理器将会覆盖已经存在的处理Java的String类型属性和VARCHAR参数及结果的类型处理器。要注意MyBatis不会审视数据库元信息来决定使用哪种类型,所以你必须在参数和结果映射中指定那是VARCHAR类型的字段,来绑定到正确的类型处理器上。这是因为MyBatis直到语句被执行都不知道数据类型的这个现实导致的。
例如:
1 public class LimingStringTypeHandler implements TypeHandler { 2 3 @Override 4 public void setParameter(PreparedStatement ps, int i, Object parameter, JdbcType jdbcType) throws SQLException { 5 System.out.println("setParameter - parameter: " + ((String) parameter) + ", jdbcType: " + jdbcType.TYPE_CODE); 6 ps.setString(i, ((String) parameter)); 7 } 8 9 @Override 10 public Object getResult(ResultSet rs, String columnName) throws SQLException { 11 System.out.println("getResult - columnName: " + columnName); 12 return rs.getString(columnName); 13 } 14 15 @Override 16 public Object getResult(CallableStatement cs, int columnIndex) throws SQLException { 17 System.out.println("getResult - columnIndex: " + columnIndex); 18 return cs.getString(columnIndex); 19 } 20 }
在配置文件的typeHandlers中添加typeHandler标签
< typeHandlers > < typeHandler javaType ="String" jdbcType ="VARCHAR" handler ="liming.student.manager.type.LimingStringTypeHandler" /> </ typeHandlers >
5)对象工厂ObjectFactory
1 public class LimingObjectFactory extends DefaultObjectFactory { 2 3 private static final long serialVersionUID = -399284318168302833L ; 4 5 @Override 6 public Object create(Class type) { 7 return super .create(type); 8 } 9 10 @Override 11 public Object create(Class type, List<Class> constructorArgTypes, List<Object> constructorArgs) { 12 System.out.println("create - type: " + type.toString()); 13 return super .create(type, constructorArgTypes, constructorArgs); 14 } 15 16 @Override 17 public void setProperties(Properties properties) { 18 System.out.println("setProperties - properties: " + properties.toString() + ", someProperty: " + properties.getProperty("someProperty" )); 19 super .setProperties(properties); 20 } 21 22 }
在配置文件中添加objectFactory标签
< objectFactory type ="liming.student.manager.configuration.LimingObjectFactory" > < property name ="someProperty" value ="100" /> </ objectFactory >
6)插件(plugins)
MyBatis允许你在某一点拦截已映射语句执行的调用。默认情况下,MyBatis允许使用插件来拦截方法调用:
Executor(update, query, flushStatements, commit, rollback, getTransaction, close, isClosed) ParameterHandler(getParameterObject, setParameters) ResultSetHandler(handleResultSets, handleOutputParameters) StatementHandler(prepare, parameterize, batch, update, query)
这些类中方法的详情可以通过查看每个方法的签名来发现,而且它们的源代码在MyBatis的发行包中有。你应该理解你覆盖方法的行为,假设你所做的要比监视调用要多。
如果你尝试修改或覆盖一个给定的方法,你可能会打破MyBatis的核心。这是低层次的类和方法,要谨慎使用插件。
使用插件是它们提供的非常简单的力量。简单实现拦截器接口,要确定你想拦截的指定签名。
7)environment环境
MyBatis 可以配置多个环境。这可以帮助你SQL 映射对应多种数据库等。
8)映射器
这里是告诉MyBatis 去哪寻找映射SQL 的语句。可以使用类路径中的资源引用,或者使用字符,输入确切的URL 引用。
1 < mappers > 2 < mapper resource ="com/manager/data/maps/UserMapper.xml" /> 3 < mapper resource ="com/manager/data/maps/StudentMapper.xml" /> 4 < mapper resource ="com/manager/data/maps/ClassMapper.xml" /> 5 </ mappers >