Linux教程網 >> Linux基礎 >> Linux教程 >> SpringMVC框架入門配置 IDEA下搭建Maven項目

SpringMVC框架入門配置 IDEA下搭建Maven項目

日期：2017/2/28 13:49:22 编辑：Linux教程

初衷：本人初學SpringMVC的時候遇到各種稀奇古怪的問題，網上各種技術論壇上的帖子又參差不齊，難以一步到位達到配置好的效果，這裡我將我配置的總結寫到這裡供大家初學SpringMVC的同僚們共同學習使用！

關於SpringMVC的介紹我就不在此贅述了，想必每一個配置Spring的人都已經或多或少了解過一些SpringMVC的基礎知識，可能有的人用的myeclipse或者eclipse進行項目的搭建，我會告訴你這裡步驟是很相似的，在myeclipse裡面需要建立web項目，然後加入Spring支持，後續的jar包自己下載導入，其他配置和本文別無二致。但是本人推薦大家使用idea，這個編譯器公認的java最好用的編譯器，想必編寫代碼會更加的舒適快捷！

這裡只講解如何在IntelliJ IDEA下搭建maven SpringMVC項目：

一、首先需要有一個IntelliJ IDEA 可以去官網下載，雖然是收費的，然而並不算貴。

二、運行編譯器新建項目

在彈出的窗體中選擇maven，然後勾選要建的maven模板--這裡選webApp

然後填入相應的maven項目組信息（這個是比較隨意的）

這裡填寫自己的maven本地倉庫路徑（這個不用過多解釋吧，用maven的基礎）；

這裡填寫項目名稱以及項目生成路徑，然後在下方檢查填寫是否正確：　　

如果正確就點擊Finish->

maven會自動創建需要的一些配置信息以及目錄結構，在這段時間裡我們可以查找需要的jar包並在maven配置文件pom.xml裡面進行配置，見下面步驟：

這裡如果不知道要用到什麼jar包就去百度SpringMVC需要的jar包，然後在maven的官方鏈接單獨查找jar包來配置pom.xml，實例如下（這裡我示范去maven官網查找xml配置的部分，具體需要的jar包去我後面展示的pom.xml裡面查找）：

登錄http://mvnrepository.com/ 示例查找spring-beans

點擊查找結果

這裡可以看到最新版以及使用人數最多的版本，自己選擇--配置文件裡面的jar包版本最好選擇同一個版本避免版本沖突；

我們選擇第一個進入網頁，裡面可以看到maven的配置pom.xml文件寫法，點擊代碼直接復制（自動復制）；

然後將復制的代碼拷貝到pom.xml文件中去即可，maven會自動下載所需要的jar包，我們不需要理會（如果有網絡不順暢情況，請自行想辦法下載jar包或聯系本人，然後將下載好的jar包拷貝到對應的maven本地倉庫文件夾中也可以的）；

這裡我展示我配置的maven pom.xml，maven會自動到庫裡面下載需要的jar包到maven倉庫。

 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>cn.qixiao</groupId>
 5     <artifactId>Liuyanban_SpringMVC</artifactId>
 6     <packaging>war</packaging>
 7     <version>1.0-SNAPSHOT</version>
 8     <name>Liuyanban_SpringMVC Maven Webapp</name>
 9     <url>http://maven.apache.org</url>
