关于mybatis的学习笔记
配置文件
贴出mybatis的配置文件,这里mybatis还未与spring做整合:
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE configuration 3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-config.dtd"> 5 <configuration> 6 7 <!-- 此文件中配置顺序需要注意 properties?,settings?,typeAliases?,typeHandlers?, objectFactory?,objectWrapperFactory?,plugins?, 8 environments?,databaseIdProvider?,mappers 9 properties 属性 10 settings 设置 11 typeAliases 类型别名 12 typeHandlers 类型处理器 13 objectFactory 对象工厂 14 plugins 插件 15 environments 环境 16 environment 环境变量 17 transactionManager 事务管理器 18 dataSource 数据源 19 mappers 映射器 20 顺序从上到下 --> 21 22 <!-- 需要 引入外部文件的配置,当有spring配置文件时这的jdbc配置文件就可以在spring的文件中引入 --> 23 <properties resource="jdbc.properties"></properties> 24 25 <!-- 实体类与数据库表中字段关系映射 --> 26 <settings> 27 <!-- 下划线字段名转换骆驼属性名 --> 28 <setting name="mapUnderscoreToCamelCase" value="true" /> 29 </settings> 30 31 <!--
设置别名,对应的xml中实体就不用每次配置对象类的全路径了 这里可以在spring配置文件中配置
扫描包会生成2个别名,一个大写一个小写(如实体类User,配置别名后悔生成User或者user);-->
32 <typeAliases> 33 <package name="com.vincce.study.mybaits.entity" /> 34 </typeAliases> 35 36 <!-- 链接数据库 四大基本要素 这里可以配置在spring配置文件中 --> 37 <environments default="development"> 38 <!-- 这里可以配置测试、生产、开发环境,但是这里一般都是在spring配置文件中进行配置 --> 39 <environment id="development"> 40 <transactionManager type="JDBC" /> 41 <dataSource type="POOLED"> 42 <property name="driver" value="${jdbc.driver}" /> 43 <property name="url" value="${jdbc.url}" /> 44 <property name="username" value="${jdbc.username}" /> 45 <property name="password" value="${jdbc.password}" /> 46 </dataSource> 47 </environment> 48 49 <environment id="test"> 50 <transactionManager type="JDBC" /> 51 <dataSource type="POOLED"> 52 <property name="driver" value="${jdbc.driver}" /> 53 <property name="url" value="${jdbc.url}" /> 54 <property name="username" value="${jdbc.username}" /> 55 <property name="password" value="${jdbc.password}" /> 56 </dataSource> 57 </environment> 58 </environments> 59 60 <!-- 在mybatis主配置文件中声明xml文件 可以在spring配置文件中进行配置--> 61 <mappers> 62 <!-- 这种配置需要没写一个xml 都需要配置一个xml,值是路径相对于资源目录跟路径,这样配置麻烦 --> 63 <!-- <mapper resource="mapper/UserMapper.xml" /> --> 64 <!-- url值是xml的绝对路径 --> 65 <!-- <mapper url="E:/study/study_mybatis/workspace_mybatis/study_mybatis_common/study_mybatis_jdbcTest/src/main/resources/mapper/UserMapper.xml"/> --> 66 <!-- 这样配置 需要将xml文件放在与接口同一个包下,并且名字相同 这样可以找到xml文件 执行sql --> 67 <!-- <mapper class="com.vincce.study.mybaits.dao.UserMapper"/> --> 68 <!-- 这里直接配置接口的全路径,最方便 --> 69 <package name="com.vincce.study.mybaits.dao" /> 70 </mappers> 71 72 </configuration>
对于mybatis的主配置文件中,下面列出详细的配置说明:标红是我们最常用的;
setting标签:
这些是极其重要的调整, 它们会修改 MyBatis 在运行时的行为方式。 下面这个表格描述 了设置信息,它们的含义和默认值。
设置参数 |
描述 |
有效值 |
默认值 |
cacheEnabled |
这个配置使全局的映射器启用或禁用 缓存。 |
true | false |
true |
lazyLoadingEnabled |
全局启用或禁用延迟加载。当禁用时, 所有关联对象都会即时加载。 This value can be superseded for an specific relation by using the fetchTypeattribute on it. |
true | false |
false |
aggressiveLazyLoading |
当启用时, 有延迟加载属性的对象在被 调用时将会完全加载任意属性。否则, 每种属性将会按需要加载。 |
true | false |
true |
multipleResultSetsEnabled |
允许或不允许多种结果集从一个单独 的语句中返回(需要适合的驱动) |
true | false |
true |
useColumnLabel |
使用列标签代替列名。 不同的驱动在这 方便表现不同。 参考驱动文档或充分测 试两种方法来决定所使用的驱动。 |
true | false |
true |
useGeneratedKeys |
允许 JDBC 支持生成的键。 需要适合的 驱动。 如果设置为 true 则这个设置强制 生成的键被使用, 尽管一些驱动拒绝兼 容但仍然有效(比如 Derby) |
true | false |
False |
autoMappingBehavior |
指定 MyBatis 如何自动映射列到字段/ 属性。PARTIAL 只会自动映射简单, 没有嵌套的结果。FULL 会自动映射任 意复杂的结果(嵌套的或其他情况) 。 |
NONE, PARTIAL, FULL |
PARTIAL |
defaultExecutorType |
配置默认的执行器。SIMPLE 执行器没 有什么特别之处。REUSE 执行器重用 预处理语句。BATCH 执行器重用语句 和批量更新 |
SIMPLE REUSE BATCH |
SIMPLE |
defaultStatementTimeout |
设置超时时间, 它决定驱动等待一个数 据库响应的时间。 |
Any positive integer |
Not Set (null) |
safeRowBoundsEnabled |
Allows using RowBounds on nested statements. |
true | false |
False |
mapUnderscoreToCamelCase |
Enables automatic mapping from classic database column names A_COLUMN to camel case classic Java property names aColumn. |
true | false |
False |
localCacheScope |
MyBatis uses local cache to prevent circular references and speed up repeated nested queries. By default (SESSION) all queries executed during a session are cached. If localCacheScope=STATEMENT local session will be used just for statement execution, no data will be shared between two different calls to the same SqlSession. |
SESSION | STATEMENT |
SESSION |
jdbcTypeForNull |
Specifies the JDBC type for null values when no specific JDBC type was provided for the parameter. Some drivers require specifying the column JDBC type but others work with generic values like NULL, VARCHAR or OTHER. |
JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER |
OTHER |
lazyLoadTriggerMethods |
Specifies which Object's methods trigger a lazy load |
A method name list separated by commas |
equals,clone,hashCode,toString |
defaultScriptingLanguage |
Specifies the language used by default for dynamic SQL generation. |
A type alias or fully qualified class name. |
org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver |
callSettersOnNulls |
当结果集中含有Null值时是否执行映射对象的setter或者Map对象的put方法。此设置对于原始类型如int,boolean等无效。 |
true | false |
false |
logPrefix |
Specifies the prefix string that MyBatis will add to the logger names. |
Any String |
Not set |
logImpl |
Specifies which logging implementation MyBatis should use. If this setting is not present logging implementation will be autodiscovered. |
SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING |
Not set |
proxyFactory |
Specifies the proxy tool that MyBatis will use for creating lazy loading capable objects. |
CGLIB | JAVASSIST |
CGLIB |
对于Mapper xml文件
Mapper映射文件是在实际开发过程中使用最多的,也是我们学习的重点。
Mapper文件中包含的元素有:
- cache – 配置给定命名空间的缓存。
- cache-ref – 从其他命名空间引用缓存配置。
- resultMap – 映射复杂的结果对象。
- sql – 可以重用的 SQL 块,也可以被其他语句引用。
- insert – 映射插入语句
- update – 映射更新语句
- delete – 映射删除语句
- select – 映射查询语句
标签中的属性值,
- parameterType的传入参数
-
传入类型有三种:
1、简单类型,string、long、integer等
2、Pojo类型,User等
3、HashMap类型。
在使用#{}传参时,#{}只是做占位符,与参数名无关。在使用${}传参时,是通过参数名获取参数的,如果没有指定参数名则可以通过value获取,如果指定则需要按照名称获取。
当DAO接口中需要传递多个参数时有三种方法传递:
- 将参数封装一个hashmap传递;
- 将参数封装成一个对象传递;
- 使用@Param注解表明参数传递;
-
- parameterType的传入多个参数
-
当DAO接口中需要传递多个参数时有两种方法传递:
- 使用默认规则获取参数;
默认规则:
a) 使用参数的下标,从0开始,#{0},#{1}
b) 使用param1、param2、param。。。。 #{param1}、#{param2} - 使用@Param注解表明参数传递;
public User login(@Param("userName")String userName, @Param("password")String password);
注意:注解最终会转化为map传入;
- 使用默认规则获取参数;
-
动态sql
1.1.1. where
需求:查询所有用户,如果输入了姓名,进行模糊查找。
where 标签的应用场景:
之前我们使用过的一种有条件的查询sql语句:
select * from tb_user where 1=1 and name like ‘%name%’;
这里的name这个条件是不确定的,为了防止这个参数是空报错,所以加上1=1这个条件,那么使用mybatis的where标签就可以不必这么写了;使用方式如下所示:
经过测试,当多条件参数指出现一个参数,这里是不需要and开头的,where标签在if判断里面也加上了and ,这里是可以自动隐去and;如果多条件参数值都不为空,我们在if标签里不加and,这里会报异常,所以建议写法是不管条件个数,都加上and。
<select id="queryUserByLikeName2" resultType="User">
SELECT * FROM tb_user
<where>
<if test="name != null and name != ''">
AND name LIKE #{name}
</if>
<if test="age != null and age != ''">
AND age = #{age}
</if>
</where>
</select>
1.1.2. foreach
需求:按照多个ID查询用户信息。用途:多个id查询、删除,批量插入数据;
传统的sql语句:select * from tb_user where id in(1,2,3);
这里使用mybatis在xml中可以这么使用,使用foreach标签, collections是要迭代的集合,item是集合中的每个元素,每个元素之间用逗号分隔,使用separator,前后括号使用open close 如下面所示:
<select id="queryUserByIds" resultType="User">
SELECT * FROM tb_user WHERE id IN
<foreach collection="ids" item="id" separator="," open="(" close=")">
#{id}
</foreach>
</select>
这里foreach还有一个应用场景,使用的还是很多的,做批量插入
传统的sql:
insert into tb_user (id,user_name,name,age,sex)
values(null,’lisi’,’lisi’,20,1),(null,’wangwu’,’wangwu’,20,0);这种写法是可行的,那么在mybatis的xml中的实现方式是:
<insert id=”insertUsers” >
insert into tb_user (id,user_name,name,age,sex) values
<foreach collections=”users” item = “user” separator=”,” open=”(” close=”)”>
#{user}
</foreach>
</insert>