SSM整合及MyBatis-Plus的使用

前言

前面的文章我们已经学习了Spring、Spring MVC和Mybatis，本节我们就来使用他们整合我们的SSM框架的整合运用。

学习内容

什么是SSM？

SSM（Spring+SpringMVC+MyBatis） 框架集由Spring、MyBatis两个开源框架整合而成（SpringMVC是Spring中的部分内容），常作为数据源较简单的web项目的框架。百度百科

SSM整合三阶段

• Spring与Spring MVC环境配置
• Spring与MyBatis的整合配置
• 整合其他组件：声明式事务/日志/任务调度/…

Spring与Spring MVC环境配置

1. pom.xml依赖spring-webmvc

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.five</groupId>
    <artifactId>five-reader</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

<!--    阿里云镜像仓库-->
    <repositories>
        <repository>
            <id>aliyun</id>
            <name>aliyun</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </repository>
    </repositories>
    <dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>
<!--        freemarker-->
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.30</version>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
            <version>5.2.6.RELEASE</version>
        </dependency>

<!--        JSON序列化-->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
            <version>2.11.0</version>
        </dependency>
<!--        数据绑定包-->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.11.0</version>
        </dependency>
<!--        注解包-->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
            <version>2.11.0</version>
        </dependency>
    </dependencies>

</project>

2. web.xml配置DispatcherServlet

<!--2.配置DispatcherServlet-->
<servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext*.xml</param-value>
    </init-param>
    <!-- 启动的时候初始化servlet-->
    <load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

3. 启用Spring MVC注解模式

<!--3.开启SpringMVC注解模式-->
<context:component-scan base-package="com.five"/>
<mvc:annotation-driven/>
<!--排除静态资源-->
<mvc:default-servlet-handler/>

4. web.xml配置请求与响应字符集

<!-- 4.解决中文乱码 -->
<filter>
    <filter-name>characterFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

5. 配置FreeMarker模板引擎(applicationContext.xml)

<!-- 5.配置Freemarker模板引擎 -->
<bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    <property name="templateLoaderPath" value="/WEB-INF/ftl"/>
    <property name="freemarkerSettings">
        <props>
            <!--读取ftl文件时的编码格式-->
            <prop key="defaultEncoding">UTF-8</prop>
        </props>
    </property>
</bean>
<!--视图解析器-->
<bean id="ViewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
    <property name="contentType" value="text/html;charset=utf-8"/>
    <property name="suffix" value=".ftl"/>
</bean>

6. 配置JSON序列化组件(applicationContext.xml)

测试整合结果：

• 编写测试Controller

/**
 1. Description:
 2.  3. @Author: kk(专业bug开发)
 4. DateTime: 2022-02-11 14:17
 */
@Controller
public class TestController {

    @GetMapping("/test/t1")
    public ModelAndView test1(){
        return new ModelAndView("/test");
    }

    @GetMapping("/test/t2")
    @ResponseBody
    public Map test2(){
        Map result = new HashMap();
        result.put("test", "测试文本");
        return result;
    }
}

• 测试截图

Spring与MyBatis的整合配置

1. 依赖mybatis-spring以及驱动

<!--Mybatis整合步骤: 1.引入依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>5.2.6.RELEASE</version>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.4</version>
</dependency>
<!-- MyBatis与Spring整合组件 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>2.0.3</version>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.16</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.14</version>
</dependency>

2. 配置数据源与连接池（applicationContext.xml）

<!-- MyBatis与Spring的整合配置 -->
<!--2.配置数据源-->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
    <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://localhost:3306/imooc_reader?useSSL=false&amp;useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=Asia/Shanghai&amp;allowPublicKeyRetrieval=true"/>
    <property name="username" value="root"/>
    <property name="password" value="root"/>
    <property name="initialSize" value="5"/>
    <property name="maxActive" value="20"/>
</bean>

3. 配置SqlSessionFactory（applicationContext.xml）

<!-- 3. SqlSessionFactoryBean用于根据配置信息创建SqlSessionFactory,不再需要我们自己编码创建 -->
<!-- 原生Mybaits与Spring整合
<bean id="sessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
-->
<bean id="sessionFactory" class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="mapperLocations" value="classpath:mappers/*.xml"/>
    <!-- 5.MyBatis配置文件地址 -->
    <property name="configLocation" value="classpath:mybatis-config.xml"/>
</bean>

4. 配置Mapper扫描器（applicationContext.xml）

<!--4.配置Mapper扫描器 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.five.reader.mapper"/>
</bean>

5. 创建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="mapUnderscoreToCamelCase" value="true"/>
    </settings>

</configuration>

整合其他组件

• 整合JUnit单元测试

1. pom.xml引入依赖

<!-- 单元测试依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>5.2.6.RELEASE</version>
</dependency>

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
</dependency>

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

2. 新建一个测试mapper

3. 新建test.xml的mappers

<?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="com.five.reader.mapper.TestMapper">
    <insert id="insert">
        insert into test(content) values('测试内容')
    </insert>
