文章目录
- SSM整合是什么?
- SSM整合核心问题
- 第一问:SSM整合需要几个IoC容器?
- 第二问:每个IoC容器对应哪些类型组件?
- 第三问:IoC容器之间关系和调用方向?
- 第四问:具体多少配置类以及对应容器关系?
- 第五问:IoC初始化方式和配置位置?
- SSM整合配置实战 :
- 一、依赖整合和添加
- 1.1 数据库
- 1.2 准备项目
- 1.3 依赖导入
- 1.4 实体类
- 1.5 logback配置
- 二、控制层配置编写(SpringMVC整合)
- 三、业务层配置编写(AOP / TX整合)
- 四、持久层配置编写(MyBatis整合)
- 五、容器初始化配置类
- 六、整合测试
- 总结
- 父子容器 相关源码:
- 父子容器 调用流程图解:
- Maven设置:
- mybatis配置 保留xml的方式
SSM整合是什么?
- SpringMVC框架负责控制层
- Spring 框架负责整体和业务层的声明式事务管理
- MyBatis框架负责数据库访问层
Spring接管一切(将框架核心组件交给Spring进行IoC管理):
- SpringMVC管理表述层、SpringMVC相关组件
- Spring管理业务层、持久层、以及数据库相关(DataSource,MyBatis)的组件
- 使用IoC的方式管理一切所需组件
总结:通过编写配置文件,实现SpringIoC容器接管一切组件。
Github - SSM整合 纯净版 项目:ssm-integration-part
SSM整合核心问题
第一问:SSM整合需要几个IoC容器?
两个容器
本质上说,整合就是将三层架构和框架核心API组件交给Spring IoC容器管理!
常见的操作是创建两个IoC容器(web容器和root容器),组件分类管理。
第二问:每个IoC容器对应哪些类型组件?
容器名 | 盛放组件 |
---|---|
web容器 | web相关组件(controller,springmvc核心组件) |
root容器 | 业务和持久层相关组件(service,aop,tx,dataSource,mybatis,mapper等) |
第三问:IoC容器之间关系和调用方向?
情况1:两个无关联IoC容器之间的组件无法注入!
情况2:子IoC容器可以单向的注入父IoC容器的组件!
结论:web容器是root容器的子容器,父子容器关系。
- 父容器:root容器,盛放service、mapper、mybatis等相关组件
- 子容器:web容器,盛放controller、web相关组件
第四问:具体多少配置类以及对应容器关系?
配置类的数量不是固定的。
我们可以三层架构每层对应一个配置类,分别指定两个容器加载即可。
建议配置文件:
配置名 | 对应内容 | 对应容器 |
---|---|---|
WebJavaConfig | controller,springmvc相关 | web容器 |
ServiceJavaConfig | service,aop,tx相关 | root容器 |
MapperJavaConfig | mapper,datasource,mybatis相关 | root容器 |
第五问:IoC初始化方式和配置位置?
在web项目下,我们可以选择web.xml和配置类方式进行ioc配置,推荐配置类。
对于使用基于 web 的 Spring 配置的应用程序:
public class MyWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {//指定root容器对应的配置类//root容器的配置类@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class<?>[] { ServiceJavaConfig.class,MapperJavaConfig.class };}//指定web容器对应的配置类 webioc容器的配置类@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class<?>[] { WebJavaConfig.class };}//指定dispatcherServlet处理路径,通常为 / @Overrideprotected String[] getServletMappings() {return new String[] { "/" };}
}
图解配置类和容器配置:
SSM整合配置实战 :
一、依赖整合和添加
1.1 数据库
沿用mybatis数据库测试脚本:
CREATE DATABASE `mybatis-example`;USE `mybatis-example`;CREATE TABLE `t_emp`(emp_id INT AUTO_INCREMENT,emp_name CHAR(100),emp_salary DOUBLE(10,5),PRIMARY KEY(emp_id)
);INSERT INTO `t_emp`(emp_name,emp_salary) VALUES("tom",200.33);
INSERT INTO `t_emp`(emp_name,emp_salary) VALUES("jerry",666.66);
INSERT INTO `t_emp`(emp_name,emp_salary) VALUES("andy",777.77);
1.2 准备项目
项目:
ssm-integration-part
模块:
转为web
ssm-integration-01
1.3 依赖导入
<?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.wake</groupId><artifactId>ssm-integration-part</artifactId><version>1.0-SNAPSHOT</version><packaging>pom</packaging><properties><spring.version>6.0.6</spring.version><jakarta.annotation-api.version>2.1.1</jakarta.annotation-api.version><jakarta.jakartaee-web-api.version>9.1.0</jakarta.jakartaee-web-api.version><jackson-databind.version>2.15.0</jackson-databind.version><hibernate-validator.version>8.0.0.Final</hibernate-validator.version><mybatis.version>3.5.11</mybatis.version><mysql.version>8.0.25</mysql.version><pagehelper.version>5.1.11</pagehelper.version><druid.version>1.2.8</druid.version><mybatis-spring.version>3.0.2</mybatis-spring.version><jakarta.servlet.jsp.jstl-api.version>3.0.0</jakarta.servlet.jsp.jstl-api.version><logback.version>1.2.3</logback.version><lombok.version>1.18.26</lombok.version><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties><!--需要依赖清单分析:springioc/dispring-context / 6.0.6jakarta.annotation-api / 2.1.1 jsr250aopspring-aspects / 6.0.6txspring-tx / 6.0.6spring-jdbc / 6.0.6springmvcspring-webmvc 6.0.6jakarta.jakartaee-web-api 9.1.0jackson-databind 2.15.0hibernate-validator / hibernate-validator-annotation-processor 8.0.0.Finalmybatismybatis / 3.5.11mysql / 8.0.25pagehelper / 5.1.11整合需要加载spring容器 spring-web / 6.0.6整合mybatis mybatis-spring x x数据库连接池 druid / xlombok lombok / 1.18.26logback logback/ 1.2.3--><dependencies><!--spring pom.xml依赖--><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>${spring.version}</version></dependency><dependency><groupId>jakarta.annotation</groupId><artifactId>jakarta.annotation-api</artifactId><version>${jakarta.annotation-api.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-aop</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-aspects</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-tx</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>${spring.version}</version></dependency><!--springmvcspring-webmvc 6.0.6jakarta.jakartaee-web-api 9.1.0jackson-databind 2.15.0hibernate-validator / hibernate-validator-annotation-processor 8.0.0.Final--><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>${spring.version}</version></dependency><dependency><groupId>jakarta.platform</groupId><artifactId>jakarta.jakartaee-web-api</artifactId><version>${jakarta.jakartaee-web-api.version}</version><scope>provided</scope></dependency><!-- jsp需要依赖! jstl--><dependency><groupId>jakarta.servlet.jsp.jstl</groupId><artifactId>jakarta.servlet.jsp.jstl-api</artifactId><version>${jakarta.servlet.jsp.jstl-api.version}</version></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>${jackson-databind.version}</version></dependency><!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator --><dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator</artifactId><version>${hibernate-validator.version}</version></dependency><!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator-annotation-processor --><dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator-annotation-processor</artifactId><version>${hibernate-validator.version}</version></dependency><!--mybatismybatis / 3.5.11mysql / 8.0.25pagehelper / 5.1.11--><!-- mybatis依赖 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>${mybatis.version}</version></dependency><!-- MySQL驱动 mybatis底层依赖jdbc驱动实现,本次不需要导入连接池,mybatis自带! --><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>${mysql.version}</version></dependency><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>${pagehelper.version}</version></dependency><!-- 整合第三方特殊依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>${spring.version}</version></dependency><dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>${mybatis-spring.version}</version></dependency><!-- 日志 , 会自动传递slf4j门面--><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>${logback.version}</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombok.version}</version></dependency><dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>${druid.version}</version></dependency></dependencies></project>
1.4 实体类
com.wake.pojo
@Data
public class Employee {private Integer empId;private String empName;private Double empSalary;
}
1.5 logback配置
resources/logback.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true"><!-- 指定日志输出的位置,ConsoleAppender表示输出到控制台 --><appender name="STDOUT"class="ch.qos.logback.core.ConsoleAppender"><encoder><!-- 日志输出的格式 --><!-- 按照顺序分别是:时间、日志级别、线程名称、打印日志的类、日志主体内容、换行 --><pattern>[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n</pattern><charset>UTF-8</charset></encoder></appender><!-- 设置全局日志级别。日志级别按顺序分别是:TRACE、DEBUG、INFO、WARN、ERROR --><!-- 指定任何一个日志级别都只打印当前级别和后面级别的日志。 --><root level="DEBUG"><!-- 指定打印日志的appender,这里通过“STDOUT”引用了前面配置的appender --><appender-ref ref="STDOUT" /></root><!-- 根据特殊需求指定局部日志级别,可也是包名或全类名。 --><logger name="com.wake.mybatis" level="DEBUG" /></configuration>
日志相关的配置xml
二、控制层配置编写(SpringMVC整合)
controller,springmvc相关组件配置
- com.wake.config.WebMvcJavaConfig.java
/*** @Description: springmvc 针对控制层controller的配置* 1. controller* 2. 全局异常处理器* 3. handlerMapper handlerAdapter* 4. 静态资源处理* 5. jsp 视图解析器前后缀* 6. json转换器* 7. 拦截器...*/
@EnableWebMvc
@Configuration
@ComponentScan({"com.wake.controller","com.wake.exception"})
public class WebMvcJavaConfig implements WebMvcConfigurer {/*** 开启静态资源处理* @param configurer*/@Overridepublic void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {configurer.enable();}/*** 拦截器* @param registry*/@Overridepublic void addInterceptors(InterceptorRegistry registry) {}/*** 前端资源加载* @param registry*/@Overridepublic void configureViewResolvers(ViewResolverRegistry registry) {registry.jsp("/WEB-INF/views/",".jsp");}
}
三、业务层配置编写(AOP / TX整合)
service,注解aop和声明事务相关配置
- com.wake.config.ServiceJavaConfig.java
/*** @Description: 业务层配置类 service、AOP、tx* 1. service* 2. 开启AOP注解的支持 aspect : @Before @After @AfterReturning @AfterThrowing @Around @Aspect @Order* 3. tx 声明式事务管理 : 1. 对应的事务管理器实现[TransactionManager DataSource ...] 2. 开启事务注解支持 @Transactional*/
@Configuration
@EnableAspectJAutoProxy //aop注解支持
@EnableTransactionManagement // tx注解支持
@ComponentScan("com.wake.service")
public class ServiceJavaConfig {@Beanpublic TransactionManager transactionManager(DataSource dataSource){DataSourceTransactionManager dataSourceTransactionManager = new DataSourceTransactionManager();dataSourceTransactionManager.setDataSource(dataSource);return dataSourceTransactionManager;}
}
四、持久层配置编写(MyBatis整合)
mapper代理对象,连接池和mybatis核心组件配置。
不在保留mybatis的外部配置文件(xml), 所有配置信息(settings、插件、别名等)全部在声明SqlSessionFactoryBean的代码中指定!数据库信息依然使用DruidDataSource实例替代!
纯JAVA代码配置类方式:
- resources/jdbc.properties
jdbc.user=root
jdbc.password=root
jdbc.url=jdbc:mysql:///mybatis-example
jdbc.driver=com.mysql.cj.jdbc.Driver
- com.wake.config.DataSourceJavaConfig
- 数据库配置类
package com.wake.config;import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;import javax.sql.DataSource;@Configuration
@PropertySource("classpath:jdbc.properties")
public class DataSourceJavaConfig {@Value("${jdbc.user}")private String user;@Value("${jdbc.password}")private String password;@Value("${jdbc.url}")private String url;@Value("${jdbc.driver}")private String driver;//数据库连接池配置@Beanpublic DataSource dataSource(){DruidDataSource dataSource = new DruidDataSource();dataSource.setUsername(user);dataSource.setPassword(password);dataSource.setUrl(url);dataSource.setDriverClassName(driver);return dataSource;}}
- com.wake.config.MapperJavaConfig
- mybatis 配置类
package com.wake.config;import com.github.pagehelper.PageInterceptor;
import org.apache.ibatis.logging.slf4j.Slf4jImpl;
import org.apache.ibatis.session.AutoMappingBehavior;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.mapper.MapperScannerConfigurer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;import javax.sql.DataSource;
import java.util.Properties;/*** @Description: 持久层dao 配置类:连接池,sqlSessionFactory,Mapper代理对象* 不保留外部配置文件(mybatis-config.xml),全部的mybatis的属性,使用纯JAVA代码配置。*/
@Configuration
public class MapperJavaConfig {/*** 配置SqlSessionFactoryBean,指定连接池对象和外部配置文件即可* @param dataSource 需要注入连接池对象* @return 工厂Bean*/@Beanpublic SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource){//实例化SqlSessionFactory工厂SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();//设置连接池sqlSessionFactoryBean.setDataSource(dataSource);//替代xml文件的java配置//settings [包裹到一个configuration对象,切记别倒错包]org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration();//开启属性驼峰式映射configuration.setMapUnderscoreToCamelCase(true);//日志configuration.setLogImpl(Slf4jImpl.class);//开启resultMap自动映射configuration.setAutoMappingBehavior(AutoMappingBehavior.FULL);sqlSessionFactoryBean.setConfiguration(configuration);//typeAliasessqlSessionFactoryBean.setTypeAliasesPackage("com.wake.pojo");//分页插件配置PageInterceptor pageInterceptor = new PageInterceptor();Properties properties = new Properties();properties.setProperty("helperDialect","mysql");pageInterceptor.setProperties(properties);sqlSessionFactoryBean.addPlugins(pageInterceptor);return sqlSessionFactoryBean;}/*** 配置Mapper实例扫描工厂,配置 <mapper <package 对应接口和mapperxml文件所在的包* @return*/@Beanpublic MapperScannerConfigurer mapperScannerConfigurer(){MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();//设置mapper接口和xml文件所在的共同包mapperScannerConfigurer.setBasePackage("com.wake.mapper");return mapperScannerConfigurer;}
}
五、容器初始化配置类
ioc 容器:web容器与root容器
- com.wake.config.SpringIoCInit.java
/*** @Description: ioc容器 初始化*/
public class SpringIoCInit extends AbstractAnnotationConfigDispatcherServletInitializer {//指定root容器对应的配置类@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class<?>[]{MapperJavaConfig.class, ServiceJavaConfig.class, DataSourceJavaConfig.class};}//指定web容器对应的配置类@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class<?>[]{WebMvcJavaConfig.class};}//指定dispatcherServlet处理路径,通常为 /@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}
}
六、整合测试
- 需求:
查询所有员工信息,返回对应json数据! - controller :
/*** @Description:*/
@Slf4j
@RestController
@RequestMapping("emp")
public class EmployeeController {@Autowiredprivate EmployeeService employeeService;@GetMapping("find")public List<Employee> find(){List<Employee> employeeList = employeeService.queryAll();System.out.println(employeeList);return employeeList;}
}
- service
public interface EmployeeService {/*** 查询显示所有员工信息* @return*/List<Employee> queryAll();
}
/*** @Description: service业务层实现*/
@Service
public class EmployeeServiceImpl implements EmployeeService {@Autowiredprivate EmployeeMapper employeeMapper;@Overridepublic List<Employee> queryAll() {List<Employee> employeeList = employeeMapper.queryList();return employeeList;}
}
- Mapper
- mapper接口 包:com.wake.mapper
/*** @Description: 员工表CRUD*/
public interface EmployeeMapper {/*** 查询全部员工信息* @return*/List<Employee> queryList();
}
- mapper XML 文件位置: resources/mappers
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace等于mapper接口类的全限定名,这样实现对应 -->
<mapper namespace="com.wake.mapper.EmployeeMapper"><select id="queryList" resultType="employee">
<!-- select emp_id empId,emp_name empName, emp_salary empSalary from t_emp;-->select * from t_emp;</select></mapper>
- 结果:
总结
父子容器 相关源码:
FrameworkServlet 655行!
protected WebApplicationContext createWebApplicationContext(@Nullable ApplicationContext parent) {Class<?> contextClass = getContextClass();if (!ConfigurableWebApplicationContext.class.isAssignableFrom(contextClass)) {throw new ApplicationContextException("Fatal initialization error in servlet with name '" + getServletName() +"': custom WebApplicationContext class [" + contextClass.getName() +"] is not of type ConfigurableWebApplicationContext");}ConfigurableWebApplicationContext wac =(ConfigurableWebApplicationContext) BeanUtils.instantiateClass(contextClass);wac.setEnvironment(getEnvironment());//wac 就是web ioc容器//parent 就是root ioc容器//web容器设置root容器为父容器,所以web容器可以引用root容器wac.setParent(parent);String configLocation = getContextConfigLocation();if (configLocation != null) {wac.setConfigLocation(configLocation);}configureAndRefreshWebApplicationContext(wac);return wac;}
父子容器 调用流程图解:
Maven设置:
mybatis配置 保留xml的方式
依然保留mybatis的外部配置文件(xml), 但是数据库连接信息交给Druid连接池配置!
- mybatis-config.xml
- mybatis配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><settings><!-- 开启驼峰式映射--><setting name="mapUnderscoreToCamelCase" value="true"/><!-- 开启logback日志输出--><setting name="logImpl" value="SLF4J"/><!--开启resultMap自动映射 --><setting name="autoMappingBehavior" value="FULL"/></settings><typeAliases><!-- 给实体类起别名 --><package name="com.wake.pojo"/></typeAliases><plugins><plugin interceptor="com.github.pagehelper.PageInterceptor"><!--helperDialect:分页插件会自动检测当前的数据库链接,自动选择合适的分页方式。你可以配置helperDialect属性来指定分页插件使用哪种方言。配置时,可以使用下面的缩写值:oracle,mysql,mariadb,sqlite,hsqldb,postgresql,db2,sqlserver,informix,h2,sqlserver2012,derby(完整内容看 PageAutoDialect) 特别注意:使用 SqlServer2012 数据库时,https://github.com/pagehelper/Mybatis-PageHelper/blob/master/wikis/zh/HowToUse.md#%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%E5%BA%93%E6%96%B9%E8%A8%80--><property name="helperDialect" value="mysql"/></plugin></plugins>
</configuration>
- mybatis和持久层配置类
- 持久层Mapper配置、数据库配置、Mybatis配置信息
@Configuration
public class MapperJavaConfig {/*** 配置SqlSessionFactoryBean,指定连接池对象和外部配置文件即可* @param dataSource 需要注入连接池对象* @return 工厂Bean*/@Beanpublic SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource){//实例化SqlSessionFactory工厂SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();//设置连接池sqlSessionFactoryBean.setDataSource(dataSource);//设置配置文件//包裹外部配置文件地址对象Resource resource = new ClassPathResource("mybatis-config.xml");sqlSessionFactoryBean.setConfigLocation(resource);return sqlSessionFactoryBean;}/*** 配置Mapper实例扫描工厂,配置 <mapper <package 对应接口和mapperxml文件所在的包* @return*/@Beanpublic MapperScannerConfigurer mapperScannerConfigurer(){MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();//设置mapper接口和xml文件所在的共同包mapperScannerConfigurer.setBasePackage("com.wake.mapper");return mapperScannerConfigurer;}}
- 数据库配置类(DataSourceJavaConfig.java)
@Configuration
@PropertySource("classpath:jdbc.properties")
public class DataSourceJavaConfig {@Value("${jdbc.user}")private String user;@Value("${jdbc.password}")private String password;@Value("${jdbc.url}")private String url;@Value("${jdbc.driver}")private String driver;//数据库连接池配置@Beanpublic DataSource dataSource(){DruidDataSource dataSource = new DruidDataSource();dataSource.setUsername(user);dataSource.setPassword(password);dataSource.setUrl(url);dataSource.setDriverClassName(driver);return dataSource;}}