1. 程式人生 > >IDEA建立Spring MVC Hello World 詳細入門教程

IDEA建立Spring MVC Hello World 詳細入門教程

solver 也有 就是 內容 彈出 開頭 web-inf 我們 utf

引子,其實從.NET轉Java已經有幾個月時間了,項目也做了不少,但是很多配置都是根據公司模板或者網上教程比忽略畫瓢,對其中最簡單的配置和設置並不完全理解,依舊是小白用戶。最近項目不忙,重新梳理了一下Spring MVC的相關配置,順便保存下來,希望也能幫到其他同學……高手忽略~~~

目錄
  • 通過IDEA新建Spring MVC項目
  • 設置運行、調試相關配置
  • 導入Spring MVC 相關類庫
  • 添加 Controller
  • 修改 url-pattern(web.xml)
  • 配置 component-scan(dispatcher-servlet.xml)
  • 配置 ViewResolver(dispatcher-servlet.xml)
  • 添加視圖文件(.jsp)
  • 通過 Model 向 View 傳值

通過IDEA新建Spring MVC項目

先創建項目,從封面或者主窗體都可以創建

技術分享圖片

技術分享圖片

“New Project”窗口,選擇附加的類庫"Spring MVC"

技術分享圖片

選擇項目名稱和存放的位置

技術分享圖片

最後點擊Finish按鈕,IDEA會幫你下載需要的類庫

技術分享圖片

創建完成後項目有這些文件,主要是三個xml文件+一個index.jsp

這個jsp文件最後肯定是不要的,不過也先不要慌著刪

技術分享圖片

設置運行、調試相關配置

項目建好後,並不能直接運行,Run和Debug菜單都是灰色不能點擊的

要需要做一下運行和調試的相關配置

作為.NET轉Java的碼農,有時候真的很懷念宇宙第一IDE:Visual Studio,根據模板創建的項目很少有不能直接運行的,算了,不說也罷,繼續配置。。。

技術分享圖片技術分享圖片

技術分享圖片

先設置“Server”選項卡

技術分享圖片

點開“Deployment”選項卡,繼續設置,

創建Artifact,最後記得點OK保存

技術分享圖片

現在,Run菜單下出現了Run ‘mvc-helloworld‘的菜單項目(Shift+F10運行,Shift+F9調試)

工具欄上也有了運行和調試按鈕,你可以選擇自己喜歡的方式運行項目

技術分享圖片技術分享圖片

雖然我們還沒開始寫代碼,但是畢竟IDEA幫我們生成了一個jsp文件,可以用這個文件看看站點能否打開(index.jsp代碼如下)

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
  <head>
    <title>$Title$</title>
  </head>
  <body>
  $END$
  </body>
</html>

瀏覽器輸入地址 http://localhost:8080/index.jsp

技術分享圖片

項目是運行不起來的(其實離運行起來,還缺不少配置,繼續往後看),

啥情況?當然要看日誌。。。點開下面的“Tomcat Localhost Log”,可以看到問題出在哪裏。。。

技術分享圖片

java.lang.ClassNotFoundException: org.springframework.web.context.ContextLoaderListener

意思就是找不到ContextLoaderListener這個類

導入Spring MVC相關類庫

Java中,ClassNotFoundException好像是個挺常見的異常,先檢查相應的jar包有沒有包含進來...

打開Project Structure,跟項目相關配置基本都在個菜單裏邊。。。

技術分享圖片

點開"Artifacts"選項卡後,上面有多出很明顯的提示,缺失Spring MVC相關類庫的引用

盡管IDEA搞這麽多提醒,為啥我感覺還是不夠醒目?

技術分享圖片

按照下面的幾個方法修復錯誤,隨便選一種就行

讓程序部署的時候,把Spring MVC相關類庫復制到lib文件夾中

技術分享圖片

重新運行一次項目(Shift+F10運行,Shift+F9調試)……

