本篇文章我们使用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>
<!-- 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文件就得做出修改,修改如下:
<?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进行配置:
<?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):
<?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文件:
jdbc.jdbcUrl=jdbc:mysql://localhost:3306/ssm_crud
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.user=root
jdbc.password=123456
这样Spring和SpringMVC就配置完成了,接下来对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>
<!-- 配置全局属性 -->
<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文件,并作如下配置:
<?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=".\src\main\java">
<property name="enableSubPackages" value="true" />
<property name="trimStrings" value="true" />
</javaModelGenerator>
<!--指定sql映射文件生成的位置 -->
<sqlMapGenerator targetPackage="mapper" targetProject=".\src\main\resources">
<property name="enableSubPackages" value="true" />
</sqlMapGenerator>
<!-- 指定dao接口生成的位置,mapper接口 -->
<javaClientGenerator type="XMLMAPPER"
targetPackage="com.wwj.crud.dao" targetProject=".\src\main\java">
<property name="enableSubPackages" value="true" />
</javaClientGenerator>
<!-- table指定每个表的生成策略 -->
<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