</mapper>

4. 新建service

@Service
public class TestService {
    @Resource
    private TestMapper testMapper;

    public void batchImport(){
        for (int i = 0; i < 5; i++) {
            testMapper.insert();
        }
    }
}

5. 新建单元测试用例

测试结果：

• 配置logback日志输出

1. pom.xml添加依赖（Spring会自动检测依赖并使用）

<!-- logback日志组件 -->
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.2.3</version>
</dependency>

自定义日志格式的时候可以参考前面的MyBatis部分的日志管理，新建logback.xml即可！！！

<?xml version="1.0" encoding="UTF-8" ?>
<configuration>
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>%d{HH:mm:ss} %-5level [%thread] %logger{30} - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
    </appender>
    <root level="debug">
        <appender-ref ref="console"/>
    </root>
</configuration>

• 声明式事务配置

<!--声明式事务配置-->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="dataSource"/>
</bean>
<tx:annotation-driven transaction-manager="transactionManager"/>

Tip：SSM整合完毕！！！！

---

什么是MyBatis-Plus

• MyBatis-Plus是一个MyBatis的增强工具
• 自动实现Mapper CRUD操作，极致提高数据库开发效率
• MyBatis-Plus在MyBatis的基础上只做增强不做改变

官网地址

MyBatis-Plus整合

• pom.xml引入MyBatis-Plus

<!-- MyBatis-Plus依赖 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus</artifactId>
    <version>3.3.2</version>
</dependency>

• applicationContext.xml更改配置SqlSessionFactory实现类

    <!-- 3. SqlSessionFactoryBean用于根据配置信息创建SqlSessionFactory,不再需要我们自己编码创建 -->
    <!-- 原生Mybaits与Spring整合
<bean id="sessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
-->
    <bean id="sessionFactory" class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="mapperLocations" value="classpath:mappers/*.xml"/>
        <!-- 5.MyBatis配置文件地址 -->
        <property name="configLocation" value="classpath:mybatis-config.xml"/>
    </bean>

• mybatis-config.xml增加MP分页插件

    <plugins>
        <!-- 配置MyBatis-Plus分页插件 -->
        <plugin interceptor="com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor"></plugin>
    </plugins>

MyBatis-Plus使用

1. 创建实体类，@TableName/@TableId/@TableFieId实现映射

注解	说明
@TableName	将实体类与表名映射
@TableId	说明对应属性是表的主键
@TableFieId	设置属性与列名的对应关系

@TableName("test") //用于说明实体对应哪一张表
public class Test {
    @TableId(type = IdType.AUTO)   //用于说明谁是主键
    @TableField("id") //用于说明属性对应哪个字段
    private Integer id;

    @TableField("content") //如果字段名与属性名相同或者符合驼峰命名转换规则,则TableField可省略
    private String content;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }
}

2. 创建Mapper接口继承BaseMapper，创建Mapper XML

public interface TestMapper extends BaseMapper<Test> {
    public void insertSample();
}

3. 开发时注入Mapper对象，通过内置API实现CRUD操作
   
   
   测试结果：
   
   CRUD测试代码：

package com.five.reader;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.five.reader.entity.Test;
import com.five.reader.mapper.TestMapper;
import org.junit.runner.RunWith;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import javax.annotation.Resource;
import java.util.List;

/**
 * Description:
 *
 * @Author: kk(专业bug开发)
 * DateTime: 2022-02-11 17:38
 */

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = {"classpath:applicationContext.xml"})
public class MyBatisPlusTest {
    @Resource
    private TestMapper testMapper;

    //测试MP添加数据
    @org.junit.Test
    public void testInsert(){
        Test test = new Test();   //实体类Test
        test.setContent("MyBatis Plus测试");    //设置实体类的内容
        testMapper.insert(test);
    }

    //测试MP更新数据
    @org.junit.Test
    public void testUpdate(){
        Test test = testMapper.selectById(16);   //MP内置的selectById方法
        test.setContent("MyBatis Plus测试1");
        testMapper.updateById(test);
    }

    //测试MP删除数据
    @org.junit.Test
    public void testDelete(){
        testMapper.deleteById(16);
    }

    //测试MP查询方法
    @org.junit.Test
    public void testSelect(){
        QueryWrapper<Test> queryWrapper = new QueryWrapper<Test>();
        queryWrapper.eq("id", 7);
        queryWrapper.gt("id", 5);
        List<Test> list = testMapper.selectList(queryWrapper);   //传入一个包装对象
        System.out.println(list.get(0));
    }
}

查询的时候queryWrapper参见下面的文档说明！！！！
queryWrapper文档地址

总结

这节课应该是个转折点了，前面我们都是单独的开发学习，现在我们对SSM进行了整合，更引入了高效开发的MyBatis-Plus，这样我们结合前面的知识就可以开始我们的SSM开发了~
如果你发现文章中存在问题，欢迎评论区交流指正~