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构建项目，其结构目录如下：

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

包名	作用
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.RELEASEsrping.version>
        <mybatis.version>3.2.8mybatis.version>
        <log4j.version>1.2.17log4j.version>
    properties>

    <dependencies>
        <dependency>
            
            <groupId>javax.servletgroupId>
            <artifactId>javax.servlet-apiartifactId>
            <version>3.1.0version>
        dependency>

          
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-testartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-coreartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-oxmartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-txartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-jdbcartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-aopartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-contextartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-context-supportartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-expressionartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-ormartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-webartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-webmvcartifactId>  
            <version>${srping.version}version>  
        dependency>  
        <dependency>  
            <groupId>org.springframeworkgroupId>  
            <artifactId>spring-aspectsartifactId>  
            <version>${srping.version}version>  
        dependency>  
         



        
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatisartifactId>
            <version>${mybatis.version}version>
        dependency>
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>5.1.35version>
        dependency>
        <dependency>
            <groupId>org.mybatisgroupId>
            <artifactId>mybatis-springartifactId>
            <version>1.2.2version>
        dependency>

        
        <dependency>
            <groupId>org.mybatis.generatorgroupId>
            <artifactId>mybatis-generator-coreartifactId>
            <version>1.3.2version>
        dependency>


        
        <dependency>
            <groupId>commons-dbcpgroupId>
            <artifactId>commons-dbcpartifactId>
            <version>1.4version>
        dependency>

        
        <dependency>
            <groupId>commons-fileuploadgroupId>
            <artifactId>commons-fileuploadartifactId>
            <version>1.2.2version>
        dependency>

        <dependency>
            <groupId>commons-iogroupId>
            <artifactId>commons-ioartifactId>
            <version>2.4version>
        dependency>

        
        <dependency>
            <groupId>jstlgroupId>
            <artifactId>jstlartifactId>
            <version>1.2version>
        dependency>

        <dependency>
            <groupId>taglibsgroupId>
            <artifactId>standardartifactId>
            <version>1.1.2version>
        dependency>

        
        <dependency>
            <groupId>org.codehaus.jacksongroupId>
            <artifactId>jackson-core-aslartifactId>
            <version>1.9.11version>
        dependency>
        <dependency>
            <groupId>org.codehaus.jacksongroupId>
            <artifactId>jackson-mapper-aslartifactId>
            <version>1.9.11version>
        dependency>


        
        <dependency>
            <groupId>log4jgroupId>
            <artifactId>log4jartifactId>
            <version>${log4j.version}version>
        dependency>

        
        <dependency>
            <groupId>junitgroupId>
            <artifactId>junitartifactId>
            <version>4.0version>
              
      <scope>testscope> 
        dependency>

    dependencies>

三、配置 web.xml

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

<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>ssmdemodisplay-name>
    <welcome-file-list>
        <welcome-file>index.htmlwelcome-file>
        <welcome-file>index.htmwelcome-file>
        <welcome-file>index.jspwelcome-file>
        <welcome-file>default.htmlwelcome-file>
        <welcome-file>default.htmwelcome-file>
        <welcome-file>default.jspwelcome-file>
    welcome-file-list>

        
    <context-param>
       <param-name>contextConfigLocationparam-name>
       <param-value>classpath:spring.xmlparam-value>
    context-param>
    <listener>
      <listener-class>org.springframework.web.context.ContextLoaderListenerlistener-class>
    listener>

        
    <servlet>
       <servlet-name>dispatcherServletservlet-name>
       <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
       <init-param>
          <param-name>contextConfigLocationparam-name>
          <param-value>classpath:springMVC.xml
          param-value>
       init-param>
    servlet>
    <servlet-mapping>
       <servlet-name>dispatcherServletservlet-name>
       <url-pattern>/url-pattern>
    servlet-mapping>

        
    <filter>
       <filter-name>charSetEncodingfilter-name>
       <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
       <init-param>
           <param-name>encodingparam-name>
           <param-value>utf-8param-value>
       init-param>
       <init-param>
           <param-name>forceEncodingparam-name>
           <param-value>trueparam-value>
       init-param>
    filter>
    <filter-mapping>
       <filter-name>charSetEncodingfilter-name>
       <url-pattern>/*url-pattern>
    filter-mapping>

web-app>

spring.xml

<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>

    
    <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="get*" read-only="true"/>
            <tx:method name="*" propagation="REQUIRED" rollback-for="java.lang.Throwable"/>
        tx:attributes>
    tx:advice>


    
    <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"/>

    
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="cn.demo.dao"/>
        <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/>
    bean>

beans>

springMVC.xml

<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" >
            
            <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

<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类

    

<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>
           
            <property name="suppressAllComments" value="true" />
        commentGenerator>

             
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
            connectionURL="jdbc:mysql://localhost:3306/china"
            userId="root" password="root">
        jdbcConnection>

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

         
        <javaModelGenerator targetPackage="cn.demo.entity"
            targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
            <property name="trimStrings" value="true" />
        javaModelGenerator>

         
        <sqlMapGenerator targetPackage="cn.demo.dao" targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
        sqlMapGenerator>

        
        <javaClientGenerator type="XMLMAPPER"
            targetPackage="cn.demo.dao" targetProject="src/main/java">
            <property name="enableSubPackages" value="true" />
        javaClientGenerator>

         
         
        <table tableName="j_position" domainObjectName="District"

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

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

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

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

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

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

发起请求

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

接收请求

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

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

处理请求

1. 接收请求的参数值
   1) 需要将参数入参,使用单个参数接收
   2) 需要将对象入参,使用对象接收
2. 调用业务层的方法处理数据，在业务层中调用 DAO 层的方法来处理数据

3. 存储数据
   1) 将Model对象入参
   2) 调用model对象的addAttribute(“”,”“);

4. 页面跳转
   1) 重定向
   redirect:xxxx,如果不加redirect,则如果使用了视图解析器,则认为返回的是逻辑视图名
   2) 转发
   返回viewName逻辑视图名,也就是jsp文件的文件名
   视图解析器会根据返回的逻辑视图名给加上前缀和后缀

四、部署运行

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