IDEA下創建一個Maven + SpringMVC項目

這幾天就開始學習Spring框架了, 工欲善其事, 必先利其器, 所以就從搭建環境開始吧. 因爲是剛開始學習, 所以對有些配置文件瞭解的不是很清楚, 這期間也參考了很多博客, 暫且將搭建步驟記錄下來, 以免忘記.

---

創建Maven項目

首先是new一個Project, 選擇創建Maven項目:

Project創建好之後, 進行IDEA的主頁.
在右下角有Maven projects need to be imported, 點擊第二個Enable Auto-Import將Maven需要的包都導入工程, 配置好Maven環境.

在配置好Maven環境之後, 先不要着急在pom.xml中導入常用包, 因爲網上給出的大多數pom.xml文件的dependecy標籤集中都含有Spring MVC框架的包, 但這往往並不是Spring的核心包, 如果你直接導入進pom.xml文件之後, Maven就會開始自動下載, 這會導致你在之後添加Spring MVC框架失敗, 由於有與Spring相關的包被下載到當前工程, IDEA會認爲你已經添加了Spring MVC框架, 所以在框架的選項中就不會再出現Spring框架了.
所以在將包導入pom.xml文件之前我們先來添加Spring MVC框架.

添加Spring MVC框架

右擊左上角你的Project的名字, 點擊Add Framework Support, 會出現下面這個框:

選擇Spring MVC, 然後點擊OK. 這樣Spring MVC的框架就添加好了. 此時在webapp下的WEB-INF目錄下會有三個XML文件, 分別爲:web.xml/dispatcher-servlet.xml/applicationContext.xml, 這三個XML文件是Spring MVC的核心配置文件, 我們將稍後介紹到.

配置pom.xml文件

添加好了Spring MVC框架, 接下來就是配置pom.xml了. 將下面的代碼複製粘貼至pom.xml中的dependencies標籤之間, 然後靜靜的等待它們自動下載完成就好了.

    <!--測試-->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.12</version>
      <scope>test</scope>
    </dependency>
    <!--日誌-->
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.21</version>
    </dependency>
    <!--J2EE-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.2</version>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>
    <!--mysql驅動包-->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.35</version>
    </dependency>
    <!--springframework-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>4.2.6.RELEASE</version>
    </dependency>
    <dependency>
      <groupId>com.github.stefanbirkner</groupId>
      <artifactId>system-rules</artifactId>
      <version>1.16.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>org.aspectj</groupId>
      <artifactId>aspectjweaver</artifactId>
      <version>1.8.9</version>
    </dependency>
    <!--其他需要的包-->
    <dependency>
      <groupId>org.apache.commons</groupId>
      <artifactId>commons-lang3</artifactId>
      <version>3.4</version>
    </dependency>
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.1</version>
    </dependency>

配置web.xml文件

接下來是web.xml. web.xml配置文件都是項目的核心配置, 比如對中文碼的解析, 對加載本地資源的過濾屬性等. IDEA下自動生成的web.xml的版本是2.3的, 這個版本太低導致有些配置結點IDEA會識別不出來, 所以我們重新添加一個3.1版本的, 你可以直接將下面的代碼複製進web.xml中就好了.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">

    <display-name>Archetype Created Web Application</display-name>

    <!--welcome pages-->
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>

    <!--配置springmvc DispatcherServlet-->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!--配置dispatcher.xml作爲mvc的配置文件-->
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/dispatcher-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <async-supported>true</async-supported>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!--把applicationContext.xml加入到配置文件中-->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

</web-app>

配置disptcher-servlet.xml文件

同樣的, 將下面的代碼複製進你的dispatcher-servlet文件中就可以了.
需要注意的是, 我將靜態資源配置註釋了起來, 因爲當前的WEB-INF下還沒有創建static目錄及下面的css/js/image目錄, 等到需要的時候再進行創建, 並取消註釋就可以了.
還有就是代碼最後的自動掃描配置, 這涉及到Spring框架的具體學習, 如果你繼續學習Spring可以看我之後的博客, 再進行了解.
而它的base-package就是後面要運行出來的hello spring的MainController類所在的Controller包.

<?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.xsd">
    <!--此文件負責整個mvc中的配置-->

    <!--啓用spring的一些annotation -->
    <context:annotation-config/>

    <!-- 配置註解驅動 可以將request參數與綁定到controller參數上 -->
    <mvc:annotation-driven/>

    <!--靜態資源映射-->
    <!--本項目把靜態資源放在了webapp的statics目錄下，資源映射如下-->
    <!--<mvc:resources mapping="/css/**" location="/WEB-INF/statics/css/"/>-->
    <!--<mvc:resources mapping="/js/**" location="/WEB-INF/statics/js/"/>-->
    <!--<mvc:resources mapping="/image/**" location="/WEB-INF/statics/image/"/>-->

    <!-- 對模型視圖名稱的解析，即在模型視圖名稱添加前後綴(如果最後一個還是表示文件夾,則最後的斜槓不要漏了) 使用JSP-->
    <!-- 默認的視圖解析器 在上邊的解析錯誤時使用 (默認使用html)- -->
    <bean id="defaultViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
        <property name="prefix" value="/WEB-INF/view/"/><!--設置JSP文件的目錄位置-->
        <property name="suffix" value=".jsp"/>
        <property name="exposeContextBeansAsAttributes" value="true"/>
    </bean>

    <!-- 自動掃描裝配 -->
    <context:component-scan base-package="Controller"/>
</beans>

配置applicationContext.xml文件

當前這個XML文件裏是不需要配置什麼的, 你只需要讓它保持Spring被創建之初的原樣就可以了, 先不用去管它.

配置tomcat

最後就是配置tomcat了, Maven下的tomcat的配置還有一點點不一樣.

先進入Edit, 進入配置.

然後添加tomcat->local

點擊右下方的fix

選擇exploded

tomcat配置完成!

hello Spring

到這裏環境就準備好了, 就可以編寫hello Spring了!
在main下創建java目錄, 並將其設置爲Sources(右擊java目錄, 然後選擇mark derectory as, 然後選擇sources就好了), 然後建一個Controller包, 並新建MainController類.
MainController類的內容如下:

@Controller
@RequestMapping(value = "/main")
public class MainController {

    @RequestMapping(method = RequestMethod.GET)
    @ResponseBody
    public String welcome(){
        return "hello Spring!";
    }
}

編寫完成運行tomcat, 地址欄的localhost:8080後添加/main, 結果如下: