ssm框架的整合

Chemlez

Java

发布于：Nov 18, 2020

初学Spring、SpringMVC以及Mybatis时，将其整合时步骤繁多，新手容易不理解，面对繁多的XML配置，往往也不易跑通代码，这里用于记录一次整合的配置。

整合的目的：通过Spring的IoC和AOP对组件进行管理。即：通过IoC解决组件间的动态依赖注入；通过AOP来对事务进行控制，即通过Spring来整合SpringMVC及Mybatis。

想法：对Mybatis的整合是，在Service层调用dao层的接口时，使其自动装配。

首先：一张数据库表对应一个实体类，一个实体类对应一张Mapper.xml配置文件。在resources文件夹下创建一个mapper文件夹，用于存放实体类的Mapper文件。这里创建EmployeeMapper.xml配置文件。

一、pom.xml相关配置

1.1 `pom.xml`中`properties`版本控制

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <spring.version>5.0.2.RELEASE</spring.version>
    <slf4j.version>1.6.6</slf4j.version>
    <log4j.version>1.2.12</log4j.version>
    <mysql.version>5.1.6</mysql.version>
    <mybatis.version>3.4.5</mybatis.version>
</properties>

1.2 Spring相关依赖导入

<!-- spring -->
<!-- 切入点表达式 -->
<dependency>
    <groupId>org.aspectj</groupId>
    <artifactId>aspectjweaver</artifactId>
    <version>1.6.8</version>
</dependency>
<!-- springAOP  AOP核心功能，例如代理工厂等 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-aop</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- springIOC -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-context</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- spring的web依赖 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- SpringMVC -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- spring整合junit -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- 事务控制 -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-tx</artifactId>
    <version>${spring.version}</version>
</dependency>
<!-- SpringJDBC -->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>${spring.version}</version>
</dependency>

1.3 Mybatis及Mybatis-Spring适配包依赖导入

<!-- Mybatis -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>${mybatis.version}</version>
</dependency>
<!-- Mybatis与Spring整合的中间适配包 -->
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>1.3.0</version>
</dependency>

1.4 数据库相关

<!-- 数据库连接池 -->
<dependency>
    <groupId>c3p0</groupId>
    <artifactId>c3p0</artifactId>
    <version>0.9.1.2</version>
    <type>jar</type>
    <scope>compile</scope>
</dependency>
<!-- mysql驱动 -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>${mysql.version}</version>
</dependency>

1.5 其他相关

<!-- servlet、jsp、jstl表达式 -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.0.1</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.0</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>jstl</groupId>
    <artifactId>jstl</artifactId>
    <version>1.2</version>
</dependency>
<!-- log start -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>${log4j.version}</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>${slf4j.version}</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>${slf4j.version}</version>
</dependency>
<!-- log end -->
<!--引入pageHelper分页插件 -->
<dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.0.0</version>
</dependency>
<!-- MBG -->
<!-- https://mvnrepository.com/artifact/org.mybatis.generator/mybatis-generator-core -->
<dependency>
    <groupId>org.mybatis.generator</groupId>
    <artifactId>mybatis-generator-core</artifactId>
    <version>1.3.5</version>
</dependency>
<!--JSR303数据校验支持；tomcat7及以上的服务器，
  tomcat7以下的服务器：el表达式。额外给服务器的lib包中替换新的标准的el
  -->
<!-- https://mvnrepository.com/artifact/org.hibernate/hibernate-validator -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>5.4.1.Final</version>
</dependency>
<!-- 对json处理的包，即能够使用@ResponseBody -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.0</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.0</version>
</dependency>

二、Mybatis相关配置文件

2.1 Mybatis-config.xml配置文件

创建conf文件夹，在其下方创建Mybatis-config.xml。

<?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"> <!-- 引入Mybatis的配置声明dtd文件 -->
<!-- mybatis的主配置文件 -->
<configuration>
    <properties resource="jdbcConfig.properties"/>
    <typeAliases>
        <typeAlias type="cn.lizhi.domain.User" alias="user"/>
        <package name="cn.lizhi.domain"/>
    </typeAliases>
    <!-- 配置环境 若想让environments环境起作用，下列的标签中的配置都需要起作用 -->
    <environments default="mysql">
        <!-- 配置mysql(default的值)环境 id值等于default的值 -->
        <environment id="mysql">
            <!-- 配置事务的类型 -->
            <transactionManager type="JDBC"/>
            <!-- 配置数据源(连接池 -\- druid、c3p0..) -->
            <dataSource type="POOLED">
                <!-- 配置数据库连接的基本信息 -->
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="./mappers/EmployeeMapper.xml"/>
    </mappers>
