SSM从0开始构建一个项目

2022-01-10 15:42:29 浏览数 (1)

本篇文章我们使用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
代码语言:javascript复制
<dependencies>
    <!-- SpringMVC -->
    <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.7.RELEASE</version>
    </dependency>

    <!-- Spring JDBC -->
    <!-- https://mvnrepository.com/artifact/org.springframework/spring-jdbc -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>4.3.7.RELEASE</version>
    </dependency>

    <!-- Spring AOP -->
    <!-- https://mvnrepository.com/artifact/org.springframework/spring-aspects -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aspects</artifactId>
      <version>4.3.7.RELEASE</version>
    </dependency>

    <!-- Mybatis -->
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.4.2</version>
    </dependency>

    <!-- Mybatis整合Spring的适配包 -->
    <!-- https://mvnrepository.com/artifact/org.mybatis/mybatis-spring -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.3.1</version>
    </dependency>

    <!-- PageHelper分页插件 -->
    <dependency>
      <groupId>com.github.pagehelper</groupId>
      <artifactId>pagehelper</artifactId>
      <version>5.0.0</version>
    </dependency>

    <!-- 数据库连接池 -->
    <!-- https://mvnrepository.com/artifact/c3p0/c3p0 -->
    <dependency>
      <groupId>c3p0</groupId>
      <artifactId>c3p0</artifactId>
      <version>0.9.1.2</version>
    </dependency>

    <!-- 数据库驱动 -->
    <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.41</version>
    </dependency>

    <!-- JSTL -->
    <!-- https://mvnrepository.com/artifact/javax.servlet/jstl -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>


    <!-- Servlet-API -->
    <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>

    <!-- MybatisGenerator -->
    <!-- https://mvnrepository.com/artifact/org.mybatis.generator/mybatis-generator-core -->
    <dependency>
      <groupId>org.mybatis.generator</groupId>
      <artifactId>mybatis-generator-core</artifactId>
      <version>1.4.0</version>
    </dependency>

    <!-- junit -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
    </dependency>
  </dependencies>

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

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

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

来看看web.xml文件

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

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

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

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

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

代码语言:javascript复制
<?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">

    <!--1、启动Spring的容器  -->
    <!-- needed for ContextLoaderListener -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>

    <!-- Bootstraps the root web application context before servlet initialization -->
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!--2、springmvc的前端控制器,拦截所有请求  -->
    <!-- The front controller of this Spring Web application, responsible for handling all application requests -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <!-- Map all requests to the DispatcherServlet for handling -->
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>

    <!-- 3、字符编码过滤器,一定要放在所有过滤器之前 -->
    <filter>
        <filter-name>CharacterEncodingFilter</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>forceRequestEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
        <init-param>
            <param-name>forceResponseEncoding</param-name>
            <param-value>true</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>CharacterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <!-- 4、使用Rest风格的URI,将页面普通的post请求转为指定的delete或者put请求 -->
    <filter>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>HiddenHttpMethodFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
    <filter>
        <filter-name>HttpPutFormContentFilter</filter-name>
        <filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
    </filter>
    <filter-mapping>
        <filter-name>HttpPutFormContentFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

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

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

然后搭建一下包结构:

对dispatcher-servlet.xml进行配置:

代码语言:javascript复制
<?xml version="1.0" encoding="UTF-8"?>
<!--suppress SpringFacetInspection -->
<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">

    <!-- SpringMVC配置文件 -->

    <!-- 配置需要扫描的包 -->
    <context:component-scan base-package="com.wwj" use-default-filters="false">
        <!-- 为了避免与Spring的重复扫描,SpringMVC只需扫描控制器即可 -->
        <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):

代码语言:javascript复制
<?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.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">

    <!-- Spring配置文件 -->

    <!-- 配置扫描的包 -->
    <context:component-scan base-package="com.wwj">
        <!-- 为了避免与SpringMVC重复扫描,Spring需要扫描除控制器外的所有包 -->
        <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>

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

    <!-- 配置扫描器,将Mybatis接口的实现加入到IOC容器中 -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <!-- 扫描dao包下的所有接口 -->
        <property name="basePackage" value="com.wwj.crud.dao"/>
    </bean>

    <!-- 配置可以指定批量的sqlSession -->
    <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>

    <!-- 配置基于xml形式的事务 -->
    <!-- 配置事务属性 -->
    <tx:advice id="txAdvice">
        <tx:attributes>
            <!-- 所有方法都是事务方法 -->
            <tx:method name="*"/>
            <!-- get开头的所有方法都是查询 -->
            <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文件:

代码语言:javascript复制
jdbc.jdbcUrl=jdbc:mysql://localhost:3306/ssm_crud
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.user=root
jdbc.password=123456

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

代码语言:javascript复制
<?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>

    <!-- 配置全局属性 -->
    <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进行了整合,所以全局配置文件的配置极其简单,开启驼峰命名规则映射和别名设置即可,

接下来设计一下数据表:

代码语言:javascript复制
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
代码语言:javascript复制
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文件,并作如下配置:

代码语言:javascript复制
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
        PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
        "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<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>

        <!-- 指定JavaBean生成的位置 -->
        <javaModelGenerator targetPackage="com.wwj.crud.bean"
                            targetProject=".srcmainjava">
            <property name="enableSubPackages" value="true" />
            <property name="trimStrings" value="true" />
        </javaModelGenerator>

        <!--指定sql映射文件生成的位置 -->
        <sqlMapGenerator targetPackage="mapper" targetProject=".srcmainresources">
            <property name="enableSubPackages" value="true" />
        </sqlMapGenerator>

        <!-- 指定dao接口生成的位置,mapper接口 -->
        <javaClientGenerator type="XMLMAPPER"
                             targetPackage="com.wwj.crud.dao" targetProject=".srcmainjava">
            <property name="enableSubPackages" value="true" />
        </javaClientGenerator>


        <!-- table指定每个表的生成策略 -->
        <table tableName="tbl_emp" domainObjectName="Employee"></table>
        <table tableName="tbl_dept" domainObjectName="Department"></table>
    </context>
</generatorConfiguration>

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

然后新建测试文件,执行如下代码:

代码语言:javascript复制
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文件,所以我们让其直接转发至其它页面:

代码语言:javascript复制
<%--
  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

0 人点赞