基於Maven + SSM （Spring、SpringMVC、Mybatis）構建一個簡單的測試項目

時間 2019-11-13

標籤基於 maven ssm spring springmvc mybatis 構建一個簡單測試項目欄目 Maven 简体版

原文原文鏈接

　　最近在公司實習期間的培訓交流中有機會接觸到SSM，而後本身花費1周的時間投入學習。談不上深入理解其中原理，因此沒有涉及理論知識，只是淺層次的學習如何使用，在此將學習過程記錄整理出來，一方面本身備用；另外一方面，分享出來和作技術的各位討論交流。html

　　現階段的我還作不到知行合一，因此決定先學會用，而後再去深究原理。如有不足以及錯誤之處，望多多包涵、指教，謝謝。java

　　廢話很少說，直接開幹！mysql

一、開發環境搭建git

推薦博客地址：程序員

MyEclipse+Tomcat+MAVEN+SVN項目完整環境搭建

二、Maven Web 項目建立github

推薦博客地址：web

使用maven建立web項目

三、SSM整合spring

下面主要介紹三大框架的整合，至於環境的搭建以及項目的建立，參看上面的推薦博文。sql

此次整合分了2個配置文件，一個是spring-mybatis.xml，包含spring和mybatis的配置文件；還有一個是spring-mvc的配置文件。數據庫

此外有2個資源文件：jdbc.propertis和log4j.properties。

完整目錄結構以下（最後附上源碼下載地址，但不建議直接使用源碼，由於本文已經貼出所有代碼）：

使用的框架：

Spring 4.0.2 RELEASE

Spring MVC 4.0.2 RELEASE

MyBatis 3.2.6

四、Maven引入須要的JAR包

　　這裏直接給出全部須要的JAR包，都是基本的JAR包，每一個包是幹什麼的都有註釋，就再也不多說了。請看配置文件。

pom.xml

  1 <properties>
  2         <!-- spring版本號 -->
  3         <spring.version>4.0.2.RELEASE</spring.version>
  4         <!-- mybatis版本號 -->
  5         <mybatis.version>3.2.6</mybatis.version>
  6         <!-- log4j日誌文件管理包版本 -->
  7         <slf4j.version>1.7.7</slf4j.version>
  8         <log4j.version>1.2.17</log4j.version>
  9     </properties>
 10 
 11     <dependencies>
 12         <dependency>
 13             <groupId>junit</groupId>
 14             <artifactId>junit</artifactId>
 15             <version>4.11</version>
 16             <!-- 表示開發的時候引入，發佈的時候不會加載此包 -->
 17             <scope>test</scope>
 18         </dependency>
 19         <!-- spring核心包 -->
 20         <dependency>
 21             <groupId>org.springframework</groupId>
 22             <artifactId>spring-core</artifactId>
 23             <version>${spring.version}</version>
 24         </dependency>
 25 
 26         <dependency>
 27             <groupId>org.springframework</groupId>
 28             <artifactId>spring-web</artifactId>
 29             <version>${spring.version}</version>
 30         </dependency>
 31         <dependency>
 32             <groupId>org.springframework</groupId>
 33             <artifactId>spring-oxm</artifactId>
 34             <version>${spring.version}</version>
 35         </dependency>
 36         <dependency>
 37             <groupId>org.springframework</groupId>
 38             <artifactId>spring-tx</artifactId>
 39             <version>${spring.version}</version>
 40         </dependency>
 41 
 42         <dependency>
 43             <groupId>org.springframework</groupId>
 44             <artifactId>spring-jdbc</artifactId>
 45             <version>${spring.version}</version>
 46         </dependency>
 47 
 48         <dependency>
 49             <groupId>org.springframework</groupId>
 50             <artifactId>spring-webmvc</artifactId>
 51             <version>${spring.version}</version>
 52         </dependency>
 53         <dependency>
 54             <groupId>org.springframework</groupId>
 55             <artifactId>spring-aop</artifactId>
 56             <version>${spring.version}</version>
 57         </dependency>
 58 
 59         <dependency>
 60             <groupId>org.springframework</groupId>
 61             <artifactId>spring-context-support</artifactId>
 62             <version>${spring.version}</version>
 63         </dependency>
 64 
 65         <dependency>
 66             <groupId>org.springframework</groupId>
 67             <artifactId>spring-test</artifactId>
 68             <version>${spring.version}</version>
 69         </dependency>
 70         <!-- mybatis核心包 -->
 71         <dependency>
 72             <groupId>org.mybatis</groupId>
 73             <artifactId>mybatis</artifactId>
 74             <version>${mybatis.version}</version>
 75         </dependency>
 76         <!-- mybatis/spring包 -->
 77         <dependency>
 78             <groupId>org.mybatis</groupId>
 79             <artifactId>mybatis-spring</artifactId>
 80             <version>1.2.2</version>
 81         </dependency>
 82         <!-- 導入java ee jar 包 -->
 83         <dependency>
 84             <groupId>javax</groupId>
 85             <artifactId>javaee-api</artifactId>
 86             <version>7.0</version>
 87         </dependency>
 88         <!-- 導入Mysql數據庫連接jar包 -->
 89         <dependency>
 90             <groupId>mysql</groupId>
 91             <artifactId>mysql-connector-java</artifactId>
 92             <version>5.1.30</version>
 93         </dependency>
 94         <!-- 導入dbcp的jar包，用來在applicationContext.xml中配置數據庫 -->
 95         <dependency>
 96             <groupId>commons-dbcp</groupId>
 97             <artifactId>commons-dbcp</artifactId>
 98             <version>1.2.2</version>
 99         </dependency>