</configuration>

2.2 数据库连接配置文件 —— jdbcConfig.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://url:3306/mybatis?characterEncoding=utf8
jdbc.username=root
jdbc.password=root

2.3 实体类对应的映射文件Mapper

在conf文件夹下创建mappers文件包，继而用于存放全部的实体类映射文件。这里创建EmployeeMapper.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="cn.lizhi.dao.UserDao">
    <!-- 配置查询所有，resultType的作用就是返回封装的位置。这里是对User对象进行封装 -->
    <select id="findAll" resultType="employee">
        SELECT *FROM employee;
    </select>
</mapper>

三、web.xml相关配置文件

3.1 Spring的配置文件的加载

<!-- 配置Spring的监听器 -->
<listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 配置加载类路径的配置文件 -->
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
</context-param>

3.2 前端控制器 —— 对SpringMVC配置文件的加载

<!-- 配置前端控制器：服务器启动必须加载，需要加载springmvc.xml配置文件 -->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置初始化参数，创建完DispatcherServlet对象，加载springmvc.xml配置文件 -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 服务器启动的时候，让DispatcherServlet对象创建 -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

3.3 中文乱码过滤器

<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

3.4 Restful风格配置

<!-- 4、使用Rest风格的URI，将页面普通的post请求转为指定的delete或者put请求 -->
<filter>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
<filter>
    <filter-name>HttpPutFormContentFilter</filter-name>
    <filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HttpPutFormContentFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

四、SpringMVC配置文件的编写 —— Spring-servlet.xml

SpringMVC只是用来控制网站跳转逻辑。首先导入相关的名称空间。

<?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/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
</beans>

4.1 自动扫描所有的组件 —— 只对控制器进行扫描

采用注解扫描，只扫描控制器。

<!--SpringMVC的配置文件，包含网站跳转逻辑的控制，配置  -->
<context:component-scan base-package="cn.lizhi" use-default-filters="false">
    <!--只扫描控制器，采用注解扫描的方式 -->
    <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>

4.2 Springmvc处理器的配置(两个基本配置)

<!--两个标准配置-->
<!-- 将springmvc不能处理的请求交给tomcat -->
<mvc:default-servlet-handler/>
<!-- 能支持springmvc更高级的一些功能，JSR303校验，快捷的ajax...映射动态请求 -->
<mvc:annotation-driven/>

4.3 视图解析器

<!--配置视图解析器，方便页面返回  -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/views/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

4.4 静态资源的处理

<!-- 设置静态资源不过滤 -->
<mvc:resources location="/css/" mapping="/css/**"/>
<mvc:resources location="/images/" mapping="/images/**"/>
<mvc:resources location="/static/js/" mapping="/static/js/**"/>
<mvc:resources location="/js/" mapping="/js/**"/>
<mvc:resources location="/font/" mapping="/font/**"/>
<mvc:resources location="/static/" mapping="/static/**"/>

五、Spring的配置文件 —— applicationContext.xml

通过Spring来管理所有的业务逻辑组件。

5.1 名称空间

<?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:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xsi:schemaLocation="http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.3.xsd
		http://www.springframework.org/schema/beans
		http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
		http://www.springframework.org/schema/tx
		http://www.springframework.org/schema/tx/spring-tx-4.3.xsd
		http://www.springframework.org/schema/context
		http://www.springframework.org/schema/context/spring-context-4.3.xsd">
</beans>

5.2 配置注解扫描

controller层交由给SpringMVC进行管理控制。

<!-- 注解扫描，不扫描controller层，controller层交给SpringMVC进行管理 -->
<context:component-scan base-package="cn.lizhi">
    <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" />
</context:component-scan>

5.3 业务逻辑等相关配置

Spring用来控制业务逻辑。数据源、事务控制、aop等等都交由Spring进行控制。

数据源配置：

<!-- 引入数据源配置文件 -->
<context:property-placeholder location="classpath:dbconfig.properties" />
<!-- 数据源配置 -->
<bean id="pooledDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
    <property name="jdbcUrl" value="${jdbc.jdbcUrl}"></property>
    <property name="driverClass" value="${jdbc.driverClass}"></property>
    <property name="user" value="${jdbc.user}"></property>
    <property name="password" value="${jdbc.password}"></property>
</bean>

事务控制：

