SSM从0开始构建一个项目

本篇文章我们使用SSM框架(Spring + SpringMVC + MyBatis)从0开始构建一个项目，先来看看项目示意图：

看起来相当简单的一个小demo，但涉及到的知识点可不少，我们应该把重心放到SSM框架之间的整合上，对于这个项目，你需要有SSM框架、jQuery、ajax、bootstrap、maven等基础。

搭建基础环境

这里我们使用idea进行开发，首先创建一个maven项目：

给项目起个名字并指定路径：

然后点击Finish即可。

项目创建完成后，来到pom.xml文件，添加相应的依赖，我们需要添加以下依赖：

• SpringMVC
• Spring JDBC
• Spring AOP
• MyBatis
• PageHelper
• C3P0
• mysql的驱动
• JSTL
• Servlet-API
• MybatisGenerator
• Junit

<dependencies>
    
    
    <dependency>
      <groupId>org.springframeworkgroupId>
      <artifactId>spring-webmvcartifactId>
      <version>4.3.7.RELEASEversion>
    dependency>

    
    
    <dependency>
      <groupId>org.springframeworkgroupId>
      <artifactId>spring-jdbcartifactId>
      <version>4.3.7.RELEASEversion>
    dependency>

    
    
    <dependency>
      <groupId>org.springframeworkgroupId>
      <artifactId>spring-aspectsartifactId>
      <version>4.3.7.RELEASEversion>
    dependency>

    
    
    <dependency>
      <groupId>org.mybatisgroupId>
      <artifactId>mybatisartifactId>
      <version>3.4.2version>
    dependency>

    
    
    <dependency>
      <groupId>org.mybatisgroupId>
      <artifactId>mybatis-springartifactId>
      <version>1.3.1version>
    dependency>

    
    <dependency>
      <groupId>com.github.pagehelpergroupId>
      <artifactId>pagehelperartifactId>
      <version>5.0.0version>
    dependency>

    
    
    <dependency>
      <groupId>c3p0groupId>
      <artifactId>c3p0artifactId>
      <version>0.9.1.2version>
    dependency>

    
    
    <dependency>
      <groupId>mysqlgroupId>
      <artifactId>mysql-connector-javaartifactId>
      <version>5.1.41version>
    dependency>

    
    
    <dependency>
      <groupId>javax.servletgroupId>
      <artifactId>jstlartifactId>
      <version>1.2version>
    dependency>


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

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

    
    <dependency>
      <groupId>junitgroupId>
      <artifactId>junitartifactId>
      <version>4.12version>
    dependency>
  dependencies>

依赖添加完后，我们需要对项目进行配置：

在弹出的选项框中下拉找到Spring和SpringMVC，勾选上即可：

此时idea会自动帮助我们创建出Spring和SpringMVC的配置文件，并在web.xml中进行了配置：

来看看web.xml文件：

这是idea帮助我们配置的，我们对其进行一些修改，通常我们都将Spring的配置文件放在类路径下，这里我们修改一下：

在main目录上右击新建文件夹：

在弹出的选项框中选择resources，需要注意的是创建后的resources文件夹的右下角必须有一个标识，否则idea是不会识别的：

现在我们把applicationContext.xml文件移动到这里：

相应的，web.xml文件就得做出修改，修改如下：

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

    
    
    <context-param>
        <param-name>contextConfigLocationparam-name>
        <param-value>classpath:applicationContext.xmlparam-value>
    context-param>

    
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListenerlistener-class>
    listener>

    
    
    <servlet>
        <servlet-name>dispatcherservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        <load-on-startup>1load-on-startup>
    servlet>

    
    <servlet-mapping>
        <servlet-name>dispatcherservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>

    
    <filter>
        <filter-name>CharacterEncodingFilterfilter-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>forceRequestEncodingparam-name>
            <param-value>trueparam-value>
        init-param>
        <init-param>
            <param-name>forceResponseEncodingparam-name>
            <param-value>trueparam-value>
        init-param>
    filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>

    
    <filter>
        <filter-name>HiddenHttpMethodFilterfilter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilterfilter-class>
    filter>
    <filter-mapping>
        <filter-name>HiddenHttpMethodFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>
    <filter>
        <filter-name>HttpPutFormContentFilterfilter-name>
        <filter-class>org.springframework.web.filter.HttpPutFormContentFilterfilter-class>
    filter>
    <filter-mapping>
        <filter-name>HttpPutFormContentFilterfilter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>
