SSM 整合

本实验将完成 SSM 整合的第一部分即完成 SSM 项目的基础环境搭建工作。本次实验项目采用三层架构 + MVC 设计模式进行搭建。实验中采用如下技术栈:

• Spring
• SpringMVC
• MyBatis Plus 第三方插件
• Druid 数据源
• Apache IO 组件
• Log4j 日志框架
• JSR-303 验证框架
• MySQL 数据库
• JSP
• jQuery

知识点

• 基本环境搭建流程
• 配置文件关联关系

首先，创建项目工程，按三层架构 + MVC 设计模式创建如图所示目录结构：

执行如下命令：

cd /home/project
mvn archetype:generate -DgroupId=org.lanqiao -DartifactId=SSMDemoProject -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false -Dversion=1.0-SNAPSHOT
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/mapper
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/service
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/service/impl
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/controller
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/entity
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/util
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/exception
mkdir -p SSMDemoProject/src/main/java/org/lanqiao/interceptor
mkdir -p SSMDemoProject/src/main/webapp/js
mkdir -p SSMDemoProject/src/main/webapp/WEB-INF/pages
wget https://labfile.oss.aliyuncs.com/courses/3491/jquery-1.12.4.min.js
mv jquery-1.12.4.min.js SSMDemoProject/src/main/webapp/js
mkdir -p SSMDemoProject/src/test/java/org/lanqiao/test
touch SSMDemoProject/src/main/resources/springmvc.xml
touch SSMDemoProject/src/main/resources/applicationContext.xml
touch SSMDemoProject/src/main/resources/jdbc.properties
touch SSMDemoProject/src/main/resources/log4j.properties
touch SSMDemoProject/src/main/resources/mybatis.xml
touch SSMDemoProject/src/test/java/org/lanqiao/test/TestDao.java
touch SSMDemoProject/src/test/java/org/lanqiao/test/TestService.java
touch SSMDemoProject/src/test/java/org/lanqiao/test/TestController.java

接着按技术栈要求在 pom.xml 导入完整 SSM 的依赖，包括 mybatis plus，springmvc，jackson ，commons-io，hibernate-validator 等，具体内容如下：

