SSM整合总结

一.核心问题

(一)两个容器

web容器 web相关组件（controller,springmvc核心组件）

root容器业务和持久层相关组件（service,aop,tx,dataSource,mybatis,mapper等）

父容器：root容器，盛放service、mapper、mybatis等相关组件

子容器：web容器，盛放controller、web相关组件

(二)配置类和容器的对应关系

配置类的数量不是固定的，但是至少要两个

建议配置文件：

1.WebJavaConfig controller,springmvc相关 web容器

2.ServiceJavaConfig service,aop,tx相关 root容器

3.MapperJavaConfig mapper,datasource,mybatis相关 root容器

(三)Ioc初始化方法和配置位置

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[] { "/" };}
}

二.实战

(一)导入依赖

数据库准备,准备maven项目并转为web项目略过

pom.xml文件

<?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</groupId>  <artifactId>part04-ssm-integration</artifactId>  <version>1.0-SNAPSHOT</version>  <packaging>war</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>

(二)实体类添加

@Data
public class Employee {private Integer empId;private String empName;private Double empSalary;
}

(三)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.atguigu.mybatis" level="DEBUG" /></configuration>

(四)web容器配置

WebJavaConfig.java

/*** * * 1.实现Springmvc组件声明标准化接口WebMvcConfigurer 提供了各种组件对应的方法* 2.添加配置类注解@Configuration* 3.添加mvc复合功能开关@EnableWebMvc* 4.添加controller层扫描注解* 5.开启默认处理器,支持静态资源处理*/
@Configuration
@EnableWebMvc
@ComponentScan("com.yan.controller")
public class WebJavaConfig implements WebMvcConfigurer {//开启静态资源@Overridepublic void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {configurer.enable(); }
}

(五)业务层配置

主要配置service,注解aop和声明事务相关配置

ServiceJavaConfig.java

/*** * * 1. 声明@Configuration注解,代表配置类* 2. 声明@EnableTransactionManagement注解,开启事务注解支持* 3. 声明@EnableAspectJAutoProxy注解,开启aspect aop注解支持* 4. 声明@ComponentScan("com.atguigu.service")注解,进行业务组件扫描* 5. 声明transactionManager(DataSource dataSource)方法,指定具体的事务管理器*/
@EnableTransactionManagement
@EnableAspectJAutoProxy
@Configuration
@ComponentScan("com.yan.service")
public class ServiceJavaConfig {@Beanpublic DataSourceTransactionManager transactionManager(DataSource dataSource){DataSourceTransactionManager transactionManager = new DataSourceTransactionManager();transactionManager.setDataSource(dataSource);return transactionManager;}}

(六)持久层配置编写

1.思路

mybatis核心api

//1.读取外部配置文件
InputStream ips = Resources.getResourceAsStream("mybatis-config.xml");//2.创建sqlSessionFactory
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(ips);//3.创建sqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
//4.获取mapper代理对象
EmpMapper empMapper = sqlSession.getMapper(EmpMapper.class);
//5.数据库方法调用
int rows = empMapper.deleteEmpById(1);
System.out.println("rows = " + rows);
//6.提交和回滚
sqlSession.commit();
sqlSession.close();

SqlSessionFactoryBuilder:

这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。 无需ioc容器管理！

SqlSessionFactory:

一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，因此 SqlSessionFactory 的最佳作用域是应用作用域。 需要ioc容器管理！

SqlSession:

每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。 无需ioc容器管理！

Mapper映射器实例:

映射器接口的实例是从 SqlSession 中获得的,虽然从技术层面上来讲，任何映射器实例的最大作用域与请求它们的 SqlSession 相同。但方法作用域才是映射器实例的最合适的作用域。映射器实例不应该交给ioc容器管理

但从使用的角度,业务类（service）需要注入mapper接口，所以mapper应该交给ioc容器管理！

综上:

将SqlSessionFactory实例存储到IoC容器

将Mapper实例存储到IoC容器

mybatis提供了提供封装SqlSessionFactory和Mapper实例化的逻辑的FactoryBean组件，我们只需要声明和指定少量的配置即可！

2.配置

a数据库连接信息

resources/jdbc.properties

yan.url=jdbc:mysql:///mybatis-example
yan.driver=com.mysql.cj.jdbc.Driver
yan.username=root
yan.password=root

b. 数据库配置类

当配置类被加载时，Spring容器会首先处理Bean的定义和初始化,其中包括sqlSessionFactoryBean和mapperScannerConfigurer的初始化。在这个过程中，如果@Value注解所在的Bean还没有被完全初始化，可能会导致注入的属性值为null。

