使用Eclipse構建Maven的SpringMVC項目

文章目錄

•  
• 一、直接建立Maven項目方法

 

        首先Eclipse需要安裝Maven的外掛程式，地址：http://m2eclipse.sonatype.org/sites/m2e。

        用MyEclipse安裝Maven外掛程式，建出的Maven項目有些問題。一是，發布tomcat的時候resources總是不會被發布到tomcat下；二是，把WEB-INF下的classes改到target下的classes，但是不知道為什麼MyEclipse要麼仍然在WEB-INF下產生class。要麼真不在WEB-INF產生classes了但是發布tomcat的時候，class檔案一個都不會給你發布過去，超級鬱悶。但是使用Eclipse構建Maven項目後，使用MyEclipse開啟就沒問題了。

        用maven的好處：我感覺最主要就是自動下載jar包和它所依賴的包，這樣可以保證了多人開發時jar版本不同的問題。再就是檔案結構清晰，java檔案，資源檔，測試檔案都分的很清楚。

        將介紹兩種方法：一，直接建立Maven項目方法；二、建立Dynamic Web project轉成Maven項目方法。

一、直接建立Maven項目方法1、建立Maven項目

        接下來使用Eclipse的maven構建一個web項目，以構建SpringMVC項目為例：

1.1 選擇建立Maven Project

選擇File -> New -> Other，在New視窗中選擇 Maven -> Maven Project。點擊newxt。

1.2 選擇項目路徑

Use default Workspace location預設工作空間。

1.3 選擇項目類型

在Artifact Id中選擇maven-archetype-webapp

1.4 輸入Group ID和 Artifact ID，以及Package

Group ID一般寫大項目名稱。Artifact ID是子項目名稱。

例如Spring的web包，Group ID：org.springframework，artifactId：spring-web。

Package是預設給你建一個包，不寫也可以。

1.5 剛建立好後的檔案結構如

如果這裡顯示的內容多，一般是Filters設定的問題。或perspective為JavaEE模式，改成Java模式就可以了。

2、配置Maven項目

接下來就需要更改好多配置了。

2.1 添加Source檔案夾

接下來需要添加src/main/java，src/test/java ，src/test/resources三個檔案夾。右鍵項目根目錄點擊New -> Source Folder，

建出這三個檔案夾。注意不是建普通的Folder，而是Source Folder。

 

 

2.2 更改class路徑

右鍵項目，Java Build Path -> Source

下面應該有4個檔案夾。src/main/java，src/main/resources，src/test/java ，src/test/resources。

雙擊每個檔案夾的Output folder，選擇路徑。

src/main/java，src/main/resources，選擇target/classes;

src/test/java ，src/test/resources, 選擇target/test-classes;

選上Allow output folders for source folders.

 

2.3 把項目變成Dynamic Web項目2.3.1 右鍵項目，選擇Project Facets，點擊Convert to faceted from

2.3.2 配置Project Facets

選擇java且版本1.6,勾選Dynamic Web Module的Version為2.5。(3.0為Java7的)。

如果提示錯誤，可能需要在Java Compiler設定Compiler compliance level 為1.6。或者需要在此視窗的Java的Version改成1.6。

 

另:如果報錯 cannot ….. Dynamic Web Module to 2.5

在workspace中開啟 org.eclipse.wst.common.project.facet.core.xml檔案

修改java version 1.6,jst.web version 2.5,儲存重啟eclipse

<?xml version="1.0" encoding="UTF-8"?><faceted-project>  <fixed facet="wst.jsdt.web"/>  <installed facet="java" version="1.6"/>  <installed facet="jst.web" version="2.5"/>  <installed facet="wst.jsdt.web" version="1.0"/></faceted-project>

2.3.3 配置 Modify Faceted Project

點擊Further configuration available…，彈出Modify Faceted Project視窗

此處是設定web.xml檔案的路徑，我們輸入src/main/webapp。

Generate web.xml deployment descriptor自動產生web.xml檔案，可選可不選。

2.4 設定部署程式集(Web Deployment Assembly)

上面步驟設定完成後，點擊OK，Properties視窗會關閉，在右鍵項目開啟此視窗。在左側列表中會出現一個Deployment Assembly，點擊進去後，如：

此處列表是，部署項目時，檔案發布的路徑。

1，我們刪除test的兩項，因為test是測試使用，並不需要部署。

2，設定將Maven的jar包發布到lib下。

Add -> Java Build Path Entries -> Maven Dependencies -> Finish

設定完成

3、向maven項目中添加jar包

maven可以管理項目依賴的jar包，通過groupID、artifactId以及版本號碼可以唯一確定一個jar包。這樣可以防止老式Web項目中WEB-INF/lib下jar包不一致的問題。並且maven還會自動下載添加進的jar包所依賴的jar包。

3.1 在pom.xml中添加所需要的jar包

