ssm三大框架进行整合，快速搭建一个web项目

本章节主要介绍在idea开发工具上如何使用maven搭建一个spring+springmvc+mybatis的web项目

新建

打开 IDEA 工具，通过 File -> New -> Project，新建项目，或者直接在 IDEA 欢迎页面点击新建项目，过程如下图：

 

主要步骤包括：

• 选择 Maven 项目
• 设置 JDK
• 勾选“Create from archetype”
• 选择 “maven-archetype-webapp” 模板

名称、版本

点击“Next”之后则进入工程名称设置界面，如下图：

“GroupID”是项目组织唯一的标识符，实际对应 Java 的包结构，是 main 目录里 Java 的目录结构，由于这是我们的第一个 SSM 项目，就设置为 com.wcg.ssm.demo。

“ArtifactID”是项目的唯一的标识符，实际对应项目的名称，也就是项目根目录的名称，名为 ssm-demo。

Version 是项目版本号，IDEA 默认为 1.0-SNAPSHOT。

温馨提示：以上三个配置项的命名都可以根据个人习惯或者公司要求来做，是一个较为主观的事情。

Maven 目录设置

点击“Next”之后则进入 Maven 相关设置界面，设置过程如下图：

上面的步骤：

1. 选择你的maven的版本
2. 在选择你的maven的setting配置文件时需要先勾选上
3. 选择你maven的setting配置文件的路径

• Project name：项目的名称
• Project location：项目路径

点击Finish之后就完成了Maven项目的骨架

 

整合

pom.xml

首先是添加 Maven 依赖，生成的 Maven 工程中有“pom.xml”文件，POM 是项目对象模型（Project Object Model）的简称，它是 Maven 工程必不可少的文件，使用 XML 表示，该文件用于管理项目的依赖关系、开发者的信息和角色、组织信息、项目授权、项目的基础信息等等。

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

  <groupId>com.wcg.ssm.demo</groupId>
  <artifactId>ssm-demo</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>ssm-demo Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

    <spring.version>4.2.4.RELEASE</spring.version>
    <java.version>1.8</java.version>
    <jdbc.driver.version>5.1.38</jdbc.driver.version>
    <aspectj.version>1.7.4</aspectj.version>
    <javax.servlet-api.version>3.1.0</javax.servlet-api.version>
    <jsp-api.version>2.2</jsp-api.version>
    <jstl.version>1.2</jstl.version>
    <mybatis.version>3.2.5</mybatis.version>
    <mybatis-spring.version>1.2.2</mybatis-spring.version>
    <maven.test.skip>true</maven.test.skip>
  </properties>

  <dependencies>
    <!-- Begin: spring依赖 -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- End: spring依赖 -->

    <!-- Begin: springmvc依赖 -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${spring.version}</version>
    </dependency>
    <!-- End: springmvc依赖 -->

    <!-- Begin: mybatis依赖 -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>${mybatis.version}</version>
    </dependency>
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>${mybatis-spring.version}</version>
    </dependency>
    <!-- End: mybatis依赖 -->

    <!-- Begin: 数据库依赖包 -->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>${jdbc.driver.version}</version>
      <scope>runtime</scope>
    </dependency>
    <!-- End: 数据库依赖包 -->

    <!-- Begin: aspectj相关jar包-->
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjrt</artifactId>
      <version>${aspectj.version}</version>
    </dependency>
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjweaver</artifactId>
      <version>${aspectj.version}</version>
    </dependency>
    <!-- End: aspectj相关jar包-->

    <!-- Begin: Servlet相关依赖包 -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>${javax.servlet-api.version}</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>${jsp-api.version}</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>${jstl.version}</version>
    </dependency>
    <!-- End: Servlet相关依赖包 -->
  </dependencies>

  <build>
    <finalName>ssm-demo</finalName>
    <plugins>

      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.2</version>
        <configuration>
          <source>1.8</source>
          <target>1.8</target>
        </configuration>
      </plugin>

    </plugins>
  </build>
</project>

如果没有正常下载包的话需要点击下面的按钮：

 

完善项目结构