100         <!-- JSTL標籤類 -->
101         <dependency>
102             <groupId>jstl</groupId>
103             <artifactId>jstl</artifactId>
104             <version>1.2</version>
105         </dependency>
106         <!-- 日誌文件管理包 -->
107         <!-- log start -->
108         <dependency>
109             <groupId>log4j</groupId>
110             <artifactId>log4j</artifactId>
111             <version>${log4j.version}</version>
112         </dependency>
113 
114 
115         <!-- 格式化對象，方便輸出日誌 -->
116         <dependency>
117             <groupId>com.alibaba</groupId>
118             <artifactId>fastjson</artifactId>
119             <version>1.1.41</version>
120         </dependency>
121 
122 
123         <dependency>
124             <groupId>org.slf4j</groupId>
125             <artifactId>slf4j-api</artifactId>
126             <version>${slf4j.version}</version>
127         </dependency>
128 
129         <dependency>
130             <groupId>org.slf4j</groupId>
131             <artifactId>slf4j-log4j12</artifactId>
132             <version>${slf4j.version}</version>
133         </dependency>
134         <!-- log end -->
135         <!-- 映入JSON -->
136         <dependency>
137             <groupId>org.codehaus.jackson</groupId>
138             <artifactId>jackson-mapper-asl</artifactId>
139             <version>1.9.13</version>
140         </dependency>
141         <!-- 上傳組件包 -->
142         <dependency>
143             <groupId>commons-fileupload</groupId>
144             <artifactId>commons-fileupload</artifactId>
145             <version>1.3.1</version>
146         </dependency>
147         <dependency>
148             <groupId>commons-io</groupId>
149             <artifactId>commons-io</artifactId>
150             <version>2.4</version>
151         </dependency>
152         <dependency>
153             <groupId>commons-codec</groupId>
154             <artifactId>commons-codec</artifactId>
155             <version>1.9</version>
156         </dependency>
157 
158 
159     </dependencies>

五、Spring與MyBatis整合

首先進行Spring與MyBatis的整合，而後再進行JUnit測試。

5.1 創建JDBC屬性文件

jdbc.properties（文件編碼修改成utf-8）

 1 driver=com.mysql.jdbc.Driver
 2 url=jdbc:mysql://localhost:3306/mybatis
 3 username=dev
 4 password=devlop
 5 #定義初始鏈接數
 6 initialSize=0
 7 #定義最大鏈接數
 8 maxActive=20
 9 #定義最大空閒
10 maxIdle=20
11 #定義最小空閒
12 minIdle=1
13 #定義最長等待時間
14 maxWait=60000

須要自行修改的地方：

url裏面mybatis改成本身的數據庫名
username和password改成本身mysql數據庫的用戶名和密碼

5.2 創建spring-mybatis.xml配置文件

這個文件就是用來完成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" 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-3.1.xsd  
 8     http://www.springframework.org/schema/context  
 9     http://www.springframework.org/schema/context/spring-context-3.1.xsd  
