手把手教你用idea搭建ssm项目并实现简单demo（超详细）

大家好，又见面了，我是你们的朋友全栈君。

闲暇之余，想搭建一个ssm项目玩玩，结果发现，不百度根本打不出来，搭建出来也有一堆问题，所以在此一步一步记录一下。

1. 使用idea搭建ssm项目，首先就是将整个框架整起来

• 如果已经在项目中了，点击左上角file->new->project（刚打开idea是新建->project）

• 左侧栏目选择maven并勾选create from archetype，然后在下面找到org.apache.maven.archetype:maven-archetype-webapp（注意全拼，不要搞错了）点击Next

• 输入对应的Groupid，Artifactid,然后点击next

• 接下面配置maven，依次选择本地maven地址，maven中的setting.xml文件以及本地仓库，然后一路next，idea就开始创建项目了
  

2. 到此为止，项目基本结构已经完成了，但是这个项目只能说骨架搭好了，现在开始配置成maven标准的ssm项目结构

• 当idea将项目创建好后，你的项目右下角可能会有一个提示，选择import changes即可，自动帮你从仓库中配置jar，当然，如果你的仓库没有对应的jar包的话，这个过程将会长一点
  
• 项目创建好后是这样的，很明显不是标准的ssm结构
  

我们要手动的在main下面去创建java文件夹以及resources文件夹，当我们创建好对应的文件夹后会发现，一般的ssm项目在idea中的java文件夹和resources的文件夹是有特殊的颜色的，这时候我们需要点击file->project structure然后选择Modules,我这里的结构：

然后鼠标点中java文件夹，选择上面的Sources,这样你就看到java文件夹对应的颜色出来了，然后同样点击resources文件夹选择Resources，同样的resources文件夹的颜色出来了。最后点击apply和ok，就能看到我们项目的文件意见变成我们想要的了。

3. 到此我们的项目骨架也搭建好了，接下面我们将整合ssm，编写配置文件了

• 在编写配置文件之前，我们需要先在java下面将对应的文件包都创建好，不然配置文件找不到对应的包会报错。
  这是我创建好的文件包：
  稍微的解释下包名吧：
  controller: web层的包，请求就在这里接收
  entity:实体所在包
  entity.xml: mapper映射的xml所在包
  mapper:mapper文件（接口）所在包
  service:业务接口所在包
  service.impl:业务接口所在的实现类
  util:后期可能需要的工具类所在包

• 当你的包名都创建好后，我们开始整合ssm
  首先我们先在WEB-INF创建以及jsp的文件夹，然后将index.jsp放入jsp文件夹下
  然后我们在pom.xml中引入spring以及mybatis以及mysql等的相关依赖，下面是我加入后的整体pom代码

<?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.ssm</groupId>
<artifactId>ssmdemo</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
<name>ssmdemo 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>
<maven.compiler.source>1.7</maven.compiler.source>
<maven.compiler.target>1.7</maven.compiler.target>
<!--spring版本-->
<spring.version>5.0.5.RELEASE</spring.version>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</scope>
</dependency>
<!-- 实现slf4j接口并整合 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.1.1</version>
</dependency>
<!-- jsp页面使用的jstl表达式 -->
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!--spring核心包-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aop</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-expression</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-orm</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- 数据库 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.31</version>
</dependency>
<dependency>
<groupId>com.mchange</groupId>
<artifactId>c3p0</artifactId>
<version>0.9.5.2</version>
</dependency>
<!--mybatis-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.6</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.3.2</version>
</dependency>
<!-- 其他 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.47</version>
</dependency>
</dependencies>
<build>
<finalName>ssmdemo</finalName>
<pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
<plugins>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>3.1.0</version>
</plugin>
<!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>3.0.2</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.1</version>
</plugin>
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.2</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.5.2</version>
</plugin>
<plugin>
<artifactId>maven-deploy-plugin</artifactId>
<version>2.8.2</version>
</plugin>
</plugins>
</pluginManagement>
</build>
</project>         

