# SSM整合学习
# SpringBoot和SSM的关系
(1)SSM 框架项目会有大量的配置文件,需要手动的去整合SpringMVC、Spring、MyBatis,并且需要注意各种配置和兼容,后期的维护难度也很大。
(2)Spring Boot 使用了特定的配置方式,开发人员不需要再定义样板化的配置,简化项目的初始构建。Spring Boot 使用了特定的配置方式,开发人员不需要再定义样板化的配置,简化项目的初始构建。Spring Boot 提供了内置的容器,部署也变得异常简单。
(3)Spring Boot 和 SSM 不冲突,Spring Boot 只是简化了配置,实际开发并没什么区别。虽然 Spring Boot 简化了配置,但并不代表不需要编写配置文件,还是需要在自带的 *application.yml* 文件中去编写一些内容,比如连接数据库代码、端口号等。
现在使用Java后端开发使用的技术栈基本上比较统一:**Spring + SpringMVC + Mybatis**,即大家常说的**SSM**。虽然现在流行的做法是使用SpringBoot来快速搭建、配置好SSM项目,但还是有必要知道如何不用SpringBoot来组合好这三者,因为SpringBoot也只是帮助我们做好了许多配置,并不是说舍弃掉了那些配置,所以知道原生的SSM如何整合可以更好帮助我们理解SSM也能更好的理解SpringBoot带来的好处!而且有的老项目就是没有用SpringBoot,如果你对原生SSM整合与配置一无所知那维护老项目起来会极其难受。
# 整合
## 项目搭建
### 创建项目
这里使用idea进行项目创建,maven来管理依赖包。首先在idea上新建一个project,选择Maven,然后选择web应用:
![image-20220826154733602](/images/2022-08-26-SSM整合学习/1)
点击下一步后输入自定义的**GroupId**和**ArtifactId**后点击下一步直到完成
![image-20220826155716608](/images/2022-08-26-SSM整合学习/2)
项目创建完毕后整个项目结构如下:
![image-20220826193450907](/images/2022-08-26-SSM整合学习/3)
### 配置web项目
配置SSM之前,先配置一下这个idea下的web项目。项目建立起来后这个 *web.xml* 文件里写的是**2.3**版本,这个版本太老了,换成较新版本。
按住`ctrl + shift + alt + S`打开idea的**Project Structure**,然后点击左侧的**Modules**,再点击**Web**,然后点击右边的删除按钮,确定,最后点击**APPLY**先将这个默认的删除:
![image-20220829140303347](/images/2022-08-26-SSM整合学习/4)
此时默认的 *web.xml* 文件已经被删除了。然后再点击右侧的添加按钮,点击 *web.xml* 进行添加:
![image-20220829140608444](/images/2022-08-26-SSM整合学习/5)
创建完毕后就会发现 *web.xml* 内容里版本已经变成了**5.0**了。
![image-20220829142525605](/images/2022-08-26-SSM整合学习/6)
### 建立项目结构
现在项目连个基本的结构都没有,建立项目的基本结构,也就是核心代码写在哪,测试在哪些,资源放在哪。
首先,在 *src* 路径下新建 *test* 文件夹,然后在 *src/main* 路径下新建 *java* 和 *resources* 文件夹。
建立好文件夹后,右键点击文件夹,选择**Mark Directory as**,然后选择对应的目录结构。
*java* 文件夹对应**SourcesRoot**,代表标记为项目源代码路径,代码就写在这里。
*resources* 文件夹对应**ResourcesRoot**,代表标记为资源路径,所有资源比如配置文件就放在这。
*test* 文件夹对应**TestSourcesRoot**,代表标记为测试路径,测试代码都会放在这里。
![image-20220829145717925](/images/2022-08-26-SSM整合学习/7)
文件夹指定好后,就要在 *java* 文件夹下创建代码包结构。包的话就分为最基本的**controller**、**service**、**mapper**、**entity**。包建好后目录结构如下:
![image-20220829150314015](/images/2022-08-26-SSM整合学习/8)
## 导入必备依赖包
基本的项目结构整理好后,接下来就要开始对SSM进行整合了。首先肯定要做的就是在 *pom.xml* 文件中导入必备的依赖包,直接复制粘贴就好了,各个地方都做了注释说明:
```xml
UTF-8
1.8
1.8
5.1.48
5.2.0.RELEASE
2.10.0
junit
junit
4.12
test
ch.qos.logback
logback-classic
1.2.3
org.projectlombok
lombok
1.18.10
provided
mysql
mysql-connector-java
${mysql.version}
com.alibaba
druid
1.1.12
org.mybatis
mybatis
3.4.6
javax
javaee-api
8.0
provided
javax.servlet
jstl
1.2
com.fasterxml.jackson.core
jackson-core
${jackson.version}
com.fasterxml.jackson.core
jackson-databind
${jackson.version}
com.fasterxml.jackson.core
jackson-annotations
${jackson.version}
org.springframework
spring-jdbc
${spring.version}
org.springframework
spring-context
${spring.version}
org.springframework
spring-webmvc
${spring.version}
org.aspectj
aspectjweaver
1.9.4
org.springframework
spring-test
${spring.version}
test
org.mybatis
mybatis-spring
1.3.2
```
## Spring与Mybatis整合
### 数据库配置
在进行整合之前准备一下数据库,好进行一个完整的演示。我这里用的是MySQL 5.7.39,建立一个名为 *ssm_demo* 的数据库,执行语句新建一张 *user* 表并插入两条测试数据:
```sql
CREATE DATABASE ssm_demo;
use ssm_demo;
CREATE TABLE `user` (
`id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键id',
`name` varchar(255) COLLATE utf8mb4_bin NOT NULL COMMENT '账户名',
`password` varchar(255) COLLATE utf8mb4_bin NOT NULL COMMENT '账户密码',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
INSERT INTO `user` VALUES (1, 'admin', '123456');
INSERT INTO `user` VALUES (2, 'Leslie', '654321');
```
然后在 *entity* 包下建立和数据库表对应的实体类User:
```java
@Data // lombok注解,自动生成Getter、Setter、toString方法
public class User implements Serializable {
private Long id;
private String name;
private String password;
}
```
然后在 *resources* 文件夹下建立`database.properties`文件来配置数据库连接的相关信息(这里根据自己的数据库信息配置),等下整合Mybatis要用到的:
```properties
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/ssm_demo?characterEncoding=utf-8&useSSL=false&autoReconnect=true&rewriteBatchedStatements=true&serverTimezone=UTC
jdbc.username=root
jdbc.password=123456
```
### logback日志配置
真实项目中一般是要观察日志输出的,我们再配置一下日志。在 *resources* 目录下新建`logback.xml`文件。
**注意:在文件尾部需要指定某个包,这个根据自己项目结构包名来设置**
```xml
%red(%d{yyyy-MM-dd HH:mm:ss.SSS}) %yellow([%-5p]) %highlight([%t]) %boldMagenta([%C]) %green([%L]) %m%n
ERROR
DENY
ACCEPT
[%d{yyyy-MM-dd' 'HH:mm:ss.SSS}] [%C] [%t] [%L] [%-5p] %m%n
${LOG_INFO_HOME}//%d.log
30
ERROR
[%d{yyyy-MM-dd' 'HH:mm:ss.SSS}] [%C] [%t] [%L] [%-5p] %m%n
${LOG_ERROR_HOME}//%d.log
30
```
### Mybatis全局设置
现在进行Spring和Mybatis的整合了。我们先在 *resources* 文件夹下新建`mybatis-config.xml`文件来对Mybatis进行全局配置,这里我习惯配置这些,根据自己的需求来就好:
```xml
```
### Spring-Mybatis整合配置
再来新建`spring-mybatis.xml`文件,这个文件就是用来做整合的!
**注意:文件中很多设置需要指定某个包,这个根据自己项目结构包名来设置**
```xml
```
### JUnit测试
至此Spring和Myabtis已经整合配置好了,在测试之前先建立好mapper接口文件、myabtis映射xml文件、service接口和实现类:
![image-20220829155212068](/images/2022-08-26-SSM整合学习/9)
*UserMapper* 接口专门用来声明各种数据库操作方法,`@Repository`注解将其定义为Spring所管理的Bean:
```java
@Repository
public interface UserMapper {
/**
* 从数据库中查询出所有的User对象
* @return User对象集合
*/
List selectAll();
}
```
*UserMapper.xml* 映射文件用来写方法对应要执行的SQL语句:
```xml
```
*UserService* 接口用来声明关于User的业务方法:
```java
public interface UserService {
/**
* 从数据库中查询出所有的User对象
* @return User对象集合
*/
List getAll();
}
```
*UserServiceImpl* 实体类用来实现关于User的业务逻辑,`@Service`注解和`@Repository`注解用处一样,将其定义为Bean。`@Transactional`注解为声明式事务,如果该业务层的方法有异常抛出则会触发事务回滚。然后使用`@Autowired`注解在私有属性上,自动加载Bean,无需我们手动创建UserMapper了:
```java
@Service
@Transactional(rollbackFor = Exception.class)
public class UserServiceImpl implements UserService {
@Autowired
private UserMapper userMapper;
@Override
public List getAll() {
return userMapper.selectAll();
}
}
```
相关类和文件都建好了,现在在test文件夹下建立一个测试类 *UserServiceTest* ,**一定要在测试类上加上那两个注解**,否则无法正常使用Spring相关功能:
```java
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = {"classpath:spring-mybatis.xml"})
public class UserServiceTest {
@Autowired
private UserService userService;
@Test
public void getAll() {
System.out.println(userService.getAll());
System.out.println(userService.getAll());
}
}
```
运行后就可以看到运行结果了:
![image-20220829160322397](/images/2022-08-26-SSM整合学习/10)
可以看到结果正常显示,并且日志也打印在了控制台上。**这代表已经完成了Spring和Mybatis的整合!**
### 思路
![image-20220829160613612](/images/2022-08-26-SSM整合学习/11)
## SpringMVC
### spring-mvc.xml
接下来配置SpringMVC,在 *resources* 目录下新建`spring-mvc.xml`文件进行配置。
**注意:文件中设置需要指定某个包,这个根据自己项目结构包名来设置**
```xml
```
### web.xml
最后一个配置自然就是在`web.xml`里进行整合了,主要配置三点:
1. 配置Spring IOC容器,为了mybatis做准备
2. 配置SpringMVC的前端控制器
3. 配置字符编码过滤器
```xml
contextConfigLocation
classpath:spring-mybatis.xml
org.springframework.web.context.ContextLoaderListener
SpringMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:spring-mvc.xml
1
SpringMVC
/
encodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
encodingFilter
/*
```
### 最终测试
以上,所有的配置都弄好了,那么接下来就跑一个最简单的web项目来看看是否整合成功!
还记得在`spring-mvc.xml`文件中配置的视图解析前缀嘛,我们在 /WEB-INF/views/ 文件夹下新建一个`index.jsp`文件:
```jsp
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
首页-Leslie
<%--循环提取userList中的元素--%>
```
接下来再在 *controller* 包下新建一个控制器类来定义访问接口:
```java
@Controller
@RequestMapping(value = "user")
public class UserController {
@Autowired
private UserService userService;
@GetMapping("/getList")
public String getList(Model model) {
// 将数据存到model对象里,这样jsp就能访问数据
model.addAttribute("userList", userService.getAll());
// 返回jsp文件名
return "index";
}
@GetMapping("/getJson")
@ResponseBody
public List getList() {
// 如果想做前后端分离的话可以加上@ResponseBody注解,直接返回数据对象,这样前端就可以通过获取json来渲染数据了
return userService.getAll();
}
}
```
然后启动Tomcat,在浏览器中访问接口:
![image-20220829164342625](/images/2022-08-26-SSM整合学习/12)
![image-20220829164405648](/images/2022-08-26-SSM整合学习/13)
可以看到成功访问到了数据,至此SSM完全整合完毕!
**最后,本文所有代码都放在了[github](https://github.com/Leslie-Shang/SSM)上,clone下来即可运行查看效果!**