10     http://www.springframework.org/schema/mvc  
11     http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
12     <!-- 自動掃描 -->
13     <context:component-scan base-package="com.wlgg" />
14     <!-- 引入配置文件 -->
15     <bean id="propertyConfigurer"
16         class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
17         <property name="location" value="classpath:jdbc.properties" />
18     </bean>
19 
20     <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
21         destroy-method="close">
22         <property name="driverClassName" value="${driver}" />
23         <property name="url" value="${url}" />
24         <property name="username" value="${username}" />
25         <property name="password" value="${password}" />
26         <!-- 初始化鏈接大小 -->
27         <property name="initialSize" value="${initialSize}"></property>
28         <!-- 鏈接池最大數量 -->
29         <property name="maxActive" value="${maxActive}"></property>
30         <!-- 鏈接池最大空閒 -->
31         <property name="maxIdle" value="${maxIdle}"></property>
32         <!-- 鏈接池最小空閒 -->
33         <property name="minIdle" value="${minIdle}"></property>
34         <!-- 獲取鏈接最大等待時間 -->
35         <property name="maxWait" value="${maxWait}"></property>
36     </bean>
37 
38     <!-- spring和MyBatis完美整合，不須要mybatis的配置映射文件 -->
39     <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
40         <property name="dataSource" ref="dataSource" />
41         <!-- 自動掃描mapping.xml文件 -->
42         <property name="mapperLocations" value="classpath:com/wlgg/mapping/*.xml"></property>
43     </bean>
44 
45     <!-- DAO接口所在包名，Spring會自動查找其下的類 -->
46     <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
47         <property name="basePackage" value="com.wlgg.dao" />
48         <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"></property>
49     </bean>
50 
51     <!-- (事務管理)transaction manager, use JtaTransactionManager for global tx -->
52     <bean id="transactionManager"
53         class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
54         <property name="dataSource" ref="dataSource" />
55     </bean>
56 
57 </beans>

5.3 Log4j的配置

　　爲了方便調試，通常都會使用日誌來輸出信息。

　　Log4j的配置很簡單，並且也是通用的，下面給出一個基本的配置，換到其餘項目中也無需作多大的調整。

log4j.properties

#定義LOG輸出級別
log4j.rootLogger=INFO,Console,File
#定義日誌輸出目的地爲控制檯
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.Target=System.out
#能夠靈活地指定日誌輸出格式，下面一行是指定具體的格式
log4j.appender.Console.layout = org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=[%c] - %m%n

#文件大小到達指定尺寸的時候產生一個新的文件
log4j.appender.File = org.apache.log4j.RollingFileAppender
#指定輸出目錄
log4j.appender.File.File = logs/ssm.log
#定義文件最大大小
log4j.appender.File.MaxFileSize = 10MB
# 輸出因此日誌，若是換成DEBUG表示輸出DEBUG以上級別日誌
log4j.appender.File.Threshold = ALL
log4j.appender.File.layout = org.apache.log4j.PatternLayout
log4j.appender.File.layout.ConversionPattern =[%p] [%d{yyyy-MM-dd HH\:mm\:ss}][%c]%m%n

5.4 JUnit測試

　　通過以上步驟，已經完成了Spring和Mybatis的整合，這樣咱們就能夠編寫一段測試代碼來試試是否成功了。

（1）建立測試用表