10     <dependencies>
11         <!--Unit Test - 單元測試-->
12         <dependency>
13             <groupId>junit</groupId>
14             <artifactId>junit</artifactId>
15             <version>3.8.1</version>
16             <scope>test</scope>
17         </dependency>
18 
19         <dependency>
20             <groupId>org.springframework</groupId>
21             <artifactId>spring-test</artifactId>
22             <version>4.3.1.RELEASE</version>
23         </dependency>
24         <!--spring-->
25         <dependency>
26             <groupId>org.springframework</groupId>
27             <artifactId>spring-beans</artifactId>
28             <version>4.3.1.RELEASE</version>
29         </dependency>
30 
31         <dependency>
32             <groupId>org.springframework</groupId>
33             <artifactId>spring-core</artifactId>
34             <version>4.3.1.RELEASE</version>
35         </dependency>
36 
37         <dependency>
38             <groupId>org.springframework</groupId>
39             <artifactId>spring-context</artifactId>
40             <version>4.3.1.RELEASE</version>
41         </dependency>
42 
43         <!--Spring Web + Spring MVC-->
44         <dependency>
45             <groupId>org.springframework</groupId>
46             <artifactId>spring-web</artifactId>
47             <version>4.3.1.RELEASE</version>
48         </dependency>
49         <dependency>
50             <groupId>org.springframework</groupId>
51             <artifactId>spring-webmvc</artifactId>
52             <version>4.3.1.RELEASE</version>
53         </dependency>
54 
55         <!--DataBase-數據庫連接 mysql包-->
56         <dependency>
57             <groupId>mysql</groupId>
58             <artifactId>mysql-connector-java</artifactId>
59             <version>6.0.3</version>
60         </dependency>
61         <!--數據庫連接池設置-->
62         <dependency>
63             <groupId>c3p0</groupId>
64             <artifactId>c3p0</artifactId>
65             <version>0.9.1.2</version>
66         </dependency>
67 
68         <!--NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config-->
69         <!-- https://mvnrepository.com/artifact/jstl/jstl -->
70         <dependency>
71             <groupId>jstl</groupId>
72             <artifactId>jstl</artifactId>
73             <version>1.2</version>
74         </dependency>
75     </dependencies>
76     <build>
77         <finalName>Liuyanban_SpringMVC</finalName>
78     </build>
79 </project>

pom.xml

等系統構建完成以後，我們就可以看到目錄結構

不全的可以按照需求來補全文件結構，maven項目中的文件結構分為Sources，Tests，Resources，Test Resources，Excluded幾種，我們需要詳細區分各個文件夾的類型：

配置文件夾類型方法如下：

這是我自己留言板項目的目錄結構：

可以選中文件夾點擊上面的按鈕來標注文件夾類型！

三、配置SpringMVC

一切就緒後接下來我們繼續配置SpringMVC的具體信息：

首先需要配置Web.xml這個不必多說，網站項目運行第一個加載的就是web.xml，進入

src->main->webapp->WEB-INF->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     <welcome-file-list>
 7         <welcome-file>/index.jsp</welcome-file>
 8     </welcome-file-list>
 9     <!-- Spring MVC配置 -->
10     <servlet>
11         <servlet-name>spring</servlet-name>
12         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
13 
14         <!-- 可以自定義servlet.xml配置文件的位置和名稱，默認為WEB-INF目錄下，名稱為[<servlet-name>]-servlet.xml，如spring-servlet.xml
15         <init-param>
16             <param-name>contextConfigLocation</param-name>
17             <param-value>/WEB-INF/spring-servlet.xml</param-value>
18         </init-param>-->
19 
20         <!-- load-on-startup元素標記容器是否在啟動的時候就加載這個servlet(實例化並調用其init()方法) -->
21         <load-on-startup>1</load-on-startup>
22     </servlet>
23 
24     <servlet-mapping>
25         <servlet-name>spring</servlet-name>
26         <url-pattern>/</url-pattern>
27         <!--<url-pattern>*.do</url-pattern>-->
28     </servlet-mapping>
29 
30     <!-- Spring配置 -->
31     <listener>
32         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
33     </listener>
34 
35     <!-- 指定Spring Bean的配置文件所在目錄。默認配置在WEB-INF目錄下 -->
36     <context-param>
37         <param-name>contextConfigLocation</param-name>
38         <param-value>classpath:applicationContext.xml</param-value>
39     </context-param>
40  </web-app>

然後在WEB-INF文件夾下新建 spring-servlet.xml

配置spring-servlet.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:tx="http://www.springframework.org/schema/tx"
 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/tx
 9 http://www.springframework.org/schema/tx/spring-tx-3.1.xsd
