手把手教你在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
5、新建前端控制器配置檔案
<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>
因為這裡使用的是預設的路徑,所以只需要在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專案已建立完畢。