SSM整合

SpringMVC的IOC:管理控制层的组件。 Spring的IOC:管理业务层和持久层的组件。

1. ContextLoaderListenr

Spring提供的监视器 ContextLoaderListenr,实现 ServletContextListener 接口,可监听ServletContext的状态,在Web服务器启动,读取Spring的配置文件,创建Spring的IOC容器。web 应用必须在web.xml 中配置。 目的:初始化Spring的IOC容器;在单独使用Spring的时候,容器是我们手动创建和管理,而整合后交给 ContextLoaderListenr 创建和管理。 为什么交给 ContextLoaderListenr:ContextLoadListener 的执行时机先于 DispatcherServlet,因此其初始化的service 和 dao 层的bean 能注入到 SpringMVC的IOC容器中的Controller中。

2. XML 方式整合

先创建一个web工程。 这里使用SSM最终完成一个员工信息的增删改查。

2.1 依赖

各个依赖的详细功能已经写在了下面:

   
javax.servlet-api
spring-webmvc 间接依赖 springioc的四个核心jar包 + spring-web包
jackson-databind springmvc 在异步请求处理JSON数据的时候会使用
thymeleaf-spring5 springmvc + thymeleaf 整合
spring-jdbc 只使用里面的事务支持,其会为我们提供已经编写好的事务管理的切面类
spring-aspects AOP功能的支持
mybatis 持久层框架
pagehelper 为mybatis 提供分页功能的插件
mybatis-spring mybatis 和 spring 的整合包 : 其提供了一个SqlSessionFactoryBean,用于创建SqlSession
druid 德鲁伊连接池,提供数据源
mysql-connector-java MYSQL驱动
spring-test Spring提供的测试功能,可以直接在测试代码中注入容器当中的Bean
log4j (druid/mybatis 选用 日志 (经验证发现 , Druid / mybatis 内部使用 log4j,而且是 provide的间接依赖,可能是检测到有包就用,当你在系统里面依赖 log4j ,不提供log4j的配置文件,则会发生提示 :log4j:WARN No appenders could be found for logger (com.alibaba.druid.pool.DruidDataSource).<br>log4j:WARN Please initialize the log4j system properly.)<br><br>因此:要么就依赖 log4j.jar 且 配置 log4j.properties/log4j.xml 给 Druid 使用,要么就不提供依赖,druid也不会检测到系统有jar包,不会给出 WARN
logback-classic(Spring /thymeleaf 整合包使用 slf4j的日志实现<br>1. thymeleaf 使用了 sl4j 的依赖,因此需要提高 logback 实现,并且配置logback; <br>2. spring-context 会 间接依赖spring.jcl 包判断日志实现的时候会默认为 slfj 的具体实现(发现机制),因此可以配置个 slf4j 的具体实现使用Spring的日志。若系统内部没有 slf4j ,会搜寻 log4j2,还是没有则默认使用 JUL 日志输出。
javax.servlet-api MVC的Controller中可能会使用到Servlet的API
commons-fileupload SpringMVC底层支持文件上传需要jar包
<?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.atguigu.ssm</groupId>
    <artifactId>ssm</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <spring.version>5.3.1</spring.version>
    </properties>

    <dependencies>
        <!-- springmvc依赖 : 比Spring核心IOC 多一个 springweb -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- jackson : POJO <-> JSON -->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.12.1</version>
        </dependency>

        <!-- springmvc + thymeleaf 整合 -->
        <dependency>
            <groupId>org.thymeleaf</groupId>
            <artifactId>thymeleaf-spring5</artifactId>
            <version>3.0.12.RELEASE</version>
        </dependency>

        <!-- 事务支持 : 提供实现好事务切面类 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-jdbc</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- AOP支持 -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-aspects</artifactId>
            <version>${spring.version}</version>
        </dependency>

        <!-- Mybatis 核心 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>

        <!-- mybatis 分页插件 -->
        <dependency>
            <groupId>com.github.pagehelper</groupId>
            <artifactId>pagehelper</artifactId>
            <version>5.2.0</version>
        </dependency>

        <!-- mybatis 和 spring 的整合包 : 其提供了一个SqlSessionFactoryBean,用于创建SqlSession -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>2.0.6</version>
        </dependency>

        <!-- 连接池 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.0.9</version>
        </dependency>

        <!-- mysql 驱动 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.16</version>
        </dependency>

        <!-- 单元测试 + spring-test -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
            <version>${spring.version}</version>
            <scope>test</scope>
        </dependency>

        <!-- log4j 日志 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

        <!-- slf4j 门面 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.36</version>
        </dependency>
        

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

        <!-- servlet API -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
  
        <!-- 文件上传 -->
      <dependency>
          <groupId>commons-fileupload</groupId>
          <artifactId>commons-fileupload</artifactId>
          <version>1.3.1</version>
      </dependency>

    </dependencies>
</project>

2.2 创建表

-- auto-generated definition
create table t_emp
(
    emp_id   int auto_increment
        primary key,
    emp_name varchar(20) null,
    age      int         null,
    gender   char        null,
    email varchar(50)         null
)comment '员工表' auto_increment = 34;

2.3 配置 web.xml

配置四个东西 :1. 核心控制器 DispatcherServlet ; 2. ContextLoaderListener ; 3. 编码过滤器(放过滤器中最前);4. 请发方法处理器 HiddenMethodFilter

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <!-- 配置Spring的编码过滤器 -->
    <filter>
        <filter-name>characterEncodingFilter</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>
        <init-param>
            <param-name>forceEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 请求方式的过滤器 -->
    <filter>
        <filter-name>hiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>hiddenHttpMethodFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 前端控制器 -->
    <servlet>
        <servlet-name>dispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

        <!-- 指定springmvc配置文件位置 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-config.xml</param-value>
        </init-param>

        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 配置Spring监听器:服务器启动的时候加载Spring的配置文件 -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- 配置Spring的配置文件的位置 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring-config.xml</param-value>
    </context-param>
    
</web-app>

2.4 配置SpringMVC

只列出必选项 和 推荐项:

  1. Controller包的扫描 (必选)
  2. thymeleaf 的视图解析器(必选)
  3. 静态资源处理 (必选)
  4. 视图控制器(可选)
  5. 注解驱动(必选) ‼️ 其他需要的功能自行查阅MVC的笔记即可。
<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:util="http://www.springframework.org/schema/util"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
       http://www.springframework.org/schema/util
       https://www.springframework.org/schema/util/spring-util.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 包扫描 -->
    <context:component-scan base-package="com.atguigu.ssm.controller"></context:component-scan>

    
    <!-- 配置 Thymeleaf 视图解析器 配置完毕后可以使用MVC的方式完成视图渲染和跳转了 -->
    <bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/>
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine">
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver">
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">

                        <!-- 视图前缀 -->
                        <property name="prefix" value="/WEB-INF/templates/"/>

                        <!-- 视图后缀 -->
                        <property name="suffix" value=".html"/>

                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8"/>
                    </bean>
                </property>
            </bean>
        </property>
    </bean>

    <!-- 处理静态资源 -->
    <mvc:default-servlet-handler />

    <!-- 开启注解驱动 
         @ControllerAdvice
         @ResponseBody
         @RequestBody
         ....
    -->
    <mvc:annotation-driven />

    <!-- 配置视图控制器 -->
    <mvc:view-controller path="/" view-name="index"></mvc:view-controller>
</beans>

测试:直接访问视图控制器配置的首页看是否正常即可。

2.5 配置Spring

2.5.1 spring-config.xml

名字自取也可以,后面 web.xml 文件是可以修改的。

配置分为三大部分: 一: 1. 包扫描、排除@Controller

:事务相关

  1. 事务管理器
  2. 事务注解驱动

:MyBaits需要的配置:

  1. 引入 jdbc.properties
  2. druid 数据源(需要1)
  3. SqlSessionFactoryBean 注册到IOC(需要2) 4..** 产生的mapper代理类注册到IOC** → 即配置 MapperScannerConfigurer
jdbc.url=jdbc:mysql://192.168.23.128:3306/ssm?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf-8&autoReconnect=true
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.user=root
jdbc.password=123456
<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:util="http://www.springframework.org/schema/util"
       xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
       http://www.springframework.org/schema/util
       https://www.springframework.org/schema/util/spring-util.xsd
       http://www.springframework.org/schema/context
       http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd">

    <!-- 扫描包:排除掉Controller -->
    <context:component-scan base-package="com.atguigu.ssm">
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!-- jdbc.properties -->
    <context:property-placeholder location="classpath:jdbc.properties"></context:property-placeholder>

    <!-- 配置数据源 -->
    <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">

        <!-- 数据库信息 -->
        <property name="driverClassName" value="${jdbc.driver}"></property>
        <property name="url" value="${jdbc.url}"></property>
        <property name="username" value="${jdbc.user}"></property>
        <property name="password" value="${jdbc.password}"></property>

        <!-- 连接池设置 -->
        <property name="initialSize" value="10"></property>
        <property name="maxActive" value="16"></property>  <!-- 连接池最大活跃连接数 -->
    </bean>

    <!-- 注册 事务管理器 : 是个切面类 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">

        <!-- 注入数据源:链接均从数据源当中获取 -->
        <property name="dataSource" ref="dataSource"></property>
    </bean>

    <!-- 开启事务的注解驱动 : 将环绕通知作用到连接点上,即 @Transactional 标记的类 或 方法使用事务管理 -->
    <tx:annotation-driven transaction-manager="transactionManager"/>

    <!-- 配置SQLSessionFactoryBean -->
    <bean class="org.mybatis.spring.SqlSessionFactoryBean">
        <!-- 设置mybatis核心配置文件的路径 : 看后续 mybatis 配置文件 -->
        <property name="configLocation" value="classpath:mybatis-config.xml"></property>

        <!-- 数据源设置成 druid 的 -->
        <property name="dataSource" ref="dataSource"></property>
    </bean>
    
    <!-- 将要的 Mapper 接口的代理类注入到Spring的IOC容器, 如果多个 mapper 目录,使用,号分隔即可 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.atguigu.ssm.mapper"></property>
    </bean>
        
</beans>

2.5.2 整合mybatis 的思路

2.5.3 单元测试 spring-test

测试内容:

  1. 链接是否通常:dataSource 是否能获得 connection。

2.6 配置mybatis

  1. resources/mybatis-config.xml 中编写配置,其中关于数据源的配置交给 2.5 在Spring中进行配置,向SpringIOC容器中注入 SqlSessionFactory 对象。
  1. resources/ 下创建同包的路径的Mapper目录,并编写mapper.xml
  2. 配置分页插件
<?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"/>

        <!-- 开启二级缓存 -->
        <setting name="lazyLoadingEnabled" value="true"/>
        <setting name="aggressiveLazyLoading" value="false"/>
        
        
        <!-- 开启日志输出 :根据 2.7, 2.8 自行选择想要的日志 -->
<!--        <setting name="logImpl" value="STDOUT_LOGGING"/>-->  <!-- JUL 输出 -->
<!--        <setting name="logImpl" value="LOG4J"/>-->  <!-- log4j 输出 -->
        <setting name="logImpl" value="SLF4J"/>
    </settings>
    
    <typeAliases>
        <package name="com.atguigu.ssm.pojo"/>
    </typeAliases>
    
    <plugins>
        <!-- 设置分页插件 -->
        <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
    </plugins>
</configuration>

2.7 log4j日志文件(druid/mybatis)

非必须,但还是配下好。 在 resources/ 下编写 log4j.xml,创建就能生效了。

‼️ mybatis 的日志也可以换成如 slf4j,如果使用直接看2.8即可啦,2.7 跳过即可。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">

    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[log4j-output]%-5d %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n"/>
        </layout>
    </appender>

    <logger name="java.sql">
        <level value="debug"/>
    </logger>
    <logger name="org.apache.ibatis" >
        <level value="info"/>
    </logger>

    <!-- 默认配置,级别为debug 且根据name为log.console和 log.file两个appender输出-->
    <root>
        <level value="debug"/>
        <appender-ref ref="STDOUT"/>
    </root>
</log4j:configuration>

2.8 lockback 日志(Spring/mybatis)

非必须,不配置的话会使用的默认的日志输出(JUL)

在 main/resources/ 下编写 logback.xml(固定名字) 在 test/resources/ 下编写 logback-test.xml(固定名字,单元测试会用)

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration>
<configuration debug="true">
    <!-- 指定日志的输出位置 -->
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!-- 日志的输出格式 -->
            <!-- 按照顺序分别是: 时间、日志级别、线程名称、打印日志的类、日志的主体内容、换行 -->
            <pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n</pattern>
        </encoder>
    </appender>

    <!-- 根据特殊需求指定局部的日志级别 : SQL 语句是 info 级别 -->
    <logger name="com.atguigu.crowd.mapper">
        <level value="DEBUG"/>
    </logger>

    <!-- 设置全局的日志级别。日志级别分别是 : DEBUG、INFO、WARN、ERROR -->
    <!-- 指定任何一个日志级别都只打印当前级别和后面级别的日志 -->
    <root level="error">
        <!-- 指定打印日志的appender,这里通过 STDOUT 引用了前面配置的 appender -->
        <appender-ref ref="stdout"/>
    </root>
</configuration>

2.8 功能

只简单实现两个功能即可。

     
功能 RESTful API 数据
分页查询员工信息 /employee/page/1 employee/page/{页码}
根据id查询某个员工信息 /employee/1  

EmployeeController

package com.atguigu.ssm.controller;

import com.atguigu.ssm.pojo.Employee;
import com.atguigu.ssm.service.EmployeeService;
import com.github.pagehelper.PageInfo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.stereotype.Service;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

@RestController
@RequestMapping("/employee")
public class EmployeeController {

    @Autowired
    private EmployeeService employeeService;

    @RequestMapping(value = "/page/{pageNumber}", method = RequestMethod.GET)
    public PageInfo<Employee> getAllEmployeeByPage(@PathVariable(value = "pageNumber", required = false) Integer page) {
        if(null == page)
            page = 1;
        return employeeService.getEmployeesByPage(page);
    }

    @RequestMapping(value = "/{id}", method = RequestMethod.GET)
    public Employee getEmployeeById(@PathVariable(value = "id") String empId) {
        return employeeService.getEmployeeById(empId);
    }
}

EmployeeServiceImpl

package com.atguigu.ssm.service.impl;

import com.atguigu.ssm.mapper.EmployeeMapper;
import com.atguigu.ssm.pojo.Employee;
import com.atguigu.ssm.service.EmployeeService;
import com.github.pagehelper.Page;
import com.github.pagehelper.PageHelper;
import com.github.pagehelper.PageInfo;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class EmployeeServiceImpl implements EmployeeService {

    @Autowired
    private EmployeeMapper employeeMapper;

    @Override
    public PageInfo<Employee> getEmployeesByPage(Integer page) {

        PageHelper.startPage(page, 5);
        List<Employee> list = employeeMapper.getAll();
        return new PageInfo<Employee>(list, page);
    }

    @Override
    public Employee getEmployeeById(String empId) {
        return employeeMapper.getById(empId);
    }
}

EmployeeMapper.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="com.atguigu.ssm.mapper.EmployeeMapper">

    <!-- List<Employee> getAll(); 下划线不用处理,小驼峰配置已经开启-->
    <select id="getAll" resultType="employee">
        SELECT emp_id, emp_name, age, gender, email FROM t_emp
    </select>

    <!-- void getById(String empId); -->
    <select id="getById" resultType="employee">
        SELECT emp_id, emp_name, age, gender, email FROM t_emp WHERE emp_id = #{empId}
    </select>
</mapper>

项目整体目录结构

2.9 创建新项目修改点(注意)

使用上述方式快速搭建SSM环境的时候,需要注意扫描包路径、别名路径等都需要改,自行根据下方列出的地方进行检查。

  1. MyBatis :别名包路径。
  2. Spring:包扫描路径(注意排除 Controller)、MapperScannerConfigurer中指定Mapper的扫描路径。
  3. SpringMVC:Controller包扫描、视图解析器的prefix。

2.10 关系总结

posted @ 2022-10-17 11:08  莫扎特03  阅读(29)  评论(0编辑  收藏  举报