10 http://www.springframework.org/schema/context
11 http://www.springframework.org/schema/context/spring-context-3.1.xsd
12 http://www.springframework.org/schema/mvc
13 http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">
14 
15     <!-- 啟動注解驅動的Spring MVC功能，注冊請求url和注解POJO類方法的映射-->  
16     <mvc:annotation-driven >
17          
18     </mvc:annotation-driven>
19    
20     <!-- 啟動包掃描功能，以便注冊帶有@Controller、@service、@repository、@Component等注解的類成為spring的bean -->
21     <context:component-scan base-package="liuyanban.controller" />
22     <!-- 對模型視圖名稱的解析，在請求時模型視圖名稱添加前後綴 -->
23      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
24          <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
25          <property name="prefix" value="/"/>    <!-- 前綴 -->
26          <property name="suffix" value=".jsp"/>    <!-- 後綴 -->
27      </bean>
28     <!-- 訪問靜態文件（jpg,js,css）的方法 -->
29     <mvc:resources location="/images/" mapping="/images/**" />
30     <mvc:resources location="/scripts/" mapping="/scripts/**" />
31     <mvc:resources location="/styles/" mapping="/styles/**" />
32 </beans>

然後在Resources資源文件夾下新建applicationContext.xml

配置applicationContext.xml這裡並沒有進行配置什麼信息，因為本人用的是mysql jdbc連接數據庫，沒有用到Hibernate之類的orm，這裡可以將hibernate相關配置項放在裡面。

1 <?xml version="1.0" encoding="UTF-8"?>
2 <beans
3         xmlns="http://www.springframework.org/schema/beans"
4         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5         xmlns:p="http://www.springframework.org/schema/p"
6         xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">
7     <!-- 我們可以在其中添加我們所需要配置的bean，也可以添加相應的數據庫連接和事務處理等等，方便後續拓展
8            -->
9 </beans>

這裡我們就將SpringMVC的基本XML配置文件設置完畢，接下來我們進行一個小實例進行測試配置好的SpringMVC。

四：測試SpringMVC配置：

1、在controller文件夾下新建一個類名字叫TestController，代碼如下：

 1 package liuyanban.controller;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 import org.springframework.web.bind.annotation.ResponseBody;
 6 
 7 /**
 8  * Created by Administrator on 2016/8/29.
 9  */
10 
11 @Controller
12 @RequestMapping(value = "/Test/*") //訪問的url地址前綴，可以不寫，寫了就必須在方法url前面先加上class url 進行區分控制器
13 public class TestController {
14 
15     //訪問地址：http://localhost:8080/Test/returnSuccess
16     @RequestMapping(value = "returnSuccess")    //實際訪問的url地址
17     public String returnSuccess()
18     {
19         return "/Views/success";    //返回Views文件夾下的success.jsp頁面
20     }
21 
22     //訪問地址：http://localhost:8080/Test/returnString
23     @RequestMapping(value = "returnString", produces = {"text/plain;charset=UTF-8"})  //produces用於解決返回中文亂碼問題，application/json;為json解決中文亂碼
24     @ResponseBody       //用於返回字符串,不寫即返回視圖
25     public String returnString()
26     {
27         return "hello return string 這是中文，並沒有亂碼";
28     }
29 }

運行後，在浏覽器地址欄輸入：http://localhost:8080/Test/returnString

可以看到我們運行第二個url地址可以成功返回字符串，而且並沒有中文亂碼！

下面測試第一個url地址：http://localhost:8080/Test/returnSuccess

可以看到，成功返回到success.jsp(我的success.jsp裡面就有一句success)！說明我們的SpringMVC並沒有配置錯誤。

還有人習慣於使用Json，這裡可以將json直接當string輸出，前台就可以獲取到，json的jar包配置也可以自行查詢，這裡不再贅述。

Spring學習之第一個Spring MVC程序（IDEA開發環境） http://www.linuxidc.com/Linux/2016-06/132658.htm

SpringMVC總結篇 http://www.linuxidc.com/Linux/2016-06/132659.htm

Spring+SpringMVC企業快速開發架構搭建 http://www.linuxidc.com/Linux/2015-09/122942.htm

SpringMVC的亂碼處理 http://www.linuxidc.com/Linux/2015-07/120542.htm

Spring MVC+Spring3+Hibernate4開發環境搭建 http://www.linuxidc.com/Linux/2013-07/87119.htm

Spring MVC整合Freemarker基於注解方式 http://www.linuxidc.com/Linux/2013-02/79660.htm

基於注解的Spring MVC簡單介紹 http://www.linuxidc.com/Linux/2012-02/54896.htm