MyBatis从入门到精通(第9章):Spring集成MyBatis(中)
框架(Framework)是整个或部分系统的可重用设计,表现为一组抽象构件及构件实例间交互的方法。
应该将应用自身的设计和具体的实现技术解耦。技术实现是应用的底层支撑,它不应该直接对应用产生影响。
框架一般处在低层应用平台(如 J2EE)和高层业务逻辑之间的中间层。
- mybatis-spring 可以帮助我们将MyBatis代码无缝整合到Spring中。使用这个类库中的类,Spring将会加载必要的MyBatis工厂类和Session类。
- MyBatis Spring Adapter项目地址为: https://github.com/mybatis/spring
9.3 集成 MyBatis
需要注意的是,在 9.1 节创建基本项目的时候就己经添加了 MyBatis 的依赖,这一节主要是介绍与 mybatis-spring 相关的内容。
1. 在 pom.xml 中添加 mybatis-spring 依赖
mybatis-spring就是Mybatis和spring集成中必须的依赖。
此处使用版本为2.0.2版本。mybatis 3.5.2 spring 5.0.15.RELEASE
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.2</version>
</dependency>
2. 配置 SqlSessionFactoryBean
在mybatis-spring中,SqlSessionFactoryBean 是用于创建SqlSessionFactory 的。在Spring的.xml配置文件 applicationContext.xml中配置这个工厂类,代码如下。
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="configLocation" value="classpath:mybatis-config.xml"/>
<property name="dataSource" ref="dataSource"/>
<property name="mapperLocations">
<array>
<value>classpath:cn/bjut/mybatis/**/mapper/*.xml</value>
</array>
</property>
<property name="typeAliasesPackage" value="cn.bjut.mybatis.web.model"/>
</bean>
typeAliasesPackage :配置包中类的别名 ,这个配置不支持 *通配符的路径,当需要配置多个包路径时,可以使用分号或逗号进行分隔。上面配置的 mybatis-config.xml 位于 src/main/resources 目录下 , 配置文件内容如下 。
mybatis-config.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>
<settings>
<setting name="logImpl" value="LOG4J"/>
<setting name="cacheEnabled" value="true"/>
<setting name="mapUnderscoreToCamelCase" value="true"/>
<setting name="aggressiveLazyLoading" value="false"/>
</settings>
</configuration>
3. 配置 MapperScannerConfigurer
这里要介绍的用法是最简单且推荐使用的一种,通过 MapperScannerConfigurer 类: 自动扫描所有的 Mapper 接口,使用时可以直接注入接口 。
在spring配置文件 applicationContext.xml 中配置扫描类,代码如下。
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="addToConfig" value="true"/>
<property name="basePackage" value="cn.bjut.mybatis.**.mapper"/>
</bean>
MapperScannerConfigurer 中常配置以下两个属性 。
- basePackage : 用于配置基本的包路径。可以使用分号或逗号作为分隔符设置多于一个的包路径 。
- annotationClass : 用于过滤被扫描的接口,如果设置了该属性,那么 MyBatis 的接口只有包含该注解才会被扫描进去。
9.4 几个简单实例
在resources目录下添加日志的配置文件:log4j.properties
log4j.rootLogger=DEBUG, stdout log4j.logger.cn.bjut.mybatis=DEBUG log4j.logger.cn.bjut.mybatis.web.mapper=TRACE ### Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
这一小节会通过一整套的代码来演示MyBatis在项目开发中的基本用法,按照自下而上的顺序进行开发。
从Mapper开始,依次开发Service层、Controller层、JSP前端页面。
9.4.1 基本准备
在开始之前需要先准备数据库,表和数据。这一节会新增一个 表(table),然后针对这个表进行增、删、改、查4类操作。
字典表的建表语句和基础数据的SQL如下。
-- ----------------------------
-- Table structure for sys_dict
-- ----------------------------
DROP TABLE IF EXISTS `sys_dict`;
CREATE TABLE `sys_dict` (
`id` bigint(32) NOT NULL AUTO_INCREMENT COMMENT '主键',
`code` varchar(64) NOT NULL COMMENT '类别',
`name` varchar(64) NOT NULL COMMENT '字典名',
`value` varchar(64) NOT NULL COMMENT '字典值',
PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=7 DEFAULT CHARSET=utf8; -- ----------------------------
-- Records of sys_dict
-- ----------------------------
INSERT INTO `sys_dict` VALUES ('', '性别', '男', '男');
INSERT INTO `sys_dict` VALUES ('', '性别', '女', '女');
INSERT INTO `sys_dict` VALUES ('', '季度', '第一季度', '');
INSERT INTO `sys_dict` VALUES ('', '季度', '第二季度', '');
INSERT INTO `sys_dict` VALUES ('', '季度', '第三季度', '');
INSERT INTO `sys_dict` VALUES ('', '季度', '第四季度', '');
在src/main/java 中新建 cn.bjut.mybatis.web.model 包,然后新建 SysDict 实体类。
package cn.bjut.mybatis.web.model; import java.io.Serializable; public class SysDict implements Serializable {
private static final long serialVersionUID = 1L;
private Long id;
private String code;
private String name;
private String value; public Long getId() {
return id;
} public void setId(Long id) {
this.id = id;
} public String getCode() {
return code;
} public void setCode(String code) {
this.code = code;
} public String getName() {
return name;
} public void setName(String name) {
this.name = name;
} public String getValue() {
return value;
} public void setValue(String value) {
this.value = value;
}
}
9.4.2 开发(DAO层)Mapper层
数据访问层(DAO层) 也就是常说的Mapper层。使用Mapper接口和XML映射文件结合的方式进行开发,在9.3节集成MyBatis的配置中,自动扫描接口的包名为 cn.bjut.mybatis.**.mapper ,因此在创建Mapper接口所在的包时也要参照这个命名规则。
在 src/main/java 中新建 cn.bjut.mybatis.web.mapper 包,然后新建 DictMapper接口。
package cn.bjut.mybatis.web.mapper; import cn.bjut.mybatis.web.model.SysDict;
import org.apache.ibatis.session.RowBounds;
import cn.bjut.mybatis.web.model.SysDict; import java.util.List; /**
* @author kangmainfeng
*/
public interface DictMapper { /**
* 根据主键查询
*
* @param id
* @return
*/
SysDict selectByPrimaryKey(Long id); /**
* 条件查询
*
* @param sysDict
* @return
*/
List<SysDict> selectBySysDict(SysDict sysDict, RowBounds rowBounds); /**
* 新增
*
* @param sysDict
* @return
*/
int insert(SysDict sysDict); /**
* 根据主键更新
*
* @param sysDict
* @return
*/
int updateById(SysDict sysDict); /**
* 根据主键删除
*
* @param id
* @return
*/
int deleteById(Long id);
}
同时,9.3节的 SqlSessionFactoryBean 中也配置了扫描XML映射文件的目录
classpath:cn/bjut/mybatis/**/mapper/*.xml
在 src/main/resources 中新建 cn/bjut/mybatis/web/mapper/ 目录,然后新建 DictMapper.xml文件。
此处直接将接口和对应的XML代码同时列出,不再对代码内容做详细的说明。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="cn.bjut.mybatis.web.mapper.DictMapper">
<select id="selectByPrimaryKey" resultType="SysDict">
select id, code, name, `value` from sys_dict where id = #{id}
</select> <select id="selectBySysDict" resultType="tk.mybatis.web.model.SysDict">
select * from sys_dict
<where>
<if test="id != null">
and id = #{id}
</if>
<if test="code != null and code != ''">
and code = #{code}
</if>
</where>
order by code, `value`
</select> <insert id="insert" useGeneratedKeys="true" keyProperty="id">
insert into sys_dict(code, name, value)
values (#{code}, #{name}, #{value})
</insert> <update id="updateById">
update sys_dict
set code = #{code},
name = #{name},
value = #{value}
where id = #{id}
</update> <delete id="deleteById">
delete from sys_dict where id = #{id}
</delete> </mapper>
这5个方法都是很基础的方法,下面(的博客文章)将在这5个接口的method 基础上,继续编写Service层的代码。
================
end