此時須要在mysql數據庫中創建一個測試表，建表的SQL語句以下：

 1 DROP TABLE IF EXISTS `user_t`;  
 2   
 3 CREATE TABLE `user_t` (  
 4   `id` int(11) NOT NULL AUTO_INCREMENT,  
 5   `user_name` varchar(40) NOT NULL,  
 6   `password` varchar(255) NOT NULL,  
 7   `age` int(4) NOT NULL,  
 8   PRIMARY KEY (`id`)  
 9 ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;  
10   
11 /*Data for the table `user_t` */  
12   
13 insert  into `user_t`(`id`,`user_name`,`password`,`age`) values (1,'測試','123456',23);

（2）利用MyBatis Generator自動建立代碼

推薦博客地址：

使用MyBatis Generator自動建立代碼

使用這種方式能夠根據表自動建立實體類、MyBatis映射文件以及DAO接口。

這裏建議將生成的接口名改成IUserDao，而不是直接使用它生成的UserMapper。若是不想麻煩也能夠不改。完成後將文件複製到工程中。以下圖：

（3）創建Service接口和實現類

目錄結構：

下面貼出具體代碼：

IUserService.java

1 package com.wlgg.service;
2 
3 import com.wlgg.entity.User;
4 
5 public interface IUserService {
6     public User getUserById(int userId);
7 }

UserServiceImpl.java

 1 package com.wlgg.service.impl;
 2 
 3 import javax.annotation.Resource;
 4 
 5 import org.springframework.stereotype.Service;
 6 
 7 import com.wlgg.dao.IUserDao;
 8 import com.wlgg.entity.User;
 9 import com.wlgg.service.IUserService;
10 
11 @Service("userService")
12 public class UserServiceImpl implements IUserService {
13     @Resource
14     private IUserDao userDao;
15     public User getUserById(int userId) {
16         // TODO Auto-generated method stub
17         return this.userDao.selectByPrimaryKey(userId);
18     }
19 
20 }

（4）創建測試類

測試類在src/test/java中創建。若是測試成功，表示Spring和Mybatis已經整合成功了。使用Log4j輸出信息打印到控制檯。

測試代碼以下：

 1 import javax.annotation.Resource;
 2 
 3 import org.apache.log4j.Logger;
 4 import org.junit.Before;
 5 import org.junit.Test;
 6 import org.junit.runner.RunWith;
 7 import org.springframework.context.ApplicationContext;
 8 import org.springframework.context.support.ClassPathXmlApplicationContext;
 9 import org.springframework.test.context.ContextConfiguration;
10 import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
11 
12 import com.alibaba.fastjson.JSON;
13 import com.wlgg.entity.User;
14 import com.wlgg.service.IUserService;
15 
16 @RunWith(SpringJUnit4ClassRunner.class)        //表示繼承了SpringJUnit4ClassRunner類
17 @ContextConfiguration(locations = {"classpath:spring-mybatis.xml"})
18 
19 public class TestMyBatis {
20     private static Logger logger = Logger.getLogger(TestMyBatis.class);
21 //    private ApplicationContext ac = null;
22     @Resource
23     private IUserService userService = null;
24 
25 //    @Before
26 //    public void before() {
27 //        ac = new ClassPathXmlApplicationContext("applicationContext.xml");
28 //        userService = (IUserService) ac.getBean("userService");
29 //    }
30 
31     @Test
32     public void test1() {
33         User user = userService.getUserById(1);
34 //        System.out.println(user.getUserName());
35 //        logger.info("值："+user.getUserName());
36         logger.info(JSON.toJSONString(user));
37     }
38 }

測試結果：

至此，完成Spring和Mybatis這兩大框架的整合，下面繼續進行與SpringMVC的整合。

六、整合SpringMVC

上面已經完成了2大框架的整合，SpringMVC的配置文件單獨放，而後在web.xml中配置整合。

6.1 配置spring-mvc.xml

配置裏面的註釋很詳細，在此就不說了，主要是自動掃描控制器，視圖模式，註解的啓動這三個。直接貼出代碼以下：

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-3.1.xsd  
 8     http://www.springframework.org/schema/context  
 9     http://www.springframework.org/schema/context/spring-context-3.1.xsd  
10     http://www.springframework.org/schema/mvc  
11     http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
12     <!-- 自動掃描該包，使SpringMVC認爲包下用了@controller註解的類是控制器 -->
13     <context:component-scan base-package="com.wlgg.controller" />
14     <!--避免IE執行AJAX時，返回JSON出現下載文件 -->
15     <bean id="mappingJacksonHttpMessageConverter"
16         class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter">
17         <property name="supportedMediaTypes">
18             <list>
19                 <value>text/html;charset=UTF-8</value>
20             </list>
21         </property>
22     </bean>
23     <!-- 啓動SpringMVC的註解功能，完成請求和註解Entity的映射 -->
24     <bean
25         class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
26         <property name="messageConverters">
27             <list>
28                 <ref bean="mappingJacksonHttpMessageConverter" />    <!-- JSON轉換器 -->
29             </list>
30         </property>
31     </bean>
32     <!-- 定義跳轉的文件的先後綴 ，視圖模式配置-->
33     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
34         <!-- 這裏的配置個人理解是自動給後面action的方法return的字符串加上前綴和後綴，變成一個 可用的url地址 -->
35         <property name="prefix" value="/WEB-INF/jsp/" />
36         <property name="suffix" value=".jsp" />
37     </bean>
38     
39     <!-- 配置文件上傳，若是沒有使用文件上傳能夠不用配置，固然若是不配，那麼配置文件中也沒必要引入上傳組件包 -->
40     <bean id="multipartResolver"  
41         class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
42         <!-- 默認編碼 -->
43         <property name="defaultEncoding" value="utf-8" />  
44         <!-- 文件大小最大值 -->
45         <property name="maxUploadSize" value="10485760000" />  
46         <!-- 內存中的最大值 -->
47         <property name="maxInMemorySize" value="40960" />  
48     </bean> 
49 
50 </beans>

6.2 配置web.xml

這裏面對spring-mybatis.xml的引入以及配置spring-mvc的Servlet就是爲了完成SSM整合。以前已完成的2個框架整合不須要在此處進行任何配置。配置同樣有詳細註釋，很少解釋了。

web.xml

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3     xmlns="http://java.sun.com/xml/ns/javaee"
 4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
 5     version="3.0">
 6     <display-name>SSMTest</display-name>
 7     <!-- Spring和mybatis的配置文件 -->
 8     <context-param>
 9         <param-name>contextConfigLocation</param-name>
10         <param-value>classpath:spring-mybatis.xml</param-value>
11     </context-param>
12     <!-- 編碼過濾器 -->
13     <filter>
14         <filter-name>encodingFilter</filter-name>
15         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
16         <async-supported>true</async-supported>
17         <init-param>
18             <param-name>encoding</param-name>
19             <param-value>UTF-8</param-value>
20         </init-param>
21     </filter>
22     <filter-mapping>
23         <filter-name>encodingFilter</filter-name>
24         <url-pattern>/*</url-pattern>
25     </filter-mapping>
26     <!-- Spring監聽器 -->
27     <listener>
28         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
29     </listener>
30     <!-- 防止Spring內存溢出監聽器 -->
31     <listener>
32         <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class>
33     </listener>
34 
35     <!-- Spring MVC servlet -->
36     <servlet>
37         <servlet-name>SpringMVC</servlet-name>
38         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
39         <init-param>
40             <param-name>contextConfigLocation</param-name>
41             <param-value>classpath:spring-mvc.xml</param-value>
42         </init-param>
43         <load-on-startup>1</load-on-startup>
44         <async-supported>true</async-supported>
45     </servlet>
46     <servlet-mapping>
47         <servlet-name>SpringMVC</servlet-name>
48         <!-- 此處能夠能夠配置成*.do，對應struts的後綴習慣 -->
49         <url-pattern>/</url-pattern>
50     </servlet-mapping>
51     <welcome-file-list>
52         <welcome-file>/index.jsp</welcome-file>
53     </welcome-file-list>
54     <!-- 配置SESSION超時，單位是分鐘 -->
55     <session-config>
56         <session-timeout>15</session-timeout>
57     </session-config>
58 
59 </web-app>

6.3 測試

　　至此已經完成了SSM三大框架的整合了。來測試一下，若是成功了，那麼恭喜你；若是失敗了，繼續調試吧，做爲程序員就是不停地與BUG作鬥爭！

我是從屢次「404」的戰場中爬出來的，真的要注意細節！！！

（1）新建jsp頁面

showUser.jsp

此頁面僅輸出一下用戶名，完成一個完整的簡單測試。

代碼以下：

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
	<title>測試</title>
  </head>
  
  <body>
    ${user.userName}
  </body>
</html>

（2）創建UserController類

UserController.java 　　控制器

代碼以下：

 1 package com.wlgg.controller;
 2 
 3 import javax.annotation.Resource;
 4 import javax.servlet.http.HttpServletRequest;
 5 
 6 import org.springframework.stereotype.Controller;
 7 import org.springframework.ui.Model;
 8 import org.springframework.web.bind.annotation.RequestMapping;
 9 
10 import com.wlgg.entity.User;
11 import com.wlgg.service.IUserService;
12 
13 @Controller
14 @RequestMapping("/user")
15 public class UserController {
16     @Resource
17     private IUserService userService;
18     
19     @RequestMapping("/showUser")
20     public String toIndex(HttpServletRequest request,Model model){
21         int userId = Integer.parseInt(request.getParameter("id"));
22         User user = this.userService.getUserById(userId);
23         model.addAttribute("user", user);
24         return "showUser";
25     }
26 }