web-app>

这里除了配置Spring启动容器和前端控制器外，还配置了字符编码过滤器和隐藏方法过滤器，具体作用在注释中已经写了。

接下来就是对对SpringMVC进行配置了，但是在配置之前，我们需要将包结构搭建出来：
在main目录下新建java目录，操作方法与创建resources目录是一样的：

然后搭建一下包结构：

对dispatcher-servlet.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:mvc="http://www.springframework.org/schema/mvc"
       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.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    

    
    <context:component-scan base-package="com.wwj" use-default-filters="false">
        
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    context:component-scan>

    
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/views/"/>
        <property name="suffix" value=".jsp"/>
    bean>

    
    <mvc:default-servlet-handler/>

    
    <mvc:annotation-driven >
        
        <mvc:message-converters register-defaults="true">
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <property name="supportedMediaTypes" value="text/plain;charset=UTF-8"/>
            bean>
        mvc:message-converters>
    mvc:annotation-driven>
beans>

对于SpringMVC的配置比较简单，配置了视图解析器和消息转换器，消息转换器是为了防止中文乱码的；这里需要注意的一点是，由于Spring和SpringMVC都会去扫描我们的包，为了防止某些包被重复扫描，我们需要对两个框架进行分工，让SpringMVC只扫描控制器包，而让Spring扫描除控制器包外的其它包。

