SSM基础整合
在整合一个 Spring+SpringMVC+Mybatis 项目之前,我们需要理解它们各自的职能是什么?
-
Spring是什么,用来干什么,在SSM中主要职能是什么?
Spring是一个开源的轻量级的Java开发框架,用于简化应用程序的开发(具体详见:Spring Framework)。在SSM中,Spring主要负责实现业务对象的管理。
-
那SpringMVC呢?
SpringMVC是Spring框架的一个模块,是基于mvc的webframework模块(具体详见:Web on Servlet Stack (spring.io))。SpringMVC在SSM中,SpringMVC主要负责处理客户端请求、转发和页面管理。具体详见:
-
Mybatis呢?
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射(具体详见:https://mybatis.org/mybatis-3/zh/index.html)。
在了解了它们各自的职能之后,我们开始逐步进行一个SSM项目的整合。
准备项目环境:jdk1.8,maven,idea
一、构建一个Maven项目
1. 使用IDEA创建一个新的Maven项目
2.配置Maven的pom.xml并导入项目相关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.feng</groupId>
<artifactId>SSM</artifactId>
<version>1.0-SNAPSHOT</version>
<!--声明项目打包时打成jar包-->
<packaging>jar</packaging>
<dependencies>
<!--导入spring框架依赖-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.10</version>
</dependency>
<!--导入单元测试依赖,用于在test里进行单元测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
<!--导入mysql连接驱动依赖-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.26</version>
</dependency>
<!--导入mybatis框架依赖-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.7</version>
</dependency>
<!--支持整合spring管理mybatis依赖-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.6</version>
</dependency>
<!--开启spring数据库连接支撑依赖-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>5.3.10</version>
</dependency>
<!--导入druid连接池管理依赖,用于配置mybatis的数据库连接池-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.6</version>
</dependency>
<!--导入spring测试依赖,用于支持spring进行单元测试-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>5.3.10</version>
<scope>test</scope>
</dependency>
<!--导入servlet-api依赖,用于支持servlet-->
<dependency>
<groupId>org.apache.tomcat</groupId>
<artifactId>servlet-api</artifactId>
<version>6.0.29</version>
</dependency>
</dependencies>
<!--声明maven打包时需要导出那些文件-->
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
</build>
<!--声明使用java8进行编译-->
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
</project>
二、创建项目包结构
三、SSM对应的MVC架构
在MVC三层架构中,有表现层,业务层和持久层。对应在SSM中,SpringMVC负责表现层(请求、视图解析等),Spring负责业务层(业务对象的创建和管理),Mybatis负责持久层(数据持久化处理)。
所以,
在表现层中:我们主要需要做的是配置DispatcherServlet(中央控制器),注册处理器映射器、
处理器适配器和视图解析器。
在业务层中:我们主要需要注册每一个Service,以及配置事务管理(本次项目中没有配置)等。
在持久层中:我们要配置数据源,注册Spring接管Mybatis的SqlSessionFactory。
在配置之前,我们通常在“ resources ”文件夹下创建一个子文件夹用来表示我们用到了那些框架技术。例如:在“ resources ”文件下创建一个“ mybatis ”文件夹,用来存放mybatis的配置文件,如下图:
三、配置Mybatis
1. 创建mybatis-config.xml
在SSM中,mybatis交由spring托管,我们可以直接在spring中设置mybatis相关的属性。但我还是习惯于在mybatis的配置文件中配置一些基本属性,例如:下面的配置了mybatis日志输出和实体类别名。具体配置详见:https://mybatis.org/mybatis-3/configuration.html
<?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="logImpl" value="STDOUT_LOGGING"/>
</settings>
<!--配置别名-->
<typeAliases>
<package name="com.feng.pojo"/>
</typeAliases>
</configuration>
2. 实体类别名
为什么要配置实体类别名?当然也可以不配置。配置实体类别名的用处主要是我们在编写XXXMapper.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.feng.mapper.DoctorMapper">
<select id="queryAllDoctor" resultType="com.feng.doctor">/*id必须与接口中的方法名一致*/
select *
from doctor_tb;
</select>
</mapper>
- 配置实体类别名之后:
<?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.feng.mapper.DoctorMapper">
<select id="queryAllDoctor" resultType="doctor">/*id必须与接口中的方法名一致*/
select *
from doctor_tb;
</select>
</mapper>
四、表现层
配置表现层其实就是配置SpringMVC一些相关的组件。在配置SpringMVC中,我们主要配置DisapatcherServlet(中央控制器)和在配置处理器映射器、处理器适配器和视图解析器。
1. 配置web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5">
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!--添加中央控制器-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring/applicationContext.xml</param-value><!--加载spring容器-->
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
主要就是添加DispatcherServlet。
2.创建SpringMVC.xml
- 首先我们在/resources/目录的spring文件夹下创建一个 springMvc.xml 配置文件。
3. 配置springMvc.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:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
https://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context
https://www.springframework.org/schema/context/spring-context.xsd
">
<!--自动注册处理器映射器、处理器适配器-->
<mvc:annotation-driven/>
<!--静态资源过滤-->
<mvc:default-servlet-handler/>
<!--注册视图解析器-->
<bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/pages/"></property><!--前缀,页面存放的文件目录-->
<property name="suffix" value=".jsp"></property><!--后缀,页面的类型-->
</bean>
<!--扫描所有的controller-->
<context:component-scan base-package="com.feng.controller"/>
</beans>
-
在springMvc.xml中,我们主要配置的是静态资源过滤、处理器映射器、处理器适配器和视图解析器。
-
使用< mvc:annotation-driven />我们可以自动注册处理器映射器和处理器适配器,不像视图解析器需要手动注册,前提是要有 xmlns:mvc =“http://www.springframework.org/schema/mvc” 和 xsi:schemaLocation中有 “ http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd ”。
到此为止,SpringMVC的基础配置已经完成了。
五、业务层
1.创建applicationService.xml
首先我们在/resources/目录的spring文件夹下创建一个 applicationService.xml 配置文件。
2.配置applicationService.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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
https://www.springframework.org/schema/context/spring-context.xsd">
<!--方法一:开启自动扫描,扫描com.feng.service包下所有service并注册到IOC容器中,
前提条件是每个Service类上都要有@Service注解-->
<context:component-scan base-package="com.feng.service"/>
<!--方法二:手动注册每一个Service-->
<bean id="doctorService" class="com.feng.service.impl.DoctorServiceImpl"/>
</beans>
其实就是去注册我们的每一个Service。关于事务的管理的配置,暂时先不做说明。
六、Spring整合Mybatis
1. 创建applicationDao.xml
首先我们在/resources/目录的spring文件夹下创建一个 applicationDao.xml 配置文件。
2.配置applicationDao.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"
xsi:schemaLocation="http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
https://www.springframework.org/schema/context/spring-context.xsd
">
<!--加载数据库配置文件-->
<context:property-placeholder location="classpath:db.properties"></context:property-placeholder>
<!--配置数据库连接池-->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"><!--使用德鲁伊连接池-->
<property name="url" value="${jdbc.url}"/>
<property name="driverClassName" value="${jdbc.driver}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
<property name="initialSize" value="${jdbc.initialSize}"/>
<property name="maxActive" value="${jdbc.maxActive}"/>
</bean>
<!--配置SqlSessionFactory-->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"/><!--配置数据源-->
<property name="configLocation" value="classpath:mybatis/mybatis-config.xml"/><!--添加mybatis配置-->
<!--扫描每一个Mapper对应的xml文件-->
<property name="mapperLocations" value="classpath*:com/feng/mapper/xml/*.xml"/>
</bean>
<!--扫描所有的Mapper-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
<property name="basePackage" value="com.feng.mapper"/>
</bean>
</beans>
首先配置我们的数据库数据源,然后配置Mybatis的SqlSessionFactory(用来生产SqlSession,通过SqlSession执行SQL操作),但在这里这个工厂交由Spring管理,最后就是扫描所有的Mapper。故Spring整合Mybatis就是Spring控制Mybatis的SqlSessionFactory,让Spring来生产SqlSession。
3.db.properties
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/doctor_order_db?serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true
jdbc.username=root
jdbc.password=fengbin
jdbc.initialSize=5
jdbc.maxActive=30
到此,我们的SSM项目已经整合完毕了,接下来我们来测试一下!
七、测试
1.实体类
/*实体类的每一个属性保持和数据库字段一致,方便mybatis进行持久化管理*/
public class Doctor {
private String doctor_id;
private String doctor_password;
private String doctor_name;
private String doctor_position;
private String doctor_department;
private String doctor_sex;
private Integer doctor_age;
public Doctor() {
}
@Override
public String toString() {
return "Doctor{" +
"doctor_id='" + doctor_id + '\'' +
", doctor_password='" + doctor_password + '\'' +
", doctor_name='" + doctor_name + '\'' +
", doctor_position='" + doctor_position + '\'' +
", doctor_department='" + doctor_department + '\'' +
", doctor_sex='" + doctor_sex + '\'' +
", doctor_age=" + doctor_age +
'}';
}
public String getDoctor_id() {
return doctor_id;
}
public void setDoctor_id(String doctor_id) {
this.doctor_id = doctor_id;
}
public String getDoctor_password() {
return doctor_password;
}
public void setDoctor_password(String doctor_password) {
this.doctor_password = doctor_password;
}
public String getDoctor_name() {
return doctor_name;
}
public void setDoctor_name(String doctor_name) {
this.doctor_name = doctor_name;
}
public String getDoctor_position() {
return doctor_position;
}
public void setDoctor_position(String doctor_position) {
this.doctor_position = doctor_position;
}
public String getDoctor_department() {
return doctor_department;
}
public void setDoctor_department(String doctor_department) {
this.doctor_department = doctor_department;
}
public String getDoctor_sex() {
return doctor_sex;
}
public void setDoctor_sex(String doctor_sex) {
this.doctor_sex = doctor_sex;
}
public Integer getDoctor_age() {
return doctor_age;
}
public void setDoctor_age(Integer doctor_age) {
this.doctor_age = doctor_age;
}
public Doctor(String doctor_id, String doctor_password, String doctor_name, String doctor_position, String doctor_department, String doctor_sex, Integer doctor_age) {
this.doctor_id = doctor_id;
this.doctor_password = doctor_password;
this.doctor_name = doctor_name;
this.doctor_position = doctor_position;
this.doctor_department = doctor_department;
this.doctor_sex = doctor_sex;
this.doctor_age = doctor_age;
}
}
2.持久层DoctorMapper接口
import com.feng.pojo.Doctor;
import java.util.List;
public interface DoctorMapper {
List<Doctor> queryAllDoctor(); //查询所有医生信息
}
3.持久层DoctorMapper接口的实现
DoctorMapper.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.feng.mapper.DoctorMapper">
<select id="queryAllDoctor" resultType="doctor">/*id必须与接口中的方法名一致*/
select *
from doctor_tb;
</select>
</mapper>
4.业务层DoctorService接口
public interface DoctorService {
List<Doctor> queryAllDoctor();
}
5. 业务层DoctorServiceImpl接口实现类
public class DoctorServiceImpl implements DoctorService {
@Autowired
private DoctorMapper doctorMapper;
@Override
public List<Doctor> queryAllDoctor() {
return doctorMapper.queryAllDoctor();
}
}
6.表现层DoctorController
@Controller
public class DoctorController {
@Autowired
private DoctorService doctorService;
@GetMapping("/")
public String sayHello(Model model) {
List<Doctor> list = doctorService.queryAllDoctor();
model.addAttribute("message",list);
return "hello";
}
}
7.前端页面 hello.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="utf-8" %>
<html>
<head>
<title>Title</title>
</head>
<body>
${message}
</body>
</html>
8.数据准备
9.测试结果
jsp接收到的数据:
简单的SSM整合成功!