1. 程式人生 > >手把手教你在Eclipse上建立一個Maven+Spring MVC的HelloWord專案

手把手教你在Eclipse上建立一個Maven+Spring MVC的HelloWord專案

         使用了框架進行開發以後,我們用到的jar包會越來越多,每次都手動下載然後拷貝進專案的話,這樣會比較麻煩,而且有時候不能很好地處理jar包傳遞依賴的問題。慶幸的是,Maven出現了,它可以極大地方便了我們對依賴的管理。只要填寫好pom.xml這個配置檔案,那麼Maven會自動為我們下載該jar包及其所依賴的jar包,所以這裡我建立一個基於Maven的Spring MVC專案。

        建立Maven專案,首先得安裝好Maven環境。如未安裝好環境,可參考文章:Maven的安裝和配置

下面是建立的詳細步驟:

1、新建專案




2、解決專案報錯(沒有報錯則跳過此步驟)

新建了專案後,我發現專案中報了以下的錯。

現解決一下。如果沒有報錯的話,就忽略此步驟。

解決方法:

(1)右擊專案名 -> Buid Path -> Configure Build Path,

(2)選擇Libraries選項卡,點選Add Library -> Server Runtime ,

(3)選擇一個已建好的tomcat,沒有建立tomcat的,請先配置好tomcat。

(4)點選 finish, 可看到如下截圖。

點選Apply之後,正常情況下,可以看到專案的紅叉已消失。

然後切換到Order and Export 選項:

點選上圖的OK之後,可以看到,缺失的資原始檔src/main/java和src/test/java已經有了。

注意:作為Maven專案必須包含以下4個資原始檔夾,如果沒有,需要手動建立。


新建資原始檔夾的步驟:



4個資原始檔建好之後,還需設定正確的Output folder。



3、更改配置檔案pom.xml

這是Maven的主要配置檔案,可以在裡面配置專案所需要的jar包。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.hello</groupId>
  <artifactId>HelloSpringMVC</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>HelloSpringMVC Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-web</artifactId>
    	<version>${springVersion}</version>
    </dependency>
    <dependency>
    	<groupId>org.springframework</groupId>
    	<artifactId>spring-webmvc</artifactId>
    	<version>${springVersion}</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>HelloSpringMVC</finalName>
  </build>
  <properties>
  	<springVersion>4.2.3.RELEASE</springVersion>
  </properties>
</project>



4、更改配置檔案web.xml


<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_3_0.xsd"  
      version="3.0">  
    <display-name>HelloSpringMVC</display-name>
   
     <!-- 前端控制器 -->
    <servlet>  
        <servlet-name>spring-mvc</servlet-name>  <!-- 名稱,真實的檔名需要在這個名字後面加上-servlet字尾 -->
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!--  DispatcherServlet路徑,照寫 -->
       
      	<!--   這裡可以設定前端控制器的路徑,如果這一步註釋掉,則預設前端控制器的路徑為:/WEB-INF/[servlet-name]-servlet.xml
       <init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/configs/spring-mvc-servlet.xml</param-value> 這裡配置前端控制器的路徑
		</init-param>  
		-->
		
        <load-on-startup>1</load-on-startup>
    </servlet>  
  	
  	<!-- 攔截所有請求 -->
    <servlet-mapping>  
        <servlet-name>spring-mvc</servlet-name>     <!-- 這裡的名字要和上面的servlet-name統一 -->
        <url-pattern>/</url-pattern>  
    </servlet-mapping>  
</web-app>

5、新建前端控制器配置檔案

因為這裡使用的是預設的路徑,所以只需要在WEB-INF目錄下建立前端控制器檔案。

又因為在web.xml中配置的名稱是spring-mvc,所以新建的檔名是spring-mvc-servlet。


6、新增spring-mvc-servlet.xml的內容

<?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:p="http://www.springframework.org/schema/p" 
    xmlns:context="http://www.springframework.org/schema/context" 
    xmlns:mvc="http://www.springframework.org/schema/mvc" 
    xmlns:task="http://www.springframework.org/schema/task"
    xsi:schemaLocation="
        http://www.springframework.org/schema/beans 
        http://www.springframework.org/schema/beans/spring-beans-4.2.xsd 
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-4.2.xsd 
        http://www.springframework.org/schema/mvc 
        http://www.springframework.org/schema/mvc/spring-mvc-4.2.xsd 
        http://www.springframework.org/schema/task 
        http://www.springframework.org/schema/task/spring-task-4.2.xsd">

    <!-- 掃描路徑 -->
    <context:component-scan base-package="com.springmvc.controller" >
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

    <!-- 配置根檢視 -->
    <mvc:view-controller path="/" view-name="index"/>

    <!-- 啟用基於註解的配置 @RequestMapping, @ExceptionHandler,資料繫結 ,@NumberFormat ,
    @DateTimeFormat ,@Controller ,@Valid ,@RequestBody ,@ResponseBody等  -->
    <mvc:annotation-driven />

    <!-- 靜態資源配置 -->
    <mvc:resources location="/assets/" mapping="/assets/**"></mvc:resources>

    <!-- 檢視層配置 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/view/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

7、新增Controller類

書寫HelloController.java的內容

package com.springmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

//url:  http://localhost:8080/HelloSpringMVC/hello/mvc

//告訴DispatcherServlet相關的容器, 這是一個Controller,
@Controller  

//類級別的RequestMapping,告訴DispatcherServlet由這個類負責處理URL。
//HandlerMapping依靠這個標籤來工作
@RequestMapping(value="/hello")  
public class HelloController {
		
	//方法級別的RequestMapping, 限制並縮小了URL路徑匹配,同類級別的標籤協同工作,最終確定攔截到的URL由那個方法處理
	//並指定訪問方法為GET
	  @RequestMapping(value="/mvc",method=RequestMethod.GET)  
	    public String HelloWorld(Model model){  
		  
	        model.addAttribute("message","Hello Spring MVC!!!");  //傳引數給前端
	        
	      //檢視渲染,/WEB-INF/view/HelloWorld.jsp
	        return "HelloWorld";  //頁面的名稱,根據此字串會去尋找名為HelloWorld.jsp的頁面
	    }  
}

8、新增頁面

新建檢視資料夾


 

  

新建頁面

注意加.jsp字尾

新增頁面內容:

<%@ page language="java" contentType="text/html; charset=UTF-8"  
    pageEncoding="UTF-8"%>  
<!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>HelloSpringMVC</title>  
</head>  
<body>  
<h1>message:${message}</h1>  
<h1>this is my spring mvc</h1>  
</body>  
</html> 

9、解決錯誤(無錯的可以跳過此步驟)

可以看到,自從添加了pom.xml的內容以後,專案是一直有紅叉的,現在基本上Spring MVC的配置已經完成了,那麼就來解決一下。

(1)右擊專案名->Properties(在最下方) ->拖動左側欄,找到Deployment Assembly ->移除多餘部分。

注意:這裡一定要確保Maven Dependencies在 Web Deployment Assembly 中,否則無法訪問controller中的url。

(2)將Maven Dependencies從Build Path中移除。

(3)進入Configure Build Path,重新新增Maven Dependencies這個Library

正常情況,專案已經沒有不報錯了。

10、執行專案

上面這個controller對應的頁面如下:

至此基於Maven+Spring MVC的HelloWord專案已建立完畢。

原始碼下載