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

13292
<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框架已经搭建好了，包结构也建好了，下面就把业务代码完成就可以测试了。



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

用户从浏览器发出请求，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, 运行并访问。

这里写了一个简单的例子，只做了一个分页，代码比较简单，就不做分享了，有兴趣可以自己写一下。