使用Eclipse構建Maven的SpringMVC項目

博客分類： Java Spring

使用Eclipse構建Maven的SpringMVC項目

首先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.

在此處還要更改：

更改文件夾顯示的順序：點擊Order and Export。

更改JDK版本：在Libraries雙擊JRE System Library，要1.6版本。

2.3 把項目變成Dynamic Web項目

2.3.1 右鍵項目，選擇Project Facets，點擊Convert to faceted from

2.3.2 配置Project Facets

更改Dynamic Web Module的Version爲2.5。(3.0爲Java7的)。

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

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>
<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>
<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.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx-3.0.xsd">
<mvc:annotation-driven />
<context:component-scan base-package="liming.maven.example" />
<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 liming.maven.example.view;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class GeneralController {
@RequestMapping(value="index.do")
public void index_jsp(Model model){
model.addAttribute("liming", "黎明你好");
System.out.println("index.jsp");
}
}

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>
<c:out value="${liming}"></c:out>
</body>
</html>