使用了框架進行開發以後,我們用到的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>
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項目已創建完畢。