如果你上次沒有Stop,這次運行可能會彈出這個對話框,選擇“Restart server”然後"OK"吧...

技術分享圖片

再一次訪問 http://localhost:8080/index.jsp

這次終於可以看見點內容了,起碼說明服務啟動了。。

技術分享圖片

如果再看剛才的日誌,原來報錯也沒有了

添加Controller

站點可以打開了,不過我們這個不是MVC,因為沒有M、沒有V也沒有C

我們就從MVC中的C(Controller)開始,繼續配置

在新建Controller之前,首先要建一個包,SpringMVC是沒法運行在默認包下的,按照如下方式建包,

我建的包名稱為:wormday.springmvc.helloworld

其實包名隨意,但是必須要有。。。

技術分享圖片

技術分享圖片

技術分享圖片

再這個包下新建Java Class文件 HiController

技術分享圖片

代碼如下

package wormday.springmvc.helloworld;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hi")
public class HiController {

    @RequestMapping("/say")
    public String say() {
        return "/WEB-INF/jsp/say.jsp";
    }
}

如果你跟我一樣又迫不及待的要訪問一下這個Controller的Action 地址應該是:

http://localhost:8080/hi/say.form 其實這個時候訪問結果是404,因為後邊還有不少配置沒有做...

技術分享圖片

類上的註解@RequestMapping("/hi")指定 Url路徑前邊一部分

方法上的註解@RequestMapping("/say")指定 Url路徑最後一部分

