SSM整合

2026/9/21 4:34:30 拓冰建站浏览量

SSM（Spring + Spring MVC + MyBatis）是Java Web开发中常用的三大框架，它们分别负责业务逻辑处理、Web层处理和数据持久层处理。本文将介绍如何整合这三个框架，以便在项目中使用。

环境要求

环境：

IDEA
MySQL 5.7
Tomcat 9.0
Maven 3.6

数据库环境

创建一个存放用户数据的数据库表

USE `SSM`;
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (`id` int(11) NOT NULL AUTO_INCREMENT COMMENT '用户ID',`username` varchar(50) DEFAULT NULL COMMENT '用户名',`age` int(11) DEFAULT NULL COMMENT '用户年龄',`address` varchar(50) DEFAULT NULL COMMENT '用户住址',PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8INSERT  INTO `user`(`id`,`username`,`age`,`address`) VALUES (1,'奇遇少年',19,'长沙'),(2,'奇遇少女',18,'长沙');

	Field	Type	Comment
主键	id	int(11) NOT NULL	用户ID
	username	varchar(50) NULL	用户名
	age	int(11) NULL	用户年龄
	address	varchar(50) NULL	用户住址

基本环境搭建

在项目的pom.xml文件中添加以下依赖：

 <dependencies><!--Spring-context--><dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>5.1.9.RELEASE</version></dependency><!--AOP相关依赖--><dependency><groupId>org.aspectj</groupId><artifactId>aspectjweaver</artifactId><version>1.8.13</version></dependency><!-- spring-jdbc --><dependency><groupId>org.springframework</groupId><artifactId>spring-jdbc</artifactId><version>5.1.9.RELEASE</version></dependency><!-- mybatis整合到Spring的整合包 --><dependency><groupId>org.mybatis</groupId><artifactId>mybatis-spring</artifactId><version>2.0.4</version></dependency><!--mybatis依赖--><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.4</version></dependency><!--log4j依赖，打印mybatis日志--><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.17</version></dependency><!--分页查询，pagehelper--><dependency><groupId>com.github.pagehelper</groupId><artifactId>pagehelper</artifactId><version>4.0.0</version></dependency><!--mysql驱动--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.47</version></dependency><!-- druid数据源 --><dependency><groupId>com.alibaba</groupId><artifactId>druid</artifactId><version>1.1.16</version></dependency><!-- junit --><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version></dependency><!-- spring整合junit的依赖 --><dependency><groupId>org.springframework</groupId><artifactId>spring-test</artifactId><version>5.1.9.RELEASE</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.12</version><scope>provided</scope></dependency><!-- servlet依赖 --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>3.1.0</version><scope>provided</scope></dependency><!--jsp依赖 --><dependency><groupId>javax.servlet.jsp</groupId><artifactId>jsp-api</artifactId><version>2.1</version><scope>provided</scope></dependency><!--springmvc的依赖--><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.1.9.RELEASE</version></dependency><!-- jackson，帮助进行json转换--><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.9.0</version></dependency><!--commons文件上传，如果需要文件上传功能，需要添加本依赖--><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version></dependency></dependencies>

Maven资源过滤设置

<build><resources><resource><directory>src/main/java</directory><includes><include>**/*.properties</include><include>**/*.xml</include></includes><filtering>false</filtering></resource><resource><directory>src/main/resources</directory><includes><include>**/*.properties</include><include>**/*.xml</include></includes><filtering>false</filtering></resource></resources>
</build>

整合Spring和Mybatis

在resources目录下创建Spring核心配置文件： applicationContext.xml 内容如下

<?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:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"xmlns:aop="http://www.springframework.org/schema/aop"xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/aop https://www.springframework.org/schema/aop/spring-aop.xsd"><!--组件扫描，排除controller--><context:component-scan base-package="com.yu"><context:exclude-filter type="annotation"expression="org.springframework.stereotype.Controller"></context:exclude-filter></context:component-scan><!--读取properties文件--><context:property-placeholder location="classpath:jdbc.properties"></context:property-placeholder><!--创建连接池注入容器--><bean class="com.alibaba.druid.pool.DruidDataSource" id="dataSource"><property name="url" value="${jdbc.url}"></property><property name="username" value="${jdbc.username}"></property><property name="password" value="${jdbc.password}"></property><property name="driverClassName" value="${jdbc.driver}"></property></bean><!--spring整合mybatis后控制的创建获取SqlSessionFactory的对象--><bean class="org.mybatis.spring.SqlSessionFactoryBean" id="sessionFactory"><!--配置连接池--><property name="dataSource" ref="dataSource"></property><!--配置mybatis配置文件的路径--><property name="configLocation" value="classpath:mybatis-config.xml"></property></bean><!--mapper扫描配置，扫描到的mapper对象会被注入Spring容器中--><bean class="org.mybatis.spring.mapper.MapperScannerConfigurer" id="mapperScannerConfigurer"><property name="basePackage" value="com.yu.dao"></property></bean><!--开启aop注解支持--><aop:aspectj-autoproxy></aop:aspectj-autoproxy><!--声明式事务相关配置--><bean class="org.springframework.jdbc.datasource.DataSourceTransactionManager" id="transactionManager"><property name="dataSource" ref="dataSource"></property></bean><tx:annotation-driven transaction-manager="transactionManager"></tx:annotation-driven></beans>

在resources目录下创建jdbc.properties 文件，内容如下：

jdbc.url=jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
jdbc.driver=com.mysql.jdbc.Driver
jdbc.username=root
jdbc.password=root

在resources目录下创建mybatis-config.xml ，内容如下：

<?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><!--指定使用log4j打印Mybatis日志--><setting name="logImpl" value="LOG4J"/></settings><!--配置别名包--><typeAliases><package name="com.yu.pojjo"></package></typeAliases><plugins><!-- 注意：分页助手的插件，配置在通用mapper之前 --><plugin interceptor="com.github.pagehelper.PageHelper"><!-- 指定方言 --><property name="dialect" value="mysql"/></plugin></plugins>
</configuration>

在resources目录下创建log4j.properties ，内容如下：

# 控制台输出器配置
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n# 文件输出器配置
log4j.appender.file=org.apache.log4j.FileAppender
log4j.appender.file.File=src/main/resources/mylog.log
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n# 根日志记录器配置，级别为debug，并将日志信息同时输出到控制台和文件
log4j.rootLogger=debug, stdout

SpringMVC引入

在resources目录下创建spring-mvc.xml ，内容如下：

<?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: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.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd"><!--SpringMVC只扫描controller包即可--><context:component-scan base-package="com.yu.controller"/><!-- 解决静态资源访问问题，如果不加mvc:annotation-driven会导致无法访问handler--><mvc:default-servlet-handler/><!--解决响应乱码--><mvc:annotation-driven><mvc:message-converters><bean class="org.springframework.http.converter.StringHttpMessageConverter"><constructor-arg value="utf-8"/></bean></mvc:message-converters></mvc:annotation-driven><!--配置视图解析器  前后端不分离项目使用--><!--    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="viewResolver">&lt;!&ndash;要求拼接的前缀&ndash;&gt;<property name="prefix" value="/WEB-INF/page/"></property>&lt;!&ndash;要拼接的后缀&ndash;&gt;<property name="suffix" value=".jsp"></property></bean>--><!--配置拦截器--><!--    <mvc:interceptors><mvc:interceptor>&lt;!&ndash;&ndash;&gt;<mvc:mapping path="/**"/>&lt;!&ndash;配置排除拦截的路径&ndash;&gt;<mvc:exclude-mapping path="/"/>&lt;!&ndash;配置拦截器对象注入容器&ndash;&gt;<bean class=""></bean></mvc:interceptor></mvc:interceptors>--><!--文件上传解析器注意：id 必须为 multipartResolver如果需要上传文件时可以放开相应配置--><!--<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">--><!--&lt;!&ndash; 设置默认字符编码 &ndash;&gt;--><!--<property name="defaultEncoding" value="utf-8"/>--><!--&lt;!&ndash; 一次请求上传的文件的总大小的最大值，单位是字节&ndash;&gt;--><!--<property name="maxUploadSize" value="#{1024*1024*100}"/>--><!--&lt;!&ndash; 每个上传文件大小的最大值，单位是字节&ndash;&gt;--><!--<property name="maxUploadSizePerFile" value="#{1024*1024*50}"/>--><!--</bean>-->
</beans>

添加web支持

第一步

第二步

查看

修改web.xml文件

 <servlet><servlet-name>DispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!--为DispatcherServlet提供初始化参数的设置springmvc配置文件的路径name是固定的，必须是contextConfigLocationvalue指的是SpringMVC配置文件的位置--><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:spring-mvc.xml</param-value></init-param><!--指定项目启动就初始化DispatcherServlet--><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>DispatcherServlet</servlet-name><!--/           表示当前servlet映射除jsp之外的所有请求（包含静态资源）*.do        表示.do结尾的请求路径才能被SpringMVC处理(老项目会出现)/*          表示当前servlet映射所有请求（包含静态资源,jsp），不应该使用其配置DispatcherServlet--><url-pattern>/</url-pattern></servlet-mapping><!--乱码处理过滤器，由SpringMVC提供--><!-- 处理post请求乱码 --><filter><filter-name>CharacterEncodingFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><!-- name固定不变，value值根据需要设置 --><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param></filter><filter-mapping><filter-name>CharacterEncodingFilter</filter-name><!-- 所有请求都设置utf-8的编码 --><url-pattern>/*</url-pattern></filter-mapping>

Spring整合入web项目

让web项目启动的时候就能够创建Spring容器。可以使用Spring提供的监听器ContextLoaderListener，所以我们需要再web.xml中配置这个监听器,并且配置上Spring配置文件的路径。

 <!--配置spring的配置文件路径--><context-param><param-name>contextConfigLocation</param-name><param-value>classpath:applicationContext.xml</param-value></context-param><!--配置监听器，可以再应用被部署的时候创建spring容器--><listener><listener-class>org.springframework.web.context.ContextLoaderListener</listener-class></listener>

创建用户实体

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {private int id;private String userName;private int age;private String address;
}

创建dao

UserMapper接口

public interface UserMapper {/*** 根据id查询用户* @param id* @return*/User findById(Integer id);
}

UserMapper.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.yu.dao.UserMapper"><select id="findById" resultType="com.yu.pojo.User">select * from user where id = #{id}</select></mapper>

创建service

UserService接口

public interface UserService {User findById(Integer id);
}

UserServiceImpl实现类

@Service
public class UserServiceImpl implements UserService {@Autowiredprivate UserMapper userMapper;public User findById(Integer id) {return userMapper.findById(id);}
}

创建controller

@RestController
public class UserController {@Autowiredprivate UserService userService;@GetMapping("/user/{id}")public User findById(@PathVariable("id") Integer id){User user = userService.findById(id);return user;}
}

添加tomcat

添加项目

SSM报错“java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener”错误日志

解决方法

原因没有lib

运行

以上就是整合SSM框架的基本步骤。通过这个过程，不仅学会了如何配置和使用Spring、Spring MVC和MyBatis，还了解了如何将它们整合在一起构建一个稳健的Java Web应用程序。

在实际开发中，你可能还需要根据具体需求进行更多的配置和优化，但这个基础已经足够你开始构建复杂的Web应用了。

建站实战干货

SSM整合