前言:本篇主要记录在MyBatis学习过程中的主要知识点。
1.mybatis环境的搭建,通过maven可以快速的进行环境的搭建。
1 <!--文件版本-->
2 <properties>
3 <mybatis.version>3.4.5</mybatis.version>
4 <junit.version>4.12</junit.version>
5 <mysql-driver.version>5.1.38</mysql-driver.version>
6 <log4j.version>1.2.17</log4j.version>
7 <slf4j.version>1.7.25</slf4j.version>
8 <mbg.version>1.3.6</mbg.version>
9 </properties>
10
11 <dependencies>
12 <dependency>
13 <groupId>org.mybatis</groupId>
14 <artifactId>mybatis</artifactId>
15 <version>${mybatis.version}</version>
16 </dependency>
17
18 <dependency>
19 <groupId>mysql</groupId>
20 <artifactId>mysql-connector-java</artifactId>
21 <version>${mysql-driver.version}</version>
22 </dependency>
23
24 <dependency>
25 <groupId>junit</groupId>
26 <artifactId>junit</artifactId>
27 <version>${junit.version}</version>
28 </dependency>
29
30 <dependency>
31 <groupId>log4j</groupId>
32 <artifactId>log4j</artifactId>
33 <version>${log4j.version}</version>
34 </dependency>
35
36 <dependency>
37 <groupId>org.slf4j</groupId>
38 <artifactId>slf4j-log4j12</artifactId>
39 <version>${slf4j.version}</version>
40 </dependency>
41
42 </dependencies>
43
44 <build>
45 <!--通过如下配置,解决找不到xml的异常-->
46 <resources>
47 <resource>
48 <directory>src/main/java</directory>
49 <includes>
50 <include>**/*.xml</include>
51 </includes>
52 <filtering>true</filtering>
53 </resource>
54 <resource>
55 <directory>src/main/resources</directory>
56 <includes>
57 <include>**/*.xml</include>
58 <include>**/*.properties</include>
59 </includes>
60 </resource>
61 </resources>
62 <plugins>
63 <plugin>
64 <!--Mybatis-generator插件,用于自动生成Mapper和POJO-->
65 <groupId>org.mybatis.generator</groupId>
66 <artifactId>mybatis-generator-maven-plugin</artifactId>
67 <version>${mbg.version}</version>
68 <configuration>
69 <!--配置文件的位置,注意文件路径的写法-->
70 <configurationFile>src/main/resources/mybatis-generator-config.xml</configurationFile>
71 <verbose>true</verbose>
72 <overwrite>true</overwrite>
73 </configuration>
74 <executions>
75 <execution>
76 <id>Generate MyBatis Artifacts</id>
77 <goals>
78 <goal>generate</goal>
79 </goals>
80 </execution>
81 </executions>
82 <dependencies>
83 <dependency>
84 <groupId>org.mybatis.generator</groupId>
85 <artifactId>mybatis-generator-core</artifactId>
86 <version>${mbg.version}</version>
87 </dependency>
88 </dependencies>
89 </plugin>
90 </plugins>
91 </build>
2.mybatis核心配置文件
mybatis的核心配置文件,位置与名称都不固定。
需要注意的是mybatis的核心配置文件的标签是有顺序的,如果顺序不对,会产生错误提示,可根据具体提示进行标签位置的调整。
mybatis核心配置文件主要配置如下:
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 <!--mybatis的标签是有顺序的,顺序不正确,会报错-->
7 <!--使用properties标签来引入外部properties配置文件的内容
8 resource:引入类路径下的资源
9 url:引入网络或者磁盘上的资源
10 -->
11 <properties resource="DataBaseConfig/db.properties"/>
12
13 <!--为了防止Oracle中插入null值报错,可以将jdbcTypeForNull,设置为NULL,mysql中是支持NULL和OTHER的-->
14 <settings>
15 <setting name="jdbcTypeForNull" value="NULL"/>
16 <!--以下两个属性配置后进行延迟加载-->
17 <setting name="lazyLoadingEnabled" value="true"/>
18 <setting name="aggressiveLazyLoading" value="false"/>
19 <setting name="cacheEnabled" value="true"/><!--开启二级缓存-->
20 </settings>
21
22 <!--别名处理器:typeAliases可以为java类型起别名-->
23 <typeAliases>
24 <!--别名不区分大小写-->
25 <!--type:指实体类的全类名;默认别名为类名小写
26 alias:新的名称-->
27 <!--typeAlias为单独一个实体类起别名 -->
28 <!--<typeAlias type="com.mybatisstudy.domain.User"/>-->
29 <!--package批量起别名
30 为某个包下的所有实体类对象起别名
31 name:指定包名,为包下及其子包下的实体类对象都起一个别名,默认类名的小写-->
32 <!--使用@Alias注解为冲突的类名,重新起一个别名,但是类名重复一般不存在-->
33 <package name="com.mybatisstudy.domain"/>
34 </typeAliases>
35 <!--与spring整合和,environments将被废除,由spring进行管理-->
36 <!--environments可以配置多种环境,必须有transactionManager和dataSource
37 可以通过environments的default属性,来快速的切换环境,所有可以配置多种环境-->
38 <environments default="development">
39 <environment id="development">
40 <!--使用jdbc管理事务,type有JDBC和MANAGED-->
41 <transactionManager type="JDBC"/>
42 <dataSource type="POOLED">
43 <property name="driver" value="${jdbc.driver}"/>
44 <property name="url" value="${jdbc.url}"/>
45 <property name="username" value="${jdbc.username}"/>
46 <property name="password" value="${jdbc.password}"/>
47 </dataSource>
48 </environment>
49 </environments>
50
51 <!--databaseIdProvider:支持多数据库厂商-->
52 <databaseIdProvider type="DB_VENDOR">
53 <!--为不同数据库起一个别名-->
54 <property name="MySQL" value="mysql"/>
55 </databaseIdProvider>
56 <!--mapper.xml文件一定要注册到全局配置文件中-->
57 <mappers>
58 <!--<mapper resource="com/mybatisstudy/sqlmap/UserMapper.xml"/>-->
59
60 <!--<mapper resource="com/mybatisstudy/sqlmap/UserMapper.xml"/>-->
61 <!--<mapper class="com.mybatisstudy.mapper.UserMapperAnotation"/>-->
62 <!--批量注册,sql映射文件和接口必须在同一包下,并且必须同名,但可通过小技巧进行转换-->
63 <package name="com.mybatisstudy.mapper"/>
64 </mappers>
65 </configuration>
3.关于sql映射文件
由于我们采用mapper接口式的编程,所以sql映射文件与mapper接口类的名称要相同,并且sql映射文件中namespace的值为对应mapper接口的全类名形式。
4.关于mybatis中的参数处理
对于mapper接口中单个参数,mybatis不会做特殊处理。可以通过#{参数名}进行取值操作。
对于mapper接口中的多个参数,mybatis会做特殊处理。多个参数会被mybatis封装成一个map,#{}就是从map中进行取值。
key的形式为:param1、param2......paramN的形式。
value:就是说要传入的值。
但是这种方式的可读性极差,因此可以采用命名参数的形式,通过@Param注解明确指定map中的key值。
如果多个参数正好是业务逻辑的数据模型,则可直接传入POJO,通过#{属性名}进行取值。
特别注意,如果参数为Collection(List,Set)类型或者是数组,mybatis也会特殊处理,mybatis也会把list或者数组封装在map中。
如果参数为Collection则map中的key为Collection(collection)。
如果参数为List,则map中的key可以直接使用list。
如果参数为数组,则map中的key为array。
5.关于mybatis的返回值和实体类字段与数据库字段不一致的问题
当mapper接口中某函数的返回值类型为List时,在其对应sql语句的resultType上直接写List集合的中元素的类型即可。
使用resultMap(自定义结果集映射规则),解决数据库字段和实体类属性不一致的情况。注意:resultMap和resultType只能二选一。
6.mybatis中的缓存机制
mybatis中默认定义了两级缓存,默认情况下一级缓存(本地缓存)开启。
一级缓存:在与数据库同一次会话期间的数据会放到一级缓存中,以后如果需要查询相同的数据,直接从缓存中取,不需要到数据中进行查询。
注意:一级缓存为sqlSession级别的缓存,一直都是开启的,不能关闭。
一级缓存失效的四种情况:
1)sqlSession不同,缓存失效。
2)sqlSession相同,查询条件不同,缓存失效,因为缓存中可能还没有相关数据。
3)sqlSession相同,在两次查询期间,执行了增删改操作,缓存失效。
4)sqlSession相同,但是手动清空了一级缓存,缓存失效。
二级缓存(全局缓存)需要进行配置,二级缓存是基于namespace级别的,一个namespace对应一个二级缓存。
二级缓存工作机制:
1)一个会话,查询一条数据,该数据会放在当前会话的一级缓存中。
2)如果当前会话关闭,对应的一级缓存会被保存到二级缓存中,新的会话查询信息,就可以参照二级缓存。
3)不同namespace查询出的数据会放在自己对应的缓存中。
注意:查出的数据都会默认放在一级缓存中,只有会话提交或关闭后,一级缓存的数据才会被转移到二级缓存中。
by Shawn Chen,2018.3.14日,晚。
来源:oschina
链接:https://my.oschina.net/u/4366204/blog/4047001