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

本文轉載自查看原文 2016-08-29 19:31 24629 JAVA/ SpringMVC

,初衷：本人初學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>qixiao</groupId>
  5   <artifactId>me</artifactId>
  6   <packaging>war</packaging>
  7   <version>1.0-SNAPSHOT</version>
  8   <name>me Maven Webapp</name>
  9   <url>http://maven.apache.org</url>
 10   <dependencies>
 11     <dependency>
 12       <groupId>junit</groupId>
 13       <artifactId>junit</artifactId>
 14       <version>3.8.1</version>
 15       <scope>test</scope>
 16     </dependency>
 17     <dependency>
 18       <groupId>org.springframework</groupId>
 19       <artifactId>spring-test</artifactId>
 20       <version>4.3.1.RELEASE</version>
 21     </dependency>
 22     <!--spring-->
 23     <dependency>
 24       <groupId>org.springframework</groupId>
 25       <artifactId>spring-beans</artifactId>
 26       <version>4.3.1.RELEASE</version>
 27     </dependency>
 28     <dependency>
 29       <groupId>org.springframework</groupId>
 30       <artifactId>spring-core</artifactId>
 31       <version>4.3.1.RELEASE</version>
 32     </dependency>
 33 
 34     <dependency>
 35       <groupId>org.springframework</groupId>
 36       <artifactId>spring-context</artifactId>
 37       <version>4.3.1.RELEASE</version>
 38     </dependency>
 39 
 40     <!--Spring Web + Spring MVC-->
 41     <dependency>
 42       <groupId>org.springframework</groupId>
 43       <artifactId>spring-web</artifactId>
 44       <version>4.3.1.RELEASE</version>
 45     </dependency>
 46     <dependency>
 47       <groupId>org.springframework</groupId>
 48       <artifactId>spring-webmvc</artifactId>
 49       <version>4.3.1.RELEASE</version>
 50     </dependency>
 51 
 52     <!--json支持-->
 53     <!-- https://mvnrepository.com/artifact/org.json/json -->
 54     <dependency>
 55       <groupId>org.json</groupId>
 56       <artifactId>json</artifactId>
 57       <version>20160212</version>
 58     </dependency>
 59     <!-- https://mvnrepository.com/artifact/net.sf.json-lib/json-lib -->
 60     <dependency>
 61       <groupId>net.sf.json-lib</groupId>
 62       <artifactId>json-lib</artifactId>
 63       <version>2.4</version>
 64     </dependency>
 65     <!-- https://mvnrepository.com/artifact/commons-lang/commons-lang -->
 66     <dependency>
 67       <groupId>commons-lang</groupId>
 68       <artifactId>commons-lang</artifactId>
 69       <version>2.6</version>
 70     </dependency>
 71     <!-- https://mvnrepository.com/artifact/commons-beanutils/commons-beanutils -->
 72     <dependency>
 73       <groupId>commons-beanutils</groupId>
 74       <artifactId>commons-beanutils</artifactId>
 75       <version>1.8.3</version>
 76     </dependency>
 77     <!-- https://mvnrepository.com/artifact/commons-collections/commons-collections -->
 78     <dependency>
 79       <groupId>commons-collections</groupId>
 80       <artifactId>commons-collections</artifactId>
 81       <version>3.2.1</version>
 82     </dependency>
 83     <!-- https://mvnrepository.com/artifact/commons-logging/commons-logging -->
 84     <dependency>
 85       <groupId>commons-logging</groupId>
 86       <artifactId>commons-logging</artifactId>
 87       <version>1.2</version>
 88     </dependency>
 89     <!-- https://mvnrepository.com/artifact/net.sf.ezmorph/ezmorph -->
 90     <dependency>
 91       <groupId>net.sf.ezmorph</groupId>
 92       <artifactId>ezmorph</artifactId>
 93       <version>1.0.6</version>
 94     </dependency>
 95     <!--json serialize and deserialization-->
 96     <!-- 引入fastjson依賴 -->
 97     <dependency>
 98       <groupId>com.alibaba</groupId>
 99       <artifactId>fastjson</artifactId>
100       <version>1.2.12</version>
101     </dependency>
102     <!-- 引入gson依賴 -->
103     <dependency>
104       <groupId>com.google.code.gson</groupId>
105       <artifactId>gson</artifactId>
106       <version>2.6.2</version>
107     </dependency>
108     <!--NoClassDefFoundError: javax/servlet/jsp/jstl/core/Config-->
109     <!-- https://mvnrepository.com/artifact/jstl/jstl -->
110     <dependency>
111       <groupId>jstl</groupId>
112       <artifactId>jstl</artifactId>
113       <version>1.2</version>
114     </dependency>
115 
116 
117 
118   </dependencies>
119   <build>
120     <finalName>me</finalName>
121   </build>
122 </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 
41 </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"
 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-3.1.xsd">
12 
13     <!-- 啟動注解驅動的Spring MVC功能，注冊請求url和注解POJO類方法的映射-->  
14     <mvc:annotation-driven >
15          
16     </mvc:annotation-driven>
17    
18     <!-- 啟動包掃描功能，以便注冊帶有@Controller、@service、@repository、@Component等注解的類成為spring的bean -->
19     <context:component-scan base-package="HelloSpringMvc.controller" />
20     <!-- 對模型視圖名稱的解析，在請求時模型視圖名稱添加前后綴 -->
21      <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
22          <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
23          <property name="prefix" value="/"/>    <!-- 前綴 -->
24          <property name="suffix" value=".jsp"/>    <!-- 后綴 -->
25      </bean>
26     <!-- 訪問靜態文件（jpg,js,css）的方法 -->
27     <mvc:resources location="/files/" mapping="/files/**" />
28     <mvc:resources location="/scripts/" mapping="/scripts/**" />
29     <mvc:resources location="/styles/" mapping="/styles/**" />
30     <mvc:resources location="/Views/" mapping="/Views/**" />
31 </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         xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.1.xsd">
6     <!-- 我們可以在其中添加我們所需要配置的bean，也可以添加相應的數據庫連接和事務處理等等，方便后續拓展
7            -->
8 </beans>

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

四：測試SpringMVC配置：

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

package HelloSpringMvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

/**
 * Created by Administrator on 2016/8/29.
 */

@Controller
@RequestMapping(value = "/Test/*") //訪問的url地址前綴，可以不寫，寫了就必須在方法url前面先加上class url 進行區分控制器
public class TestController
{
    //訪問地址：http://localhost:8080/Test/returnSuccess
    @RequestMapping(value = "returnSuccess")    //實際訪問的url地址
    public String returnSuccess() {
        return "/Views/success";    //返回Views文件夾下的success.jsp頁面
    }

    //訪問地址：http://localhost:8080/Test/returnString
    @RequestMapping(value = "returnString", produces = {"text/plain;charset=UTF-8"})
    //produces用於解決返回中文亂碼問題，application/json;為json解決中文亂碼
    @ResponseBody       //用於返回字符串,不寫即返回視圖
    public String returnString() {
        return "hello return string 這是中文，並沒有亂碼";
    }
}