SSM框架整合（IntelliJ IDEA + maven + Spring + SpringMVC + MyBatis）

本篇文章主要内容是介绍如何使用IntelliJ IDEA创建Spring + SpringMVC + MyBatis项目，下面会给出项目搭建的详细步骤以及相关的配置文件。

1. 创建maven项目

1.1  File -> New Module，进入创建项目窗口。

1.2  点击Next，填写GroupId、ArtifactId和Version

1.3  接着下一步，这里需要注在Properties中添加一个参数 archetypeCatalog=internal，不加这个参数，在maven生成骨架的时候将会非常慢，有时候直接卡住。来自网上的解释：

archetypeCatalog表示插件使用的archetype元数据，不加这个参数时默认为remote，local，即*仓库archetype元数据，由于*

仓库的archetype太多了所以导致很慢，指定internal来表示仅使用内部元数据。

1.4  填写Module name

1.5  生成maven的项目骨架之后，我们还需要手动在 src/main 下创建 java目录。现在可以直接编写了，我把项目所需要的文件都编写完成之后，项目的工程结构如图。

      到此为止，项目的框架基本搭建完成，下面重点说一下项目的配置文件

2.  项目配置文件

 2.1   这里使用maven来引入项目所需要的jar包，所以也就不需要手动来管理jar包了。

pom.xml

1. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
2. 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. <groupId>com.heitian.web</groupId>
5. <artifactId>web-ssm</artifactId>
6. <packaging>war</packaging>
7. <version>1.0-SNAPSHOT</version>
8. <name>web-ssm Maven Webapp</name>
9. <url>http://maven.apache.org</url>
10. <properties>
11. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
12. <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
14. <!-- spring版本号 -->
15. <spring.version>4.2.5.RELEASE</spring.version>
17. <!-- mybatis版本号 -->
18. <mybatis.version>3.2.8</mybatis.version>
20. <!-- mysql驱动版本号 -->
21. <mysql-driver.version>5.1.29</mysql-driver.version>
23. <!-- log4j日志包版本号 -->
24. <slf4j.version>1.7.18</slf4j.version>
25. <log4j.version>1.2.17</log4j.version>
27. </properties>
30. <dependencies>
31. <!-- 添加jstl依赖 -->
32. <dependency>
33. <groupId>jstl</groupId>
34. <artifactId>jstl</artifactId>
35. <version>1.2</version>
36. </dependency>
38. <dependency>
39. <groupId>javax</groupId>
40. <artifactId>javaee-api</artifactId>
41. <version>7.0</version>
42. </dependency>
44. <!-- 添加junit4依赖 -->
45. <dependency>
46. <groupId>junit</groupId>
47. <artifactId>junit</artifactId>
48. <version>4.11</version>
49. <!-- 指定范围，在测试时才会加载 -->
50. <scope>test</scope>
51. </dependency>
53. <!-- 添加spring核心依赖 -->
54. <dependency>
55. <groupId>org.springframework</groupId>
56. <artifactId>spring-core</artifactId>
57. <version>${spring.version}</version>
58. </dependency>
59. <dependency>
60. <groupId>org.springframework</groupId>
61. <artifactId>spring-web</artifactId>
62. <version>${spring.version}</version>
63. </dependency>
64. <dependency>
65. <groupId>org.springframework</groupId>
66. <artifactId>spring-oxm</artifactId>
67. <version>${spring.version}</version>
68. </dependency>
69. <dependency>
70. <groupId>org.springframework</groupId>
71. <artifactId>spring-tx</artifactId>
72. <version>${spring.version}</version>
73. </dependency>
74. <dependency>
75. <groupId>org.springframework</groupId>
76. <artifactId>spring-jdbc</artifactId>
77. <version>${spring.version}</version>
78. </dependency>
79. <dependency>
80. <groupId>org.springframework</groupId>
81. <artifactId>spring-webmvc</artifactId>
82. <version>${spring.version}</version>
83. </dependency>
84. <dependency>
85. <groupId>org.springframework</groupId>
86. <artifactId>spring-context</artifactId>
87. <version>${spring.version}</version>
88. </dependency>
89. <dependency>
90. <groupId>org.springframework</groupId>
91. <artifactId>spring-context-support</artifactId>
92. <version>${spring.version}</version>
93. </dependency>
94. <dependency>
95. <groupId>org.springframework</groupId>
96. <artifactId>spring-aop</artifactId>
97. <version>${spring.version}</version>
98. </dependency>
100. <dependency>
101. <groupId>org.springframework</groupId>
102. <artifactId>spring-test</artifactId>
103. <version>${spring.version}</version>
104. </dependency>
106. <!-- 添加mybatis依赖 -->
107. <dependency>
108. <groupId>org.mybatis</groupId>
109. <artifactId>mybatis</artifactId>
110. <version>${mybatis.version}</version>
111. </dependency>
113. <!-- 添加mybatis/spring整合包依赖 -->
114. <dependency>
115. <groupId>org.mybatis</groupId>
116. <artifactId>mybatis-spring</artifactId>
117. <version>1.2.2</version>
118. </dependency>
120. <!-- 添加mysql驱动依赖 -->
121. <dependency>
122. <groupId>mysql</groupId>
123. <artifactId>mysql-connector-java</artifactId>
124. <version>${mysql-driver.version}</version>
125. </dependency>
126. <!-- 添加数据库连接池依赖 -->
127. <dependency>
128. <groupId>commons-dbcp</groupId>
129. <artifactId>commons-dbcp</artifactId>
130. <version>1.2.2</version>
131. </dependency>
133. <!-- 添加fastjson -->
134. <dependency>
135. <groupId>com.alibaba</groupId>
136. <artifactId>fastjson</artifactId>
137. <version>1.1.41</version>
138. </dependency>
140. <!-- 添加日志相关jar包 -->
141. <dependency>
142. <groupId>log4j</groupId>
143. <artifactId>log4j</artifactId>
144. <version>${log4j.version}</version>
145. </dependency>
146. <dependency>
147. <groupId>org.slf4j</groupId>
148. <artifactId>slf4j-api</artifactId>
149. <version>${slf4j.version}</version>
150. </dependency>
151. <dependency>
152. <groupId>org.slf4j</groupId>
153. <artifactId>slf4j-log4j12</artifactId>
154. <version>${slf4j.version}</version>
155. </dependency>
157. <!-- log end -->
158. <!-- 映入JSON -->
159. <dependency>
160. <groupId>org.codehaus.jackson</groupId>
161. <artifactId>jackson-mapper-asl</artifactId>
162. <version>1.9.13</version>
163. </dependency>
164. <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
165. <dependency>
166. <groupId>com.fasterxml.jackson.core</groupId>
167. <artifactId>jackson-core</artifactId>
168. <version>2.8.0</version>
169. </dependency>
170. <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
171. <dependency>
172. <groupId>com.fasterxml.jackson.core</groupId>
173. <artifactId>jackson-databind</artifactId>
174. <version>2.8.0</version>
175. </dependency>
177. <dependency>
178. <groupId>commons-fileupload</groupId>
179. <artifactId>commons-fileupload</artifactId>
180. <version>1.3.1</version>
181. </dependency>
183. <dependency>
184. <groupId>commons-io</groupId>
185. <artifactId>commons-io</artifactId>
186. <version>2.4</version>
187. </dependency>
189. <dependency>
190. <groupId>commons-codec</groupId>
191. <artifactId>commons-codec</artifactId>
192. <version>1.9</version>
193. </dependency>
194. </dependencies>
196. <build>
197. <finalName>web-ssm</finalName>
198. </build>
199. </project>

2.2   新建jdbc.properties文件

jdbc.properties

1. driverClasss=com.mysql.jdbc.Driver
2. jdbcUrl=jdbc:mysql://localhost:3306/db_ssm?useUnicode=true&characterEncoding=utf-8&zeroDateTimeBehavior=convertToNull
3. username=root
4. password=root
6. #定义初始连接数
7. initialSize=0
8. #定义最大连接数
9. maxActive=20
10. #定义最大空闲
11. maxIdle=20
12. #定义最小空闲
13. minIdle=1
14. #定义最长等待时间
15. maxWait=60000

2.3  新建log4j 配置文件

log4j.properties

