IDEA搭建SSM框架
Spring + Spring MVC + MyBatis 整合开发
1:创建 Maven webapp 项目
首先新建工程,选择 Maven 标签,然后勾选上【Create from archetype】选择 webapp:

点击下一步,填写上【GroupId】和【ArtifactId】:
- GroupId:项目组织唯一的标识符,实际对应 JAVA 的包的结构,也就是 main 目录下 java 的目录结构(包)
- AritifactId:项目的唯一标识符,实际对应项目的名称,就是项目根目录的名称

确认项目路径,这一步你可以看到 Maven 配置中的参数,不需要做改动,直接下一步就可以

确认项目名称,点击【Finish】即可:

等待一会儿,控制台就会有创建成功的提示信息,我们把【Enable Auto-Import】点上,这个提示会在每次 pom.xml 有改动时出现,自动导入:

2:搭建项目目录结构
下面就是 Maven 风格的 webapp 的默认目录结构:

webapp 是默认没有 java 源文件也没有 test 目录的。
遵循 Maven 的统一项目结构,我们搭建出项目的完整目录结构如下图:

- 我们并没有使用 Log4j 来输出日志,而是使用 logback
- 提示:我们可以在 IDEA 中右键目录然后选择【Make Directory as】,让 IDEA 识别不同的目录作用

这里的目录建好之后还需要设置一下,让 IDEA 识别目录作用,选择【File】>【Project Structure】:

设置好之后点击 OK,即完成了项目目录的搭建。
3:配置文件内容
在【pom.xml】文件中声明依赖的 jar 包 :
1 <?xml version="1.0" encoding="UTF-8"?> 2 <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/maven-v4_0_0.xsd"> 3 <modelVersion>4.0.0</modelVersion> 4 <packaging>war</packaging> 5 6 <name>Manage_SSM</name> 7 <groupId>cn.dylxf</groupId> 8 <artifactId>Manage_SSM</artifactId> 9 <version>1.0-SNAPSHOT</version> 10 11 <build> 12 <plugins> 13 <plugin> 14 <groupId>org.mortbay.jetty</groupId> 15 <artifactId>maven-jetty-plugin</artifactId> 16 <version>6.1.7</version> 17 <configuration> 18 <connectors> 19 <connector implementation="org.mortbay.jetty.nio.SelectChannelConnector"> 20 <port>8888</port> 21 <maxIdleTime>30000</maxIdleTime> 22 </connector> 23 </connectors> 24 <webAppSourceDirectory>${project.build.directory}/${pom.artifactId}-${pom.version}</webAppSourceDirectory> 25 <contextPath>/</contextPath> 26 </configuration> 27 </plugin> 28 </plugins> 29 </build> 30 31 <properties> 32 <!-- 设置项目编码编码 --> 33 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 34 <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> 35 <!-- spring版本号 --> 36 <spring.version>4.3.5.RELEASE</spring.version> 37 <!-- mybatis版本号 --> 38 <mybatis.version>3.4.1</mybatis.version> 39 </properties> 40 41 <dependencies> 42 43 <!-- java ee --> 44 <dependency> 45 <groupId>javax</groupId> 46 <artifactId>javaee-api</artifactId> 47 <version>7.0</version> 48 </dependency> 49 50 <!-- 单元测试 --> 51 <dependency> 52 <groupId>junit</groupId> 53 <artifactId>junit</artifactId> 54 <version>4.12</version> 55 </dependency> 56 57 <!-- 实现slf4j接口并整合 --> 58 <dependency> 59 <groupId>ch.qos.logback</groupId> 60 <artifactId>logback-classic</artifactId> 61 <version>1.2.2</version> 62 </dependency> 63 64 <!-- JSON --> 65 <dependency> 66 <groupId>com.fasterxml.jackson.core</groupId> 67 <artifactId>jackson-databind</artifactId> 68 <version>2.8.7</version> 69 </dependency> 70 71 72 <!-- 数据库 --> 73 <dependency> 74 <groupId>mysql</groupId> 75 <artifactId>mysql-connector-java</artifactId> 76 <version>5.1.41</version> 77 <scope>runtime</scope> 78 </dependency> 79 80 <!-- 数据库连接池 --> 81 <dependency> 82 <groupId>com.mchange</groupId> 83 <artifactId>c3p0</artifactId> 84 <version>0.9.5.2</version> 85 </dependency> 86 87 <!-- MyBatis --> 88 <dependency> 89 <groupId>org.mybatis</groupId> 90 <artifactId>mybatis</artifactId> 91 <version>${mybatis.version}</version> 92 </dependency> 93 94 <!-- mybatis/spring整合包 --> 95 <dependency> 96 <groupId>org.mybatis</groupId> 97 <artifactId>mybatis-spring</artifactId> 98 <version>1.3.1</version> 99 </dependency> 100 101 <!-- Spring --> 102 <dependency> 103 <groupId>org.springframework</groupId> 104 <artifactId>spring-core</artifactId> 105 <version>${spring.version}</version> 106 </dependency> 107 <dependency> 108 <groupId>org.springframework</groupId> 109 <artifactId>spring-beans</artifactId> 110 <version>${spring.version}</version> 111 </dependency> 112 <dependency> 113 <groupId>org.springframework</groupId> 114 <artifactId>spring-context</artifactId> 115 <version>${spring.version}</version> 116 </dependency> 117 <dependency> 118 <groupId>org.springframework</groupId> 119 <artifactId>spring-jdbc</artifactId> 120 <version>${spring.version}</version> 121 </dependency> 122 <dependency> 123 <groupId>org.springframework</groupId> 124 <artifactId>spring-tx</artifactId> 125 <version>${spring.version}</version> 126 </dependency> 127 <dependency> 128 <groupId>org.springframework</groupId> 129 <artifactId>spring-web</artifactId> 130 <version>${spring.version}</version> 131 </dependency> 132 <dependency> 133 <groupId>org.springframework</groupId> 134 <artifactId>spring-webmvc</artifactId> 135 <version>${spring.version}</version> 136 </dependency> 137 <dependency> 138 <groupId>org.springframework</groupId> 139 <artifactId>spring-test</artifactId> 140 <version>${spring.version}</version> 141 </dependency> 142 143 </dependencies> 144 145 </project>
在【web.xml】中声明编码过滤器并配置 DispatcherServlet :
1 <?xml version="1.0" encoding="UTF-8"?> 2 <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 4 xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" 5 version="3.1"> 6 7 <!-- 编码过滤器 --> 8 <filter> 9 <filter-name>encodingFilter</filter-name> 10 <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 11 <init-param> 12 <param-name>encoding</param-name> 13 <param-value>UTF-8</param-value> 14 </init-param> 15 </filter> 16 <filter-mapping> 17 <filter-name>encodingFilter</filter-name> 18 <url-pattern>/*</url-pattern> 19 </filter-mapping> 20 21 <!-- 配置DispatcherServlet --> 22 <servlet> 23 <servlet-name>SpringMVC</servlet-name> 24 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 25 <!-- 配置springMVC需要加载的配置文件--> 26 <init-param> 27 <param-name>contextConfigLocation</param-name> 28 <param-value>classpath:spring-*.xml</param-value> 29 </init-param> 30 <load-on-startup>1</load-on-startup> 31 <async-supported>true</async-supported> 32 </servlet> 33 <servlet-mapping> 34 <servlet-name>SpringMVC</servlet-name> 35 <!-- 匹配所有请求 --> 36 <url-pattern>/</url-pattern> 37 </servlet-mapping> 38 39 </web-app>
在【spring-mybatis.xml】中完成 spring 和 mybatis 的配置:
<?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="cn.dylxf.service"/> <!-- 配置数据库相关参数properties的属性:${url} --> <context:property-placeholder location="classpath:jdbc.properties"/> <!-- 数据库连接池 --> <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}"/> <property name="maxPoolSize" value="${c3p0.maxPoolSize}"/> <property name="minPoolSize" value="${c3p0.minPoolSize}"/> <property name="autoCommitOnClose" value="${c3p0.autoCommitOnClose}"/> <property name="checkoutTimeout" value="${c3p0.checkoutTimeout}"/> <property name="acquireRetryAttempts" value="${c3p0.acquireRetryAttempts}"/> </bean> <!-- 配置SqlSessionFactory对象 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <!-- 注入数据库连接池 --> <property name="dataSource" ref="dataSource"/> <!-- 扫描entity包 使用别名 --> <property name="typeAliasesPackage" value="cn.dylxf.entity"/> <!-- 扫描sql配置文件:mapper需要的xml文件 --> <property name="mapperLocations" value="classpath:mapper/*.xml"/> </bean> <!-- 配置扫描Dao接口包,动态实现Dao接口,注入到spring容器中 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <!-- 注入sqlSessionFactory --> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/> <!-- 给出需要扫描Dao接口包 --> <property name="basePackage" value="cn.dylxf.dao"/> </bean> <!-- 配置事务管理器 --> <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager"> <!-- 注入数据库连接池 --> <property name="dataSource" ref="dataSource"/> </bean> <!-- 配置基于注解的声明式事务 --> <tx:annotation-driven transaction-manager="transactionManager"/> </beans>
在【spring-mvc.xml】中完成 Spring MVC 的相关配置:
<?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"> <!-- 扫描web相关的bean --> <context:component-scan base-package="cn.dylxf.controller"/> <!-- 开启SpringMVC注解模式 --> <mvc:annotation-driven/> <!-- 静态资源默认servlet配置 --> <mvc:default-servlet-handler/> <!-- 配置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/views/"/> <property name="suffix" value=".jsp"/> </bean> </beans>
在【jdbc.properties】中配置 c3p0 数据库连接池:
jdbc.driver=com.mysql.jdbc.Driver #数据库地址 jdbc.url=jdbc:mysql://localhost:3306/ssm?useUnicode=true&characterEncoding=utf8 #用户名 jdbc.username=root #密码 jdbc.password=123456 #最大连接数 c3p0.maxPoolSize=30 #最小连接数 c3p0.minPoolSize=10 #关闭连接后不自动commit c3p0.autoCommitOnClose=false #获取连接超时时间 c3p0.checkoutTimeout=10000 #当获取连接失败重试次数 c3p0.acquireRetryAttempts=2
在【logback.xml】中完成日志输出的相关配置:
<?xml version="1.0" encoding="UTF-8"?> <configuration debug="true"> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <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>
以上就完成了基本的相关配置:
- 添加进了 SSM 项目所需要的 jar 包
- 配置好了 spring/mybatis/spring MVC 的相关配置信息(自动扫描
cn.dylxf包下的带有注解的类) - 通过 xml 配置的方式配置好了日志和数据库
4:测试 SSM 框架
准备好用来测试的数据库:
DROP DATABASE IF EXISTS ssm; CREATE DATABASE ssm CHARACTER SET utf8; use ssm; CREATE TABLE user( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL, PRIMARY KEY (id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; INSERT INTO user VALUES(1,'单翼路西法');
接下来在【cn.dylxf.entity】包下创建好对应的实体类 User :
package cn.dylxf.entity; public class User { private int id; private String username; /* getter and setter */ }
在【cn.dylxf.dao】包下创建好 Dao 接口:
package cn.dylxf.dao; import cn.dylxf.entity.User; public interface UserDao { // 根据 id 寻找对应的 User User findUserById(int id); }
在【resources/mapper】下编写 UserDao.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"> <!-- 设置为IUserDao接口方法提供sql语句配置 --> <mapper namespace="cn.dylxf.dao.UserDao"> <select id="findUserById" resultType="cn.dylxf.entity.User" parameterType="int"> SELECT * FROM user WHERE id = #{id} </select> </mapper>
在编写好每一个 Dao 的时候,我们都需要对它进行测试,在【test/java】下创建包【cn.dylxf.test】然后在包下创建一个【UserDaoTest】的测试类:
package cn.dylxf.test; import cn.dylxf.dao.UserDao; import cn.dylxf.entity.User; import org.junit.Test; import org.junit.runner.RunWith; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.test.context.ContextConfiguration; import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; /** * UserDao 的测试类 * * @author: @我没有三颗心脏 * @create: 2018-04-23-上午 9:54 */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration({"classpath:spring-mybatis.xml"}) public class UserDaoTest { @Autowired private UserDao userDao; @Test public void testFindUserById() { int id = 1; User user = userDao.findUserById(id); System.out.println(user.getId() + ":" + user.getUsername()); } }
运行测试代码,能够获取到正确的信息:

接着在【cn.dylxf.service】包下编写好对应的 UserService 接口:
package cn.dylxf.service; import cn.dylxf.entity.User; public interface UserService { // 根据 id 寻找对应的 User public User findUserById(int id); }
和对应的实现类:
package cn.dylxf.service; import cn.dylxf.dao.UserDao; import cn.dylxf.entity.User; import org.springframework.stereotype.Service; import javax.annotation.Resource; @Service("userService") public class UserServiceImpl implements UserService { @Resource private UserDao userDao; public User findUserById(int id) { return userDao.findUserById(id); } }
在【cn.dylxf.controller】下创建【UserController】控制类:
package cn.dylxf.controller; import cn.dylxf.entity.User; import cn.dylxf.service.UserService; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.RequestMapping; import javax.annotation.Resource; @Controller @RequestMapping("") public class UserController { @Resource private UserService userService; @RequestMapping("/findUser") public String findUser(Model model) { int id = 1; User user = this.userService.findUserById(id); model.addAttribute("user", user); return "index"; } }
最后在【WEB-INF/views】下创建 index.jsp 用于接收并显示数据:
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>SSM 框架整合</title> </head> <body> ${user.id}:${user.username} </body> </html>
配置好 Tomcat 服务器,运行:

即完成了 SSM 的整合!
参考资料:使用idea2017搭建SSM框架

浙公网安备 33010602011771号