对Spring的配置文件进行配置(applicationContext.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.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd http://www.springframework.org/schema/cache http://www.springframework.org/schema/cache/spring-cache.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd">

    

    
    <context:component-scan base-package="com.wwj">
        
        <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    context:component-scan>

    
    <context:property-placeholder location="classpath:dbconfig.properties"/>

    
    <bean id="pooledDataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
        <property name="jdbcUrl" value="${jdbc.jdbcUrl}"/>
        <property name="driverClass" value="${jdbc.driverClass}"/>
        <property name="user" value="${jdbc.user}"/>
        <property name="password" value="${jdbc.password}"/>
    bean>

    
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        
        <property name="configLocation" value="classpath:mybatis-config.xml"/>
        <property name="dataSource" ref="pooledDataSource"/>
        
        <property name="mapperLocations" value="classpath:mapper/*.xml"/>
    bean>

    
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        
        <property name="basePackage" value="com.wwj.crud.dao"/>
    bean>

    
    <bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
        <constructor-arg name="sqlSessionFactory" ref="sqlSessionFactory"/>
        <constructor-arg name="executorType" value="BATCH"/>
    bean>

    
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="pooledDataSource"/>
    bean>

    
    
    <tx:advice id="txAdvice">
        <tx:attributes>
            
            <tx:method name="*"/>
            
            <tx:method name="get*" read-only="true"/>
        tx:attributes>
    tx:advice>
    <aop:config>
        
        <aop:pointcut id="txPointCut" expression="execution(* com.wwj.crud.service..*(..))"/>
        
        <aop:advisor advice-ref="txAdvice" pointcut-ref="txPointCut"/>
    aop:config>
beans>

这里Spring配置文件的内容，都是些基础配置，注释也写得很清楚了。

需要注意的就是在对Mybatis与Spring进行整合的配置中指定了Mybatis配置文件和mapper文件的位置：

我们把它们都放在resources目录下。

下面是dbconfig.properties文件：

jdbc.jdbcUrl=jdbc:mysql://localhost:3306/ssm_crud
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.user=root
jdbc.password=123456

这样Spring和SpringMVC就配置完成了，接下来对Mybatis全局配置文件进行配置：

<configuration>

    
    <settings>
        
        <setting name="mapUnderscoreToCamelCase" value="true"/>
    settings>

    
    <typeAliases>
        <package name="com.wwj.crud.bean"/>
    typeAliases>

    
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageInterceptor">plugin>
    plugins>

configuration>

由于我们将Mybatis和Spring进行了整合，所以全局配置文件的配置极其简单，开启驼峰命名规则映射和别名设置即可，

接下来设计一下数据表：

CREATE TABLE tbl_dept (
  dept_id int(11) NOT NULL AUTO_INCREMENT,
  dept_name varchar(255) NOT NULL,
  PRIMARY KEY (dept_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8

CREATE TABLE tbl_emp (
  emp_id int(11) NOT NULL AUTO_INCREMENT,
  emp_name varchar(255) NOT NULL,
  gender char(1) DEFAULT NULL,
  email varchar(255) DEFAULT NULL,
  d_id int(11) DEFAULT NULL,
  PRIMARY KEY (emp_id),
  KEY fk_emp_dept (d_id),
  CONSTRAINT fk_emp_dept FOREIGN KEY (d_id) REFERENCES tbl_dept (dept_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8

这里创建了一张员工表和部门表，其中员工表的d_id属性与部门表的dept_id属性形成外键约束。

对于mapper文件和Mapper接口的编写，我们全部交给MybatisGenerator。

在项目下新建MGB.xml文件，并作如下配置：

<generatorConfiguration>

    <context id="DB2Tables" targetRuntime="MyBatis3">
        <commentGenerator>
            <property name="suppressAllComments" value="true" />
        commentGenerator>
        
        <jdbcConnection driverClass="com.mysql.jdbc.Driver"
                        connectionURL="jdbc:mysql://localhost:3306/ssm_crud" userId="root"
                        password="123456">
        jdbcConnection>

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

        
        <javaModelGenerator targetPackage="com.wwj.crud.bean"
                            targetProject=".\src\main\java">
            <property name="enableSubPackages" value="true" />
            <property name="trimStrings" value="true" />
        javaModelGenerator>

        
        <sqlMapGenerator targetPackage="mapper" targetProject=".\src\main\resources">
            <property name="enableSubPackages" value="true" />
        sqlMapGenerator>

        
        <javaClientGenerator type="XMLMAPPER"
                             targetPackage="com.wwj.crud.dao" targetProject=".\src\main\java">
            <property name="enableSubPackages" value="true" />
        javaClientGenerator>


        
        <table tableName="tbl_emp" domainObjectName="Employee">table>
        <table tableName="tbl_dept" domainObjectName="Department">table>
    context>
generatorConfiguration>

如果你的包名跟我不一样，就需要修改一下相应的包名，千万不要把配置文件内容直接复制粘贴过去就不管了。

然后新建测试文件，执行如下代码：

public class MBGTest {
    public static void main(String[] args) throws Exception{
        List<String> warnings = new ArrayList<String>();
        boolean overwrite = true;
        File configFile = new File("mbg.xml");
        ConfigurationParser cp = new ConfigurationParser(warnings);
        Configuration config = cp.parseConfiguration(configFile);
        DefaultShellCallback callback = new DefaultShellCallback(overwrite);
        MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
        myBatisGenerator.generate(null);
    }
}

执行完成后，所以的Bean类、Mapper接口和mapper配置文件就都自动创建了，我们还需要对EmployeeMapper.xml文件进行修改，因为它自动生成的sql是没有联合查询的，由于配置文件内容过多，这里就不单独粘贴出来了。

页面搭建

到这里基本的环境就搭建完成，接下来就是页面的搭建，这里我们借助BootStrap来快速生成一个美观的页面，来到BootStrap中文网下载BootStrap：

下载完成后和jQuery一起直接放到webapp目录下：

我们知道， 如果直接访问http:/localhost:8080/ssm会自动访问index.jsp文件，所以我们让其直接转发至其它页面:

<%--
  Created by IntelliJ IDEA.
  User: Administrator
  Date: 2020/8/17 0017
  Time: 20:10
  To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<jsp:forward page="/emps"></jsp:forward>
<html>
<head>
</head>
<body>
</body>
</html>

关于页面的操作内容比较多，而且讲起来也非常不方便，这里直接略过，我们开始配置tomat。

运行项目

点击右上角的Configuration：

在弹出的对话框中点击左上角的加号，找到本地tomcat：

如果你没有配置过tomcat，就点击上面的Configure进行配置，然后点击下面的Fix：

点击加号选择Artifact…：

选择ok即可：

然后直接运行tomcat就可以访问项目了。

小结

本篇文章的目的是对SSM框架进行整合，让大家对一个完整的项目有一个清晰的思路去设计、去编写，所以对于代码的细节并没有做过多讲解，项目中用到的也是一些非常基础的框架技术。

本项目已部署到云服务器，大家可以点击下方链接查看：
http://124.71.156.157:8080/ssm/

项目源代码(含sql文件)：https://download.csdn.net/download/qq_42453117/12727651

源码已上传至GitHub，欢迎Star：
https://github.com/blizzawang/SSM_CRUD