1. log4j.rootLogger=INFO,Console,File
3. #控制台日志
4. log4j.appender.Console=org.apache.log4j.ConsoleAppender
5. log4j.appender.Console.Target=System.out
6. log4j.appender.Console.layout=org.apache.log4j.PatternLayout
7. log4j.appender.Console.layout.ConversionPattern=[%p][%t][%d{yyyy-MM-dd HH\:mm\:ss}][%C] - %m%n
9. #普通文件日志
10. log4j.appender.File=org.apache.log4j.RollingFileAppender
11. log4j.appender.File.File=logs/ssm.log
12. log4j.appender.File.MaxFileSize=10MB
13. #输出日志，如果换成DEBUG表示输出DEBUG以上级别日志
14. log4j.appender.File.Threshold=ALL
15. log4j.appender.File.layout=org.apache.log4j.PatternLayout
16. log4j.appender.File.layout.ConversionPattern=[%p][%t][%d{yyyy-MM-dd HH\:mm\:ss}][%C] - %m%n

2.4  新建springmvc配置文件

spring-mvc.xml

1. <?xml version="1.0" encoding="UTF-8"?>
2. <beans xmlns="http://www.springframework.org/schema/beans"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p"
4. xmlns:context="http://www.springframework.org/schema/context"
5. xmlns:mvc="http://www.springframework.org/schema/mvc"
6. xsi:schemaLocation="http://www.springframework.org/schema/beans
7. http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
8. http://www.springframework.org/schema/context
9. http://www.springframework.org/schema/context/spring-context-4.0.xsd
10. http://www.springframework.org/schema/mvc
11. http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
13. <!-- 自动扫描 @Controller-->
14. <context:component-scan base-package="com.heitian.ssm.controller"/>
16. <!--避免IE执行AJAX时，返回JSON出现下载文件 -->
17. <bean id="mappingJacksonHttpMessageConverter"
18. class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
19. <property name="supportedMediaTypes">
20. <list>
21. <value>text/html;charset=UTF-8</value>
22. </list>
23. </property>
24. </bean>
25. <!-- 启动SpringMVC的注解功能，完成请求和注解POJO的映射 -->
26. <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
27. <property name="messageConverters">
28. <list>
29. <ref bean="mappingJacksonHttpMessageConverter"/> <!-- JSON转换器 -->
30. </list>
31. </property>
32. </bean>
35. <!-- 定义跳转的文件的前后缀 ，视图模式配置 -->
36. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
37. <property name="prefix" value="/WEB-INF/jsp/" />
38. <property name="suffix" value=".jsp"/>
39. </bean>
41. <!-- 文件上传配置 -->
42. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
43. <!-- 默认编码 -->
44. <property name="defaultEncoding" value="UTF-8"/>
45. <!-- 上传文件大小限制为31M，31*1024*1024 -->
46. <property name="maxUploadSize" value="32505856"/>
47. <!-- 内存中的最大值 -->
48. <property name="maxInMemorySize" value="4096"/>
49. </bean>
50. </beans>

2.5  新建spring和mybatis整合所需的配置文件

spring-mybatis.xml 

1. <?xml version="1.0" encoding="UTF-8"?>
2. <beans xmlns="http://www.springframework.org/schema/beans"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx"
5. xsi:schemaLocation="http://www.springframework.org/schema/beans
6. http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
7. http://www.springframework.org/schema/context
8. http://www.springframework.org/schema/context/spring-context-3.1.xsd
9. http://www.springframework.org/schema/tx
10. http://www.springframework.org/schema/tx/spring-tx.xsd">
12. <!-- 自动扫描 -->
13. <context:component-scan base-package="com.heitian.ssm"/>
15. <!-- 第一种方式：加载一个properties文件 -->
16. <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
17. <property name="location" value="classpath:jdbc.properties"/>
18. </bean>
21. <!-- 第二种方式：加载多个properties文件
22. <bean id="configProperties" class="org.springframework.beans.factory.config.PropertiesFactoryBean">
23. <property name="locations">
24. <list>
25. <value>classpath:jdbc.properties</value>
26. <value>classpath:common.properties</value>
27. </list>
28. </property>
29. <property name="fileEncoding" value="UTF-8"/>
30. </bean>
31. <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PreferencesPlaceholderConfigurer">
32. <property name="properties" ref="configProperties"/>
33. </bean>
34. -->
36. <!-- 配置数据源 -->
37. <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
38. destroy-method="close">
39. <property name="driverClassName" value="${driverClasss}"/>
40. <property name="url" value="${jdbcUrl}"/>
41. <property name="username" value="${username}"/>
42. <property name="password" value="${password}"/>
43. <!-- 初始化连接大小 -->
44. <property name="initialSize" value="${initialSize}"></property>
45. <!-- 连接池最大数量 -->
46. <property name="maxActive" value="${maxActive}"></property>
47. <!-- 连接池最大空闲 -->
48. <property name="maxIdle" value="${maxIdle}"></property>
49. <!-- 连接池最小空闲 -->
50. <property name="minIdle" value="${minIdle}"></property>
51. <!-- 获取连接最大等待时间 -->
52. <property name="maxWait" value="${maxWait}"></property>
53. </bean>
55. <!-- mybatis和spring完美整合，不需要mybatis的配置映射文件 -->
56. <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
57. <property name="dataSource" ref="dataSource"/>
58. <!-- 自动扫描mapping.xml文件 -->
59. <property name="mapperLocations" value="classpath:mapping/*.xml"></property>
60. </bean>
62. <!-- DAO接口所在包名，Spring会自动查找其下的类 -->
63. <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
64. <property name="basePackage" value="com.heitian.ssm.dao"/>
65. <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
66. </bean>
69. <!-- (事务管理)transaction manager, use JtaTransactionManager for global tx -->
70. <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
71. <property name="dataSource" ref="dataSource"/>
72. </bean>
74. <!-- (事务管理)transaction manager, use JtaTransactionManager for global tx -->
75. <tx:annotation-driven transaction-manager="transactionManager"/>
76. </beans>