通过 Maven 骨架生成的项目结构只有 main 目录及其目录下的 webapp 目录，这两个目录并不完善，缺少了 java 目录和 resource 目录，因此需要在 main 目录新建这两个目录，过程如下：

main -> New -> Directory -> 新建 Java 目录

main -> New -> Directory -> 新建 Resources 目录

之后需要右键选择“Mark Directory as”，分别将 java 目录和 resource 目录设置为“源码根目录”和“配置文件目录”，过程如下图：

 

这样 ssm-demo 的基本目录结构就完成了，如下图所示：

接下来需要新建代码目录，如下所示：

controller ——控制层目录
dao        ——dao层目录
entiry     ——实体层目录
service    ——业务层目录
utiles     ——工具类目录

之后在 resources 目录下新建 mappers 目录用来存放 MyBatis 的 mapper 文件，整个项目的目录结构就完成了，如下所示：

ssm-demo                                ——项目名称
     ├── src/main/java                  ——Java 源码根目录
            ├── controller              ——控制层目录
            ├── dao                     ——dao层目录
            ├── entiry                  ——实体层目录
            ├── service                 ——业务层目录
                └── impl                ——业务实现类目录
            └── utiles                  ——工具类目录
     ├── src/main/resources             ——配置文件根目录
            └── mappers                 ——mapper文件目录
     ├── src/main/webapp                ——网站 Web 资源
     └── pom.xml                        ——pom文件

applicationContext.xml

Spring 的核心默认配置文件的名字叫做 applicationContext.xml，如有需要也可以自行修改此名称，此文件是用于指导 Spring 工厂进行 Bean 生产、依赖关系注入（装配）及 Bean 实例分发的“图纸”，在常见的 JavaWeb 开发中，Spring 配置文件通常有一套万能的流程模板，如下所示：

• 注解驱动的依赖性注入，自动扫描；
• 存储数据库信息；
• 加载数据源；
• 装配 sessionFactory；
• 整合 ORM 框架，如 MyBatis；
• 配置事务；
• 配置事务通知属性；
• 配置事务切面；
• 整合 MVC 框架，如 SpringMVC。

以下为 ssm-demo 的 Spring 配置文件：

<?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:context="http://www.springframework.org/schema/context"
       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.0.xsd
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd

        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">

    <!-- 自动扫描 -->
    <!-- Spring希望管理所有的业务逻辑组件，等。。。 -->
    <context:component-scan base-package="com.wcg.ssm">
        <context:exclude-filter type="annotation"
                                expression="org.springframework.stereotype.Controller" />
    </context:component-scan>

    <!-- 配置数据源 -->
    <bean id="dataSource"
          class="org.springframework.jdbc.datasource.DriverManagerDataSource">
        <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
        <property name="url"
                  value="jdbc:mysql://localhost:3306/mybatis"/>
        <!-- 改为你的地址即可 -->
        <property name="username" value="root"/>
        <property name="password" value="root"/>
    </bean>


    <!-- 配置mybatis的sqlSessionFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource"/>
        <!--mapperLocations: 指定mapper文件的位置-->
        <property name="mapperLocations" value="classpath:mappers/*.xml"></property>
        <!-- configLocation指定全局配置文件的位置 -->
        <property name="configLocation" value="classpath:mybatis-config.xml"></property>
    </bean>

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

    <!-- (事务管理)transaction manager, use JtaTransactionManager for global tx -->
    <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="insert*" propagation="REQUIRED"/>
            <tx:method name="update*" propagation="REQUIRED"/>
            <tx:method name="upd*" propagation="REQUIRED"/>
            <tx:method name="edit*" propagation="REQUIRED"/>
            <tx:method name="save*" propagation="REQUIRED"/>
            <tx:method name="add*" propagation="REQUIRED"/>
            <tx:method name="new*" propagation="REQUIRED"/>
            <tx:method name="set*" propagation="REQUIRED"/>
            <tx:method name="remove*" propagation="REQUIRED"/>
            <tx:method name="delete*" propagation="REQUIRED"/>
            <tx:method name="del*" propagation="REQUIRED"/>
            <tx:method name="change*" propagation="REQUIRED"/>
            <tx:method name="check*" propagation="REQUIRED"/>
            <tx:method name="get*" propagation="REQUIRED" read-only="true"/>
            <tx:method name="search*" propagation="REQUIRED" read-only="true"/>
            <tx:method name="find*" propagation="REQUIRED" read-only="true"/>
            <tx:method name="load*" propagation="REQUIRED" read-only="true"/>
            <tx:method name="*" propagation="REQUIRED" read-only="true"/>
        </tx:attributes>
    </tx:advice>

    <!-- 配置事务切面 -->
    <aop:config>
        <aop:pointcut id="serviceOperation"
                      expression="(execution(* com.wcg.ssm.service.*.*(..)))"/>
        <aop:advisor advice-ref="txAdvice" pointcut-ref="serviceOperation"/>
    </aop:config>

    <!--
        xml配置与注解配置都执行，默认顺序谁先加载谁先执行，指定执行顺序 添加order参数
        建议：
        应该先执行xml 后 执行注解
        xml 配置的是统一的。但是可能我想在具体的方法里搞特殊，就自己加注解
    -->
    <!-- 开启基于注解的事务 -->
    <tx:annotation-driven transaction-manager="transactionManager"></tx:annotation-driven>