<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <!--控制住数据源  -->
    <property name="dataSource" ref="pooledDataSource"></property>
</bean>
<!--配置事务增强，事务如何切入  -->
<tx:advice id="txAdvice" transaction-manager="transactionManager">
    <tx:attributes>
        <!-- 所有方法都是事务方法 -->
        <tx:method name="*" propagation="REQUIRED" read-only="false"/>
        <!--以get开始的所有方法 只读  -->
        <tx:method name="get*" propagation="SUPPORTS" read-only="true"/>
    </tx:attributes>
</tx:advice>
<!--开启基于注解的事务，使用xml配置形式的事务（必要、主要的都是使用配置式）  -->
<aop:config>
    <!-- 切入点表达式 -->
    <aop:pointcut expression="execution(* cn.lizhi.service..*(..))" id="txPoint"/>
    <!-- 配置事务增强 -->
    <aop:advisor advice-ref="txAdvice" pointcut-ref="txPoint"/>
</aop:config>

整合mybatis：

目的：

spring来管理所有组件，即管理mapper的实现类。

service ==》dao @Autowired:自动注入mapper;
spring用来管理事务，spring声明式事务。

<!-- 创建SqlSessionFactory对象 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <!-- 指定mybatis全局配置文件的位置 -->
    <property name="configLocation" value="classpath:mybatis-config.xml"></property>
    <!-- 指定数据源 -->
    <property name="dataSource" ref="pooledDataSource"></property>
    <!-- 指定mybatis，mapper文件的位置 -->
    <property name="mapperLocations" value="classpath:mapper/*.xml"></property>
</bean>

<!-- 配置扫描器，将mybatis接口的实现加入到ioc容器中 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <!--扫描所有dao接口的实现，加入到ioc容器中 -->
    <property name="basePackage" value="cn.lizhi.dao"></property>
</bean>

<!-- 配置一个可以执行批量的sqlSession -->
<bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
    <constructor-arg name="sqlSessionFactory" ref="sqlSessionFactory"></constructor-arg>
    <constructor-arg name="executorType" value="BATCH"></constructor-arg>
</bean>

5.4 重写Mybatis主配置文件

当在Spring的配置文件中整合了Mybatis后，需要将Mybatis中主配置文件中多余的信息删除，此时Mybatis主配置文件只用来Mybatis中自身的配置，其余的交给Spring，进行管理。此时配置结果如下：

<?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">
<!-- 引入Mybatis的配置声明dtd文件 -->
<!-- mybatis的主配置文件 -->
<configuration>
    
    <!-- 配置别名 -->
    <typeAliases>
        <package name="cn.lizhi.domain"/>
    </typeAliases>

</configuration>

六测试

6.1 dao层的编写

@Repository
public interface EmployeeDao {

    Employee findById(Integer id);
    List<Employee> findAll();
}

6.2 service层的编写

@Service
public class EmployeeServiceImpl  implements EmployeeService {

    @Autowired
    private EmployeeDao employeeDao;

    @Override
    public List<Employee> findAll() {
        List<Employee> employees = employeeDao.findAll();
        return employees;
    }
}

6.3 controller层的编写

@Controller
@RequestMapping("/emps")
public class EmployeeController {
    @Autowired
    private EmployeeService employeeService;

    @RequestMapping("/allEmp")
    public String findAllEmployee(Model model) {
        List<Employee> employees = employeeService.findAll();
        model.addAttribute("employees", employees);
        return "all";
    }
}

6.4 EmployeeMapper.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="cn.lizhi.dao.EmployeeDao">
    
    <resultMap id="empFindAll" type="employee">
        <id property="empId" column="emp_id"></id>
        <result property="empName" column="emp_name"></result>
        <result property="empSalary" column="emp_salary"></result>
        <result property="empAge" column="emp_age"></result>
    </resultMap>

    <select id="findById" parameterType="int" resultType="employee">
        SELECT * FROM table_emp WHERE id=#{id};
    </select>

    <select id="findAll" resultMap="empFindAll">
        SELECT * FROM table_emp;
    </select>
</mapper>

简化Mybatis的使用——通用Mapper

使用通用Mapper的目的是为了替我们生成常用增删改查操作的SQL语句，并能够简化对于Mybatis的操作。一、快速入门1.1 数据库表的创建1234567891011121314151617...

Springboot自定义starter

一、介绍与定义本章用于记录自定义Springboot-starter的学习过程。在我们自定义starter之前，我们首先观察一下SpringBoot自身的starter的形式都是什么样的。我们...