SSM 框架搭建 web 项目的思路整理

一、SSM框架

SSM 框架是三个框架的简称：spring，springMVC，MyBatis

1、Spring

Spring 是一个开源框架，一个轻量级的，非侵入的 JEE 框架，两个核心概念：控制反转（IoC）和面向切面编程（AOP）。控制反转就是把主动权交给容器，以前我们要使用一个类的对象时要new一下，比如：Person person = new Person()，而现在是把类注入到 Spring 中，由容器来控制，当我们需要一个对象时，直接由容器提供，通过注解使用时，非常方便。AOP 则提供了从另一个角度来考虑程序结构的思想。

2、SpringMVC

SpringMVC 是基于 Spring 的轻量级 WEB 层框架，实现了 MVC 模式来很好的把数据、业务和表示层分离。SpringMVC 的设计是围绕 DispatcherServlet 展开的，通过这个核心的 servlet 映射到相应的处理器来处理请求，并转到相对应的视图。

3、MyBatis

MyBatis 是一个基于Java的持久层框架。MyBatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的 entity（普通的 Java对象，实体类）映射成数据库中的记录。

三者的整合

三者的整合，其实质上是 Spring 整合 SpringMVC，Spring 整合 MyBatis，以 Spring 为核心，整合天下。理清了三者的关系，就好办了。

项目包结构

如何通过 SSM 框架搭建一个 web 项目呢，现在结合一个 Demo，用代码帮助理清一下项目的构建思路：
Demo的环境: JDK1.8，maven3.5，Spring4.1.5，MyBatis3.2.8，
IDE: MyEclipse
数据库: MySQL
使用maven构建项目，其结构目录如下：

ssm

基本包结构：项目构建时，应至少包含这些包

包名	作用
cn.demo.common	公用包，可放通用的类，如工具类
cn.demo.controllers	控制器包
cn.demo.dao	dao接口，和mapper.xml
cn.demo.entity	实体类，对应着数据表
cn.demo.service	业务接口
cn.demo.service.impl	业务实现类
src/main/resources	maven默认的资源包，放配置文件或资源

二、导入依赖的jar包

使用 maven 的一个好处就是管理 jar 包非常方便，添加一个依赖就可以了；另外还有一个好处，当你在写代码的时候，想查看一下源码，又没有下载源码包，此时，maven 会自动从仓库下载并关联。

在 pom.xml 中加入以下依赖：

    <!-- 用来设置版本号 -->
    <properties>
        <srping.version>4.1.5.RELEASE</srping.version>
        <mybatis.version>3.2.8</mybatis.version>
        <log4j.version>1.2.17</log4j.version>
    </properties>

    <dependencies>
        <dependency>
            <!-- servlet-api -->
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
        </dependency>

        <!-- spring框架包 start -->  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-test</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-core</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-oxm</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-tx</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-jdbc</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-aop</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-context</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-context-support</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-expression</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-orm</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-web</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-webmvc</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <dependency>  
            <groupId>org.springframework</groupId>  
            <artifactId>spring-aspects</artifactId>  
            <version>${srping.version}</version>  
        </dependency>  
        <!-- spring框架包 end --> 



        <!-- myBatis -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>${mybatis.version}</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.35</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.2.2</version>
        </dependency>

        <!-- mybatis generator自动生成代码的插件 -->
        <dependency>
            <groupId>org.mybatis.generator</groupId>
            <artifactId>mybatis-generator-core</artifactId>
            <version>1.3.2</version>
        </dependency>


        <!-- 导入dbcp的jar包，用来在spring.xml中配置数据库 -->
        <dependency>
            <groupId>commons-dbcp</groupId>
            <artifactId>commons-dbcp</artifactId>
            <version>1.4</version>
        </dependency>

        <!-- 文件上传 -->
        <dependency>
            <groupId>commons-fileupload</groupId>
            <artifactId>commons-fileupload</artifactId>
            <version>1.2.2</version>
        </dependency>

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

        <!-- jstl包 -->
        <dependency>
            <groupId>jstl</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>

        <dependency>
            <groupId>taglibs</groupId>
            <artifactId>standard</artifactId>
            <version>1.1.2</version>
        </dependency>

        <!-- jackson包 -->
        <dependency>
            <groupId>org.codehaus.jackson</groupId>
            <artifactId>jackson-core-asl</artifactId>
            <version>1.9.11</version>
        </dependency>
        <dependency>
            <groupId>org.codehaus.jackson</groupId>
            <artifactId>jackson-mapper-asl</artifactId>
            <version>1.9.11</version>
        </dependency>


        <!-- log4j -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>${log4j.version}</version>
        </dependency>

        <!-- junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.0</version>
            <!-- 表示开发的时候引入，发布的时候不会加载此包 -->  
      <scope>test</scope> 
        </dependency>

    </dependencies>