也可以只把註解寫在方法上,比如@RequestMapping("/hi/say”)

那個結尾的form是什麽鬼,就接著看下一段 url-pattern...

修改 url-pattern(web.xml)

先打開web\WEB-INF\web.xml文件

有關於ServletMapping的設置,通過這個設置,可以配置那些類型的url用那些servlet來處理

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.form</url-pattern>
    </servlet-mapping>

結合這一段xml,我們可以看到,IDEA默認幫我配置了一個名字叫做dispatcher的Servlet

這個Servlet使用org.springframework.web.servlet.DispatcherServlet這個類來處理

這個Servlet對應的Url是*.form

如果你跟我一樣不喜歡每個MVC Url後邊都帶一個form,可以改成斜杠

<url-pattern>/</url-pattern>

如果你現在重新啟動程序,然後繼續訪問http://localhost:8080/hi/say

發現,依舊404,並且伴隨每次訪問,都在Server的Output窗口有一個錯誤日誌

org.springframework.web.servlet.PageNotFound.noHandlerFound No mapping found for HTTP request with URI [/hi/say] in DispatcherServlet with name ‘dispatcher‘

技術分享圖片

意思就是沒有找到相應的Controller,不但要把Controller的代碼寫好,還要告訴Spring(在這裏其實是dispatcher servlet)去哪裏找這些Controller。。。

作為驗證,你可以在Controller裏邊加一個斷點,然後刷新頁面,程序根本就沒有執行到Controller裏邊

技術分享圖片

所以現在輪到修改另外一個配置文件了,dispatcher-servlet.xml

配置 component-scan(dispatcher-servlet.xml)

component-scan就是告訴Servlet去哪裏找到相應的Controller

打開 dispatcher-servlet.xml

在已經存在的<beans></beans>中間加上

<context:component-scan base-package="wormday.springmvc.helloworld"/>

base-package指定的就是存放Controller的包

做完這一步之後,重新啟動項目,再次訪問 http://localhost:8080/hi/say

這次應該還是404錯誤,不過比剛才的404錯誤前進了一大步

畢竟這次Controller已經執行了,如果剛才的斷點沒有去掉,你可以驗證一下看看

這一回是因為是“/WEB-INF/jsp/say.jsp”這個View找不到(我們剛才確實只是告訴他這個位置,但是從來沒有創建過這個文件)

再強調一次,Spring Mvc如果找不到Controller或者View都會報404錯誤,具體找不到的是誰,要具體分析了,好在一般都能簡單的分辨出來。

技術分享圖片

這個地方有個問題要額外說明一下,一般來說Controller代碼的返回值是成字符串“say”就可以了,不需要.jsp,也不需要前邊的路徑,比如

技術分享圖片

但是如果現在這樣寫,會報一個很奇怪的500錯誤,而不是404
技術分享圖片

HTTP Status 500 - Circular view path [say]: would dispatch back to the current handler URL [/hi/say] again. Check your ViewResolver setup! (Hint: This may be the result of an unspecified view, due to default view name generation.)

原因是:

  1. 我們還沒有配置ViewResolver,Spring會默認幫我們生成一個,自動生成的並沒有配置View默認的前綴和後綴(針對本項目本別是"/WEB-INF/jsp/"和".jsp"),所以暫時只能寫絕對路徑,本文後邊也會講到如何配置
  2. 如果不是"/"開頭的路徑(也就是相對路徑了),Spring會把當前路徑給配上去,當前Controller路徑是"/hi/"配上View的路徑"say",變成了"/hi/say",Controller執行結果發給View,這個View恰恰又是Controller本身,Spring發現這是個死循環,就不再執行直接報上面的錯誤了
  3. 這個錯誤我再Controller單元測試的時候也遇到過,原理知道了就知道如何解決了

但是目前必須制定View的絕對路徑,因為我們還沒有配置 配置 ViewResolver,後邊會專門說到這個問題

添加視圖文件(.jsp)

這個沒啥好解釋的,剛才你讓Spring去哪裏找這個View,就把這個View創建在哪裏

如果找不到,他就簡單粗暴的報404錯誤,根據前邊我寫的代碼,創建位置應該入下圖。

技術分享圖片

其實Spring並不限制你必須創建在WEB-INF下,但是這樣更安全,因為WEB-INF目錄用戶是不能直接訪問的,畢竟View裏邊可能會有一些代碼

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>hello world</body>
</html>

再次訪問 http://localhost:8080/hi/say

終於不再報錯了,看起來Controller也把相應的視圖找到了

技術分享圖片

配置 ViewResolver(dispatcher-servlet.xml)

還記得剛才Controller返回值必須是View的絕對路徑這個事情麽?一般情況下,我們是不會這樣寫的

網上的教程大部分也僅僅返回View的名字,比如

技術分享圖片

原因是一般都會在dispatcher-servlet.xml上指定如下的代碼。

    <!--指定視圖解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!-- 視圖的路徑 -->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!-- 視圖名稱後綴  -->
        <property name="suffix" value=".jsp"/>
    </bean>

class 指定ViewResolver的實現的類,你可以根據不同的情況,使用不用的ViewResolver,這裏指定的是 org.springframework.web.servlet.view.InternalResourceViewResolver

剛才我沒有指定,默認的也是這個類

後邊的前綴和後綴比較簡單,看看就明白了

記得改完xml之後,同步修改Controller的返回值。。不然又要404了

通過 Model 向 View 傳值

通過上面的操作,已經完成了MVC中的(V和C),M還沒見影子,讓我們繼續修改

打開剛才定義的Controller 也就是 HiController.java文件

修改如下(修改點我已經高亮了)

package wormday.springmvc.helloworld;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model; // 這裏導入了一個Model類
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/hi")
public class HiController {

    @RequestMapping("/say")
    public String say(Model model) { // 參數中傳入Model
        model.addAttribute("name","wormday"); // 指定Model的值
        model.addAttribute("url","http://www.cnblogs.com/wormday/p/8435617.html"); // 指定Model的值
        return "say";
    }
}

然後再打開View,也就是say.jsp文件,修改如下

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
hello world,${name}
<br/>${url}</body>
</html>

兩個之間的關系就不解釋了,然後重新運行項目,刷新頁面

技術分享圖片

一個最簡單的MVC項目完成了!!!

IDEA建立Spring MVC Hello World 詳細入門教程