当你依赖导入之后右下角会出现是否引入，选择import program即可。

• 依赖导入之后，开始编写配置文件
  在你导入成功spring依赖后，在resources先创建一个spring的文件夹，我们把配置的spring都放在spring文件夹下。
  然后在spring下右键new->XML Configuration File->Spring Config。
  注意：如果你的选择项中没有Spring config说明你的spring依赖没有导入成功

然后创建名为spring-dao.xml，spring-service.xml，spring-web.xml三个配置文件。（这里的名字可以随意），并在resources下创建mysql连接的文件jdbc.properties文件

文件内容：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mark?useUnicode=true&characterEncoding=utf8
jdbc.username=root
jdbc.password=123456

然后在resources下创建mybatis配置文件mybatis-config.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>
<settings>
<!-- 打开延迟加载的全局开关 -->
<setting name="lazyLoadingEnabled" value="true" />
<setting name="aggressiveLazyLoading" value="false" />
<!-- 使用jdbc的getGeneratedKeys获取数据库自增主键值 -->
<setting name="useGeneratedKeys" value="true" />
<!-- 使用列别名替换列名 默认:true -->
<setting name="useColumnLabel" value="true" />
<!-- 开启驼峰命名转换:Table{create_time} -> Entity{createTime} -->
<setting name="mapUnderscoreToCamelCase" value="true" />
</settings>
</configuration>

继续在resources下创建日志文件logback.xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true">
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoders are by default assigned the type ch.qos.logback.classic.encoder.PatternLayoutEncoder -->
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<root level="debug">
<appender-ref ref="STDOUT" />
</root>
</configuration>

到此我们已经创建了6个配置文件了

4. 编写spring配置文件内容

首先编写spring-dao.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.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 配置整合mybatis过程 -->
<!-- 1.配置数据库相关参数properties的属性：${url} -->
<context:property-placeholder location="classpath:jdbc.properties" />
<!-- 2.数据库连接池 -->
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
<!-- 配置连接池属性 -->
<property name="driverClass" value="${jdbc.driver}" />
<property name="jdbcUrl" value="${jdbc.url}" />
<property name="user" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
<!-- c3p0连接池的私有属性 -->
<property name="maxPoolSize" value="30" />
<property name="minPoolSize" value="10" />
<!-- 关闭连接后不自动commit -->
<property name="autoCommitOnClose" value="false" />
<!-- 获取连接超时时间 -->
<property name="checkoutTimeout" value="10000" />
<!-- 当获取连接失败重试次数 -->
<property name="acquireRetryAttempts" value="2" />
</bean>
<!-- 3.配置SqlSessionFactory对象 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<!-- 注入数据库连接池 -->
<property name="dataSource" ref="dataSource" />
<!-- 配置MyBaties全局配置文件:mybatis-config.xml -->
<property name="configLocation" value="classpath:mybatis-config.xml" />
<!-- 扫描entity包 使用别名 -->
<property name="typeAliasesPackage" value="com.ssm.entity" />
<!-- 扫描sql配置文件:mapper需要的xml文件 -->
<property name="mapperLocations" value="classpath:com/ssm/entity/*/*.xml" />
</bean>
<!-- 4.配置扫描Dao接口包，动态实现Dao接口，注入到spring容器中 -->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<!-- 注入sqlSessionFactory -->
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
<!-- 给出需要扫描Dao接口包 -->
<property name="basePackage" value="com.ssm.mapper" />
</bean>
</beans>

当你加入以上代码的时候可以会有红的报错，
classpath:com/ssm/entity//.xml。因为还没有.xml文件，所在暂时先不用管