<?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/maven-v4_0_0.xsd">

    <modelVersion>4.0.0</modelVersion>
    <groupId>org.lanqiao</groupId>
    <artifactId>SSMDemoProject</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>SSMDemoProject Maven Webapp</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <junit.version>4.12</junit.version>
        <jackson.verson>2.9.6</jackson.verson>
        <spring.version>4.3.18.RELEASE</spring.version>
    </properties>

    <dependencies>

    <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>javax.servlet-api</artifactId>
          <version>3.1.0</version>
          <scope>provided</scope>
        </dependency>

        <dependency>
            <groupId>jstl</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>jcl-over-slf4j</artifactId>
            <version>1.7.12</version>
        </dependency>

        <dependency>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.4</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.3.1</version>
        </dependency>

        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>${junit.version}</version>
        </dependency>

        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-validator</artifactId>
            <version>4.1.0.Final</version>
        </dependency>

      <dependency>
          <groupId>javax.xml.bind</groupId>
          <artifactId>jaxb-api</artifactId>
          <version>2.2.8</version>
      </dependency>

        <dependency>
            <groupId>cglib</groupId>
            <artifactId>cglib</artifactId>
            <version>3.2.5</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>1.6.12</version>
            <scope>compile</scope>
        </dependency>

         <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-context-support</artifactId>
             <version>${spring.version}</version>
            <scope>compile</scope>
        </dependency>


        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-oxm</artifactId>
             <version>${spring.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-tx</artifactId>
             <version>${spring.version}</version>
            <scope>compile</scope>
        </dependency>


        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
             <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-test</artifactId>
             <version>${spring.version}</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
             <version>${spring.version}</version>
        </dependency>

        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.1.8</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.18</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.3.2</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus</artifactId>
            <version>2.3.3</version>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-support</artifactId>
            <version>2.3.3</version>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>${jackson.verson}</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-annotations</artifactId>
            <version>${jackson.verson}</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <!-- Jdk 配置 -->
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.5.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <!-- Tomcat 插件配置 -->
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <configuration>
                    <!-- 端口 -->
                    <port>8080</port>
                    <!-- 编码-->
                    <uriEncoding>UTF-8</uriEncoding>
                    <!-- 项目的启动路径-->
                    <path>/</path>
                    <!-- 项目名称 -->
                    <finalName>SpringMVCProject</finalName>
                    <!-- 启动的命令名称-->
                    <server>tomcat7</server>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

接着配置日志监听器，字符集过滤器和 SpringMVC 核心分发器， 内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.0"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
    http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">

    <!-- log4j配置start -->
    <context-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>classpath:log4j.properties</param-value>
    </context-param>
    <context-param>
    <!-- 指定系统根目录路径 -->
        <param-name>webAppRootKey</param-name>
        <param-value>webapp.root</param-value>
       </context-param>
    <!-- Spring 加载 Log4j 的监听 -->
    <listener>
        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
    </listener>
    <!-- log4j配置end -->

     <!-- spring字符编码过滤器start-->
    <filter>
        <!-- Spring 编码过滤器 -->
      <filter-name>encodingFilter</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>
     <!-- ② 过滤器的匹配 URL -->
       <filter-mapping>
           <filter-name>encodingFilter</filter-name>
           <url-pattern>/*</url-pattern>
       </filter-mapping>
    <!-- spring字符编码过滤器end-->

    <!-- Spring MVC 核心分发器 -->
    <servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

编写空白 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:aop="http://www.springframework.org/schema/aop"
       xmlns:p="http://www.springframework.org/schema/p"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
                http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
                http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 第一部分整合 mybatis plus start -->

    <!-- 第一部分整合 mybatis plus  end -->

    <!-- 第二部分管理业务模型 start -->

    <!-- 第二部分管理业务模型   end -->

    <!-- 第三部分声明式事务 start -->

    <!-- 第三部分声明式事务   end -->

</beans>

编写 springmvc.xml，配置项目所需的基本配置，并在其中通过 import 引用 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:aop="http://www.springframework.org/schema/aop"
       xmlns:p="http://www.springframework.org/schema/p"
       xmlns:tx="http://www.springframework.org/schema/tx"
       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-2.5.xsd
                http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd
                http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- 引用Spring容器配置文件进行统一管理 -->
    <import resource="applicationContext.xml"/>

     <!-- 配置需要扫描的包 -->
    <context:component-scan base-package="org.lanqiao.controller"></context:component-scan>
    <!--  配置注解驱动 -->
    <mvc:annotation-driven />

    <!-- 使用默认servlet处理方式放行所有资源-->
    <mvc:default-servlet-handler/>

    <!--  配置视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

    <!-- 配置全局简单异常解析器 -->
    <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
        <!-- 定义默认的异常处理页面 -->
        <property name="defaultErrorView" value="error"/>
    </bean>
</beans>

jdbc.properties 的内容如下：

mysql.driver=com.mysql.jdbc.Driver
mysql.url=jdbc:mysql://127.0.0.1:3306/school?useUnicode=true&characterEncoding=utf-8
mysql.user=root
mysql.password=
mysql.minIdle=45
mysql.initialSize=5
mysql.maxActive=100
mysql.maxWait=100
mysql.removeAbandonedTimeout=180
mysql.removeAbandoned=true

log4j.properties 的内容如下：

log4j.rootLogger=debug,CONSOLE,file

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern= - (%r ms) - [%p] %d %c - %m%n

log4j.appender.file=org.apache.log4j.DailyRollingFileAppender
log4j.appender.file.DatePattern=yyyy-MM-dd
log4j.appender.file.File=logs/log.log
log4j.appender.file.Append=true
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern= - (%r ms) - %d{yyyy-M-d HH:mm:ss}%x[%5p](%F:%L) %m%n

最后编写测试类,测试代码分别如下:

TestDao.java：

package org.lanqiao.test;

import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class TestDao{

    @Test
    public void testDao_findAll(){
        ApplicationContext ac=new ClassPathXmlApplicationContext("applicationContext.xml");

    }

}

TestService.java：

package org.lanqiao.test;

import org.junit.Test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class TestService{

    @Test
    public void testService_findAll(){
        ApplicationContext ac=new ClassPathXmlApplicationContext("applicationContext.xml");
p
    }

}

启动测试类进行测试。

cd /home/project/SSMDemoProject
mvn test

验证结果是否为 BUILD SUCCESS

启动 WEB 服务进行测试，查看程序是否正常以及控制台中是否有日志记录输出， 项目目录下是否有 logs 目录产生。

cd /home/project/SSMDemoProject
mvn tomcat7:run

到此就完成了实验项目基础环境搭建工作，SSM 整合有着大同小异的步骤，通过多次重复的练习可以提高熟练度并有助于理解各组件的关系。