</beans>

mybatis-config.xml

mybatis-config.xml 是 MyBatis 的核心配置文件，MyBatis 的相关配置都写在这个文件里，这里只做了简单的别名配置。

<?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>
        <package name="com.wcg.ssm.entity"/>
    </typeAliases>
</configuration>

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

    <!-- 使用注解的包，包括子集 -->
    <context:component-scan base-package="com.wcg.ssm.controller"/>

    <!-- 视图解析器 -->
    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/"/>
        <property name="suffix" value=".jsp"></property>
    </bean>
</beans>

web.xml

关于三大框架的配置文件已创建且配置完成，想使得这些配置生效的话还需要一步操作，就是在 web.xml 中加入框架的设置语句，web.xml 文件是 Java web 项目中的一个配置文件，主要用于配置欢迎页、Filter、Listener、Servlet 等，ssm-demo 工程的 web.xml配置文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         id="WebApp_ID" version="2.5">
  <display-name>ssm-demo</display-name>


  <!--Start 欢迎页-->
  <welcome-file-list>
    <welcome-file>index.jsp</welcome-file>
  </welcome-file-list>
  <!--End 欢迎页-->

  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath:applicationContext.xml</param-value>
  </context-param>

  <!--Start 编码过滤器 解决乱码问题-->
  <filter>
    <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>
  </filter>
  <filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <!--End 编码过滤器 解决乱码问题-->

  <!--Start spring监听器 -->
  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>
  <!--End Start spring监听器 -->

  <!--Start spring mvc servlet-->
  <servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring-mvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <!--End spring mvc servlet-->

  <!--Start servlet-mapping -->
  <servlet-mapping>
    <servlet-name>springMVC</servlet-name>
    <url-pattern>*.do</url-pattern>
  </servlet-mapping>
  <!--End servlet-mapping -->

</web-app>

此配置文件主要定义了：

• 工程基本信息：名字、描述（display-name 和 description 标签)；
• 声明应用范围内的初始化参数（context-param标签)；
• 过滤器配置（Filter 标签，如编码过滤器）；
• 监听器配置（Listener 标签）；
• servlet配置（servlet 标签，如 SpringMVC）；
• 欢迎页面（welcome-file-list 标签，index.jsp 页面）。

以上即是一些通用的文件配置，当然还有诸如错误页面配置（error-page 标签）、安全限制配置（security-constraint 标签），以后如果用到的话再进行介绍。

到这里，配置已经完成了，目前 ssm-demo 的目录结构如下：

构建

项目骨架生成且配置完成后，则需要进行构建验证了，通过 IDEA 右边的 Maven 工具栏来进行构建，双击“clean”和“package”按钮即可:

可以看到已经生成了 target 目录已经有“ssm-demo.war”文件，这个 war 包文件可以直接部署，ssm-demo 作为教程的第一个项目还不是很完善，只有一个 JSP 页面可以看，因为还没有开始编写业务代码。