三、配置 web.xml

web 项目的第一件事就是配置 web.xml，为便于理清思路，以及 SSM 三者之间的联系是如何配置的，这里就用 spring.xml、springMVC.xml、mybatis.xml 命名三者的配置文件名，熟悉框架之后，这些配置可以合并或是拆分成多个配置文件，看项目的需要和个人的习惯。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://xmlns.jcp.org/xml/ns/javaee"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
    version="3.1">
    <display-name>ssmdemo</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>

        <!-- 加载 spring 配置文件  -->
    <context-param>
       <param-name>contextConfigLocation</param-name>
       <param-value>classpath:spring.xml</param-value>
    </context-param>
    <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

        <!-- 配置 springMVC 前端控制器  -->
    <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:springMVC.xml
          </param-value>
       </init-param>
    </servlet>
    <servlet-mapping>
       <servlet-name>dispatcherServlet</servlet-name>
       <url-pattern>/</url-pattern>
    </servlet-mapping>

        <!-- 编码过滤器  -->
    <filter>
       <filter-name>charSetEncoding</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>charSetEncoding</filter-name>
       <url-pattern>/*</url-pattern>
    </filter-mapping>

</web-app>

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

    <!-- 使用注解式注入 -->  
    <context:component-scan base-package="cn.demo"/>

      <!-- 引入配置文件 -->  
    <bean id="propertyConfigurer"  
        class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">  
        <property name="location" value="classpath:database.properties" />  
    </bean>  

    <!-- 配置数据源 -->
    <bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="${jdbc.driver}"/>
        <property name="url" value="${jdbc.connection.url}"/>
        <property name="username" value="${jdbc.connection.username}"/>
        <property name="password" value="${jdbc.connection.password}"/>
    </bean>

    <!-- sqlSessionFactory 对象 spring 和 MyBatis 完美整合 -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <property name="configLocation" value="classpath:myBatisConfig.xml"/>
    </bean>

    <!-- 事务管理 -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <!-- 增强 -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
        <!--    <tx:method name="login" read-only="true"/> -->
            <tx:method name="get*" read-only="true"/>
            <tx:method name="*" propagation="REQUIRED" rollback-for="java.lang.Throwable"/>
        </tx:attributes>
    </tx:advice>


    <!-- AOP支持 -->
    <aop:config>
        <aop:pointcut expression="execution(* cn.demo.service..*(..))" id="tx_pc"/>
        <aop:advisor advice-ref="txAdvice" pointcut-ref="tx_pc"/>
    </aop:config>
    <!-- 代理 -->
    <aop:aspectj-autoproxy proxy-target-class="true"/>

    <!-- mapper 映射  DAO接口所在包名，Spring会自动查找其下的类 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="cn.demo.dao"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    </bean>

</beans>

springMVC.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    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
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.2.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">


       <!-- 设置注解支持,扫描带有注解类的包 -->
       <context:component-scan base-package="cn.demo.controllers,cn.demo.service.impl" />
       <mvc:annotation-driven />


       <!-- 视图解析器 -->
       <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver" >
            <!-- 属性名name,属性值value ,给class类的对象中的属性赋值 -->
            <property name="prefix" value="/WEB-INF/jsp/"></property>
            <property name="suffix" value=".jsp"></property>
       </bean>

        <!-- 处理静态资源文件 -->
        <mvc:resources location="/static/" mapping="/static/**" />


        <!-- 文件上传解析器 -->
        <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" >
        </bean>

</beans>

mybatis.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">
<configuration>
    <!-- 类型别名 -->
    <typeAliases>
      <typeAlias type="cn.demo.entity.District" alias="District"/>
    </typeAliases> 

    <mappers>
        <mapper resource="cn/demo/dao/DistrictMapper.xml"/>
    </mappers>

</configuration>

database.properties

数据库的基本配置

jdbc.driver=org.gjt.mm.mysql.Driver
jdbc.connection.url=jdbc:mysql://127.0.0.1:3306/china
jdbc.connection.username=root
jdbc.connection.password=root

log4j.properties

简单的日志输出，只定义的控制台输出

log4j.rootLogger=DEBUG, stdout
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%-5p %d{yyyy\u5E74MM\u6708dd\u65E5 HH\:mm\:ss,SSS}---[%t]---%m%n

generatorConfig.xml

generatorConfig.xml 是 mybatis 自动生成代码的一个配置文件，
使用mybatis-generator自动关联生成代码mapper接口,xml文件,entity类

<?xml version="1.0" encoding="UTF-8" ?>
<!-- generatorConfig.xml名字是默认的，运行run as 配置里写上 mybatis-generator:generate，即可生成代码 -->
    <!DOCTYPE generatorConfiguration 
      PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
      "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

<generatorConfiguration>
<!-- 数据库驱动-->  
    <classPathEntry
        location="/Users/jason/.m2/repository/mysql/mysql-connector-java/5.1.35/mysql-connector-java-5.1.35.jar" />
    <context id="mysqlTables" targetRuntime="MyBatis3">

        <commentGenerator>
         <!-- 是否去除自动生成的注释 true：是 ： false:否 -->  
            <property name="suppressAllComments" value="true" />
        </commentGenerator>

         <!--数据库链接URL，用户名、密码 -->    
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
            connectionURL="jdbc:mysql://localhost:3306/china"
            userId="root" password="root">
        </jdbcConnection>

        <javaTypeResolver>
            <property name="forceBigDecimals" value="false" />
        </javaTypeResolver>

         <!-- 生成model模型，对应的包，存放位置可以指定具体的路径,如/ProjectName/src，也可以使用MAVEN来自动生成 -->
        <javaModelGenerator targetPackage="cn.demo.entity"
            targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
            <property name="trimStrings" value="true" />
        </javaModelGenerator>

         <!--对应的xml mapper文件  -->
        <sqlMapGenerator targetPackage="cn.demo.dao" targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
        </sqlMapGenerator>

        <!-- 对应的dao接口 -->
        <javaClientGenerator type="XMLMAPPER"
            targetPackage="cn.demo.dao" targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
        </javaClientGenerator>

         <!-- 这里是数据库的tableName表名j_position 以及 entity类的domainObjectName名字District -->
         <!-- 默认生成增加\删除\修改\查询的方法 -->
        <table tableName="j_position" domainObjectName="District"

            enableCountByExample="false" enableSelectByExample="false"
            enableUpdateByExample="false" enableDeleteByExample="false">
        </table>
    </context>
</generatorConfiguration>

完善各个包文件目录下的代码

至此，web框架已经搭建好了，包结构也建好了，下面就把业务代码完成就可以测试了。

flow

项目的访问流程是这样的：

用户从浏览器发出请求，SpringMVC 的核心 DispatcherServlet 接收到请求后，通过映射处理器找到相应的处理器去处理请求。也就是在 Controller 类里，如果要访问数据库，就在 Controller 里调用 Service 层的方法，再在 Service 层里调用 DAO 层的方法，一层一层通过接口调用。

DispatcherServlet只做任务的分派，具体业务的处理是在 Service 层， DAO 层只对数据库。用框架或是不用框架的流程都是这样的，使用了框架可以使代码结构更加清晰，框架封装了很多实现的方法，调用也很方便，省去了大量与业务关的代码，可以让我们更加关注于功能的实现。

发起请求

URL : `http://localhost:8080/工程名/index`

接收请求

创建SpringMVC核心配置文件创建SpringMVC.xml

将URL与控制器进行映射，建议使用注解方式
- 在controller类前使用注解@Controller标注该类为控制器类
- 在该类方法前是使用@RequestMapping将URL与该方法映射
- 在配置文件dispatcher-servlet.xml中设置注解支持
在web.xml中配置核心控制器

处理请求

接收请求的参数值
1) 需要将参数入参,使用单个参数接收
2) 需要将对象入参,使用对象接收
调用业务层的方法处理数据，在业务层中调用 DAO 层的方法来处理数据
存储数据
1) 将Model对象入参
2) 调用model对象的addAttribute(“”,”“);
页面跳转
1) 重定向
redirect:xxxx,如果不加redirect,则如果使用了视图解析器,则认为返回的是逻辑视图名
2) 转发
返回viewName逻辑视图名,也就是jsp文件的文件名
视图解析器会根据返回的逻辑视图名给加上前缀和后缀

四、部署运行

部署到 tomcat, 运行并访问。
这里写了一个简单的例子，只做了一个分页，代码比较简单，就不做分享了，有兴趣可以自己写一下。
run