@Configuration
@PropertySource("classpath:jdbc.properties")
public class MapperJavaConfig {@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;}/*** 配置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.xx.mapper");return mapperScannerConfigurer;}}

解决方案:

分成两个配置类独立配置，互不影响，数据库提取一个配置类，mybatis提取一个配置类即可解决！


@Configuration
@PropertySource("classpath:jdbc.properties")
public class DataSourceJavaConfig {@Value("${yan.user}")private String user;@Value("${yan.password}")private String password;@Value("${yan.url}")private String url;@Value("${yan.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;}}

c.mapper配置类

不在保留mybatis的外部配置文件（xml）, 所有配置信息（settings、插件、别名等）全部在声明SqlSessionFactoryBean的代码中指定！数据库信息依然使用DruidDataSource实例替代！

全部配置类，避免了XML文件解析效率低问题！

配置连接池

sqlSessionFactoryBean.setDataSource(dataSource);

配置settings

原xml代码

<settings><!-- 开启驼峰式映射--><setting name="mapUnderscoreToCamelCase" value="true"/><!-- 开启logback日志输出--><setting name="logImpl" value="SLF4J"/><!--开启resultMap自动映射 --><setting name="autoMappingBehavior" value="FULL"/></settings>

现在Java代码

 org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration();configuration.setMapUnderscoreToCamelCase(true);//开启驼峰映射configuration.setLogImpl(Slf4jImpl.class);//日志设置configuration.setAutoMappingBehavior(AutoMappingBehavior.FULL);//开启resultMap自动映射sqlSessionFactoryBean.setConfiguration(configuration);

配置实体类别名

原xml代码

 <typeAliases><!-- 给实体类起别名 --><package name="com.atguigu.pojo"/></typeAliases>

现在java代码

  //设置实体类别名sqlSessionFactoryBean.setTypeAliasesPackage("com.yan.pojo");

配置插件

原xml代码

 <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>

现在java代码

     PageInterceptor pageInterceptor = new PageInterceptor();Properties properties = new Properties();properties.setProperty("helperDialect", "mysql");pageInterceptor.setProperties(properties);sqlSessionFactoryBean.addPlugins(pageInterceptor);

mapper配置类总代码

@Configuration
public class MapperJavaConfig {//sqlSessionFactory加入Ioc容器@Beanpublic SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource) {SqlSessionFactoryBean sqlSessionFactoryBean =new SqlSessionFactoryBean();//指定配置文件等信息//指定数据库连接池对象sqlSessionFactoryBean.setDataSource(dataSource);//指定mybaits配置文件的功能,使用代码的形式org.apache.ibatis.session.Configuration configuration = new org.apache.ibatis.session.Configuration();configuration.setMapUnderscoreToCamelCase(true);//开启驼峰映射configuration.setLogImpl(Slf4jImpl.class);//日志设置configuration.setAutoMappingBehavior(AutoMappingBehavior.FULL);//开启resultMap自动映射sqlSessionFactoryBean.setConfiguration(configuration);//设置实体类别名sqlSessionFactoryBean.setTypeAliasesPackage("com.yan.pojo");//插件设置PageInterceptor pageInterceptor = new PageInterceptor();Properties properties = new Properties();properties.setProperty("helperDialect", "mysql");pageInterceptor.setProperties(properties);sqlSessionFactoryBean.addPlugins(pageInterceptor);return sqlSessionFactoryBean;}//mapper代理对象加入ioc@Beanpublic MapperScannerConfigurer mapperScannerConfigurer() {//Mapper代码对象的factoryBean ->指定一个包->mapper接口MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();mapperScannerConfigurer.setBasePackage("com.yan.mapper");//mapper接口和mapperxml所在的共同包return mapperScannerConfigurer;}
}

(七)初始化配置类

public class SpringIocInit extends AbstractAnnotationConfigDispatcherServletInitializer {//rootioc容器的配置类@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[]{MapperJavaConfig.class, ServiceJavaConfig.class, DataSourceJavaConfig.class};}//webioc容器的配置类指定@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{WebMvcJavaConfig.class};}//dispatcherServlet拦截路径@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}
}

(八)测试

1.创建controller类

@RestController
@RequestMapping("emp")
public class EmployeeController {@Autowiredprivate EmployeeService employeeService;@GetMapping("find")public List<Employee> find() {List<Employee> all = employeeService.findAll();return all;}
}

2.service

public interface EmployeeService {public List<Employee> findAll();
}

@Service
public class EmployeeServiceImpl implements EmployeeService {@Autowiredprivate EmployeeMapper employeeMapper;@Overridepublic List<Employee> findAll() {List<Employee> employees = employeeMapper.queryList();System.out.println("emps:"+employees);return  employees;}
}

3.创建mapper接口

mapper接口包：com.atguigu.mapper


public interface EmployeeMapper {//查询全部员工信息List<Employee> queryList();
}

mapper XML 文件位置： resources/mappers

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.yan.mapper.EmployeeMapper"><select id="queryList" resultType="com.yan.pojo.Employee">select *from t_emp;</select>
</mapper>

这个报错不用管,也能运行