MyBatis从入门到精通(第9章):Spring集成MyBatis(中)

时间:2023-03-09 18:27:50
MyBatis从入门到精通(第9章):Spring集成MyBatis(中)

MyBatis从入门到精通(第9章):Spring集成MyBatis(中)

框架(Framework)是整个或部分系统的可重用设计,表现为一组抽象构件及构件实例间交互的方法。
应该将应用自身的设计和具体的实现技术解耦。技术实现是应用的底层支撑,它不应该直接对应用产生影响。

MyBatis从入门到精通(第9章):Spring集成MyBatis(中)

框架一般处在低层应用平台(如 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