使用Maven POM editor開啟項目中的pom.xml檔案，選擇Dependencies，在Dependencies欄目點擊Add進行，首先彈出一個搜尋按鈕，例如輸入spring-web,就會自動搜尋關於spring-web相關的jar包，我們選擇3.0.5版本的spring。將spring包全部添加進來。需要添加的其他jar包有：junit、jstl。或者點擊pom.xml直接編輯pom.xml檔案。這樣可以直接copy過來dependencies內容。

3.2設定jar包的scope

當添加進入一個jar包後，有一些屬性需要設定，最重要的就是scope，它有以下幾種取值：

1. compile，預設值，適用於所有階段，會隨著項目一起發布。

2. provided，類似compile，期望JDK、容器或使用者會提供這個依賴。如servlet.jar。

3. runtime，只在運行時使用，如JDBC驅動，適用運行和測試階段。

4. test，只在測試時使用，用於編譯和運行測試代碼。不會隨項目發布。

5. system，類似provided，需要顯式提供包含依賴的jar，Maven不會在 Repository中尋找它。

通常SpringMVC項目所需要配置scope的jar包如：

有的時候發現servlet-api還是被打包到lib下面了，此時肯定會報錯。就需要把maven外掛程式中的WTP也安裝一下。

Eclipse線上安裝路徑：http://m2eclipse.sonatype.org/sites/m2e-extras。選擇for Eclipse WTP。

 

4、構建SpringMVC架構4.1 編輯web.xml檔案

需要添加log4j，字元過濾，Spring 的dispatcher等。

webx.xml代碼如下：

Xml代碼

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns="http://java.sun.com/xml/ns/javaee"          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee                              http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"          version="2.5" >        <!-- 區分項目名稱，防止預設重名 -->    <context-param>        <param-name>webAppRootKey</param-name>        <param-value>maven.example.root</param-value>    </context-param>    <!-- Spring的log4j監聽器 -->    <listener>        <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>    </listener>    <!-- 字元集 過濾器  -->    <filter>        <filter-name>CharacterEncodingFilter</filter-name>        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>        <init-param>            <param-name>encoding</param-name>            <param-value>UTF-8</param-value>        </init-param>        <init-param>            <param-name>forceEncoding</param-name>            <param-value>true</param-value>        </init-param>    </filter>    <filter-mapping>        <filter-name>CharacterEncodingFilter</filter-name>        <url-pattern>/*</url-pattern>    </filter-mapping>    <!-- Spring view分發器 -->    <servlet>        <servlet-name>dispatcher</servlet-name>        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>        <init-param>            <param-name>contextConfigLocation</param-name>            <param-value>/WEB-INF/dispatcher-servlet.xml</param-value>        </init-param>        <load-on-startup>1</load-on-startup>    </servlet>    <servlet-mapping>        <servlet-name>dispatcher</servlet-name>        <url-pattern>*.do</url-pattern>    </servlet-mapping></web-app>

4.2 編寫Spring設定檔dispatcher-servlet.xml

如要添加MVC驅動、註解檢測、視圖解析等。dispatcher-servlet.xml代碼如下：

Xml代碼

<?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"        xmlns:aop="http://www.springframework.org/schema/aop"        xmlns:context="http://www.springframework.org/schema/context"       xmlns:mvc="http://www.springframework.org/schema/mvc"        xmlns:tx="http://www.springframework.org/schema/tx"        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"       xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsdhttp://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans-3.0.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-3.0.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc-3.0.xsdhttp://www.springframework.org/schema/tx        http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">    <mvc:annotation-driven />    <context:component-scan base-package="com.xujj" />    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">        <property name="prefix" value="/WEB-INF/views/" />        <property name="suffix" value=".jsp" />    </bean></beans>

4.3 編寫一個Controller層測試類別

編寫一個SpringMVC的Controller層測試類別。此類只有一個方法做地址映射，並向頁面傳遞一個資料。代碼如下：

Java代碼

package com.xujj.springweb.ctrl;import org.springframework.stereotype.Controller;import org.springframework.ui.Model;import org.springframework.web.bind.annotation.RequestMapping;@Controllerpublic class GeneralController {        @RequestMapping(value="index.do")    public void index(Model model){        model.addAttribute("xujj","Hello World");        System.out.println("");    }}

4.4 編寫index.jsp頁面

首先在src/main/webapp/WEB-INF下建檔案夾views。此處和dispatcher-servlet.xml設定檔中的prefix屬性路徑要一樣。

在views下建index.jsp檔案

我們使用jstl擷取Controlleradd的資料。

Jsp頁面代碼如下：

Html代碼

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Insert title here</title></head><body></body>    <c:out value="${xujj}}"></c:out></html>

5，發布到tomcat

這個就沒啥說的了。

Eclipse下Tomcat常用設定：http://limingnihao.iteye.com/admin/blogs/825394

6，測試

訪問地址：http://localhost:8080/springweb/

 

轉自:http://limingnihao.iteye.com/blog/830409