继续配置spring-service.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: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/tx http://www.springframework.org/schema/tx/spring-tx.xsd">
<!-- 扫描service包下所有使用注解的类型 -->
<context:component-scan base-package="com.ssm.service" />
<!-- 1.配置数据库相关参数properties的属性：${url} -->
<context:property-placeholder location="classpath:jdbc.properties" />
<!-- 2.数据库连接池 -->
<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource">
<!-- 配置连接池属性 -->
<property name="driverClass" value="${jdbc.driver}" />
<property name="jdbcUrl" value="${jdbc.url}" />
<property name="user" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
<!-- c3p0连接池的私有属性 -->
<property name="maxPoolSize" value="30" />
<property name="minPoolSize" value="10" />
<!-- 关闭连接后不自动commit -->
<property name="autoCommitOnClose" value="false" />
<!-- 获取连接超时时间 -->
<property name="checkoutTimeout" value="10000" />
<!-- 当获取连接失败重试次数 -->
<property name="acquireRetryAttempts" value="2" />
</bean>
<!-- 配置事务管理器 -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<!-- 注入数据库连接池 -->
<property name="dataSource" ref="dataSource" />
</bean>
<!-- 配置基于注解的声明式事务 -->
<tx:annotation-driven transaction-manager="transactionManager" />
</beans>

配置spring-web.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: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-3.0.xsd">
<!-- 配置SpringMVC -->
<!-- 1.开启SpringMVC注解模式 -->
<!-- 简化配置： (1)自动注册DefaultAnootationHandlerMapping,AnotationMethodHandlerAdapter (2)提供一些列：数据绑定，数字和日期的format @NumberFormat, @DateTimeFormat, xml,json默认读写支持 -->
<mvc:annotation-driven />
<!-- 2.静态资源默认servlet配置 (1)加入对静态资源的处理：js,gif,png (2)允许使用"/"做整体映射 -->
<mvc:default-servlet-handler/>
<!-- 3.配置jsp 显示ViewResolver -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
<!-- 4.扫描web相关的bean -->
<context:component-scan base-package="com.ssm.controller" />
</beans>

以上的spring配置就结束了，然后将spring配置文件挂载到服务启动的时候。

配置web.xml

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
<display-name>Archetype Created Web Application</display-name>
<!--1.配置前置控制器 -->
<servlet>
<servlet-name>SpringDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<!-- 引入spring配置文件 -->
<param-value>classpath:spring/spring-*.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>SpringDispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!--2.欢迎文件-->
<welcome-file-list>
<welcome-file>/WEB-INF/jsp/index.jsp</welcome-file>
</welcome-file-list>
</web-app>

以上ssm整合就已经完全结束了

5. ssm整合结束，接下面我们看案例，看整合效果

• 配置tomcat服务
  依次点击右上角Add Configuration->±>Tomcat server->local，然后输入服务名，选择Deployment点击+点击Artifact然后选择后缀为exploded的，然后修改Application context的值将后缀去掉，当然也可以不修改。然后点击ok即可。
  
  
  

然后启动项目 如果出现这个页面，说明配置成功了

千万不要以为这就完了 因为我们还没有连接数据库，测试流程，现在只是简单的欢迎页面，下面我自己尝试有不少的坑。所以请继续看下去！！！

• 创建案例流程：

1. 在你自己配置的数据库中创建一个数据库（我这里创建了一个名为mark），并创建一个表（file），字段随便吧 我这里写了四个字段。
2. 然后在对应的项目包下创建对应的实体，接口以及mapper等，我这里直接使用MybatisCodeHelperPro插件直接生成mapper，实体，接口和xml等，安装教程查看https://blog.csdn.net/mataodehtml/article/details/108018023
   自动生成后的文件(这里我们测试只能到一个根据主键查询的，所以我将多余的删除了)：
   entity:

package com.pdf.entity;
/** * @anther mt * @creater 2020-08-14 14:03 */
public class File { 

/** * 上传的文件 */
private Integer id;
/** * 文件名称 */
private String filename;
/** * 文件地址 */
private String fileurl;/** * 是否删除（0否 1是） */
private Integer isdel;
public Integer getId() { 

return id;
}
public void setId(Integer id) { 

this.id = id;
}
public String getFilename() { 

return filename;
}public void setFilename(String filename) { 

this.filename = filename;
}
public String getFileurl() { 

return fileurl;
}
public void setFileurl(String fileurl) { 

this.fileurl = fileurl;
}
public Integer getIsdel() { 

return isdel;
}
public void setIsdel(Integer isdel) { 

this.isdel = isdel;
}
}

xml：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ssm.mapper.FileMapper">
<resultMap id="BaseResultMap" type="com.ssm.entity.File">
<!--@mbg.generated-->
<!--@Table file-->
<id column="id" jdbcType="INTEGER" property="id" />
<result column="filename" jdbcType="VARCHAR" property="filename" />
<result column="fileurl" jdbcType="VARCHAR" property="fileurl" />
<result column="isdel" jdbcType="INTEGER" property="isdel" />
</resultMap>
<sql id="Base_Column_List">
<!--@mbg.generated-->
id, filename, fileurl, isdel
</sql>
<select id="selectByPrimaryKey" parameterType="java.lang.Integer" resultMap="BaseResultMap">
<!--@mbg.generated-->
select 
<include refid="Base_Column_List" />
from file
where id = #{id,jdbcType=INTEGER}
</select>
</mapper>

mapper:

package com.ssm.mapper;
import com.ssm.entity.File;
/** * @anther mt * @creater 2020-08-15 9:24 */
public interface FileMapper { 

File selectByPrimaryKey(Integer id);
}

service:

package com.ssm.service;
import com.ssm.entity.File;
/** * @anther mt * @creater 2020-08-15 9:24 */
public interface FileService{ 

File selectByPrimaryKey(Integer id);
}

service.impl:

package com.ssm.service.impl;
import org.springframework.stereotype.Service;
import javax.annotation.Resource;
import com.ssm.mapper.FileMapper;
import com.ssm.entity.File;
import com.ssm.service.FileService;
/** * @anther mt * @creater 2020-08-15 9:24 */
@Service
public class FileServiceImpl implements FileService{ 

@Resource
private FileMapper fileMapper;
@Override
public File selectByPrimaryKey(Integer id) { 

return fileMapper.selectByPrimaryKey(id);
}
}

3. 然后编写一个用于测试的controller（FileController）

package com.ssm.controller;
import com.ssm.entity.File;
import com.ssm.service.FileService;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
/** * @anther mt * @creater 2020-08-15 9:39 */
@Controller
@RequestMapping("/file")
public class FileController { 

@Resource
private FileService fileService;
@RequestMapping("getDataById")
public String getDataById(HttpServletRequest request){ 

Integer id = 1;
File file = fileService.selectByPrimaryKey(id);
request.setAttribute("file",file);
return "show";
}
}

4. 对应的我们在jsp文件夹下创建一个叫show的jsp文件，并使用jsp内置作用域展示request中的对象
   show.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<h3>展示数据</h3>
<div>文件id：${file.id}</div>
<div>文件名称：${file.filename}</div>
<div>文件地址：${file.fileurl}</div>
</body>
</html>

5. 然后我们在数据库中手动插入一条id为1的数据用来测试，加上数据之后，点击运行项目。当页面出现hello world的时候说明项目运行成功了。

***6. 然后根据我们的controller书写的方式去访问controller，访问后将出现第一个坑，报错了:***

报错原因：mapper默认是在resources中的，所以编译的时候无法编译到entity下的xml文件，这样就会找不到对应的接口，你可以查看下对应的target中就会发现没有打包出xml文件。

解决方案：我们需要在pom加入对xml的扫描，放在bulid标签下面

<!--编译时包括xml文件和properties文件,不然编译后不包括此文件-->
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>

然后我们重启一下，重启访问，你会发现没有报错了，但是又出现了另一个问题：页面没有解析jsp内置作用域。
效果：

我也是查了很多方案，才知道的。我们现在使用的web.xml是自动生成的，我们只需要将web.xml的这些

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" >

改成

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

然后重启项目，发现数据库的内容已经在页面展示了。

大功告成！！！！

本demo已在github开源，可以当成一个ssm脚手架项目。需要的可以clone或者下载下来:https://github.com/Ma-Tao007/SSM