2.6  web.xml配置文件

web.xml

1. <?xml version="1.0" encoding="UTF-8"?>
2. <web-app xmlns="http://java.sun.com/xml/ns/javaee"
3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
5. http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
6. version="3.0">
8. <display-name>web-ssm</display-name>
10. <context-param>
11. <param-name>contextConfigLocation</param-name>
12. <param-value>classpath:spring-mybatis.xml</param-value>
13. </context-param>
15. <context-param>
16. <param-name>log4jConfigLocation</param-name>
17. <param-value>classpath:log4j.properties</param-value>
18. </context-param>
20. <!-- 编码过滤器 -->
21. <filter>
22. <filter-name>encodingFilter</filter-name>
23. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
24. <init-param>
25. <param-name>encoding</param-name>
26. <param-value>UTF-8</param-value>
27. </init-param>
28. </filter>
29. <filter-mapping>
30. <filter-name>encodingFilter</filter-name>
31. <url-pattern>/*</url-pattern>
32. </filter-mapping>
34. <!-- spring监听器 -->
35. <listener>
36. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
37. </listener>
39. <!-- 防止spring内存溢出监听器，比如quartz -->
40. <listener>
41. <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
42. </listener>
45. <!-- spring mvc servlet-->
46. <servlet>
47. <servlet-name>SpringMVC</servlet-name>
48. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
49. <init-param>
50. <param-name>contextConfigLocation</param-name>
51. <param-value>classpath:spring-mvc.xml</param-value>
52. </init-param>
53. <load-on-startup>1</load-on-startup>
54. <async-supported>true</async-supported>
55. </servlet>
56. <servlet-mapping>
57. <servlet-name>SpringMVC</servlet-name>
58. <!-- 此处也可以配置成 *.do 形式 -->
59. <url-pattern>/</url-pattern>
60. </servlet-mapping>
62. <welcome-file-list>
63. <welcome-file>/index.jsp</welcome-file>
64. </welcome-file-list>
66. <!-- session配置 -->
67. <session-config>
68. <session-timeout>15</session-timeout>
69. </session-config>
71. </web-app>

3.  项目配置和部署

3.1   File -> Project Structure，进入创建项目配置窗口。

3.2  创建一个Tomcat容器实例，并把项目部署进去

3.3  项目所需配置好项目访问的根路径，然后启动Tomcat。

3.4  在浏览器地址栏中输入：http://localhost:8080/web-ssm/user/showUser

3.5  项目所需看到图中显示效果，则表示项目搭建成功。

4.  值得注意的地方

搭建好项目的框架之后，启动Tomcat，如果访问 http://localhost:8080/user/showUser 出现如下错误：

出现这个错误是因为少了依赖的jar包，只要在pom文件中添加如下依赖即可。

1. <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
2. <dependency>
3. <groupId>com.fasterxml.jackson.core</groupId>
4. <artifactId>jackson-core</artifactId>
5. <version>2.8.0</version>
6. </dependency>
7. <!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
8. <dependency>
9. <groupId>com.fasterxml.jackson.core</groupId>
10. <artifactId>jackson-databind</artifactId>
11. <version>2.8.0</version>
12. </dependency>

5. 项目下载地址

  项目下载的地址为：https://download.****.net/download/feitailang/10874393