1. 程式人生 > >Spring學習筆記 使用SpringMVC搭建第一個專案

Spring學習筆記 使用SpringMVC搭建第一個專案

  近來公司沒什麼新的專案,於是打算抽時間看看java著名的三大框架Struts、Hibernate、Spring;之前看了Struts,從今天起,準備好好審視並學習Spring mvc,學習Spring mvc的第一步,當然是環境的搭建以及一個可以執行的最簡單的helloworld專案了。

  • 什麼是Spring MVC

      Spring MVC屬於SpringFrameWork的後續產品,已經融合在Spring Web Flow裡面。Spring 框架提供了構建 Web 應用程式的全功能 MVC 模組。使用 Spring 可插入的 MVC 架構,從而在使用Spring進行WEB開發時,可以選擇使用Spring的SpringMVC框架或整合其他MVC開發框架,如Struts1,Struts2等。

  • 環境配置

      Eclipse:Mars Release (4.5.0)
      Apache-Tomcat:8.0.38
      JDK:1.8
      Spring-framework: 4.2.6.RELEASE
      

  • 搭建專案

1.新建專案:File-New,選擇Dynamic web project,並取專案名稱為MySpringMvc

結構圖

2.新增配置檔案:在WEB-INF資料夾下面新增web.xml和springmvc.xml檔案:

web.xml檔案:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi
="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5">
<!-- 配置DispatchcerServlet --> <servlet> <servlet-name
>
springDispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <!-- 配置Spring mvc下的配置檔案的位置和名稱 --> <init-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/springmvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springDispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>

 注意:1. line12-15用於配置spring mvc的配置檔案的位置和名稱,這裡說明會新建一個springmvc.xml的配置檔案

   2. 我們也可以不新建springmvc.xml,而是用預設的,預設的配置檔案格式為/WEB-INF/[servlet-name]-servlet.xml,對應這裡的就是springDispatcherServlet-servlet.xml

   3. 這裡的servlet-mapping表示攔截的模式,這裡是“/”,表示對於所有的請求的攔截,包括靜態資源如html, js, jpg等。這時候對於靜態資源的訪問就會報404的錯誤。關於如何解決後面會介紹
springmvc.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:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">


        <!-- 配置自動掃描的包 -->
        <context:component-scan base-package="com.shi.springmvc"></context:component-scan>

        <!-- 配置檢視解析器 如何把handler 方法返回值解析為實際的物理檢視 -->
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name = "prefix" value="/WEB-INF/views/"></property>
            <property name = "suffix" value = ".jsp"></property>
        </bean>
</beans>

注意:1. line12表示spring監聽的範圍,這裡是在com.shi.springmvc下

   2. line15-18,是添加了一個檢視解析器,用於把在控制器中handler的結構解析為實際的物理檢視,這個要配合controller類來解析。
   
3.新增Spring-framework框架相關jar包:

主要用到的jar

4.在WebContent資料夾下面新增index.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>介面標題</title>
</head>
<body>

<a href="helloworld">hello world</a>

</body>
</html>

4.在WEB-INF/views/下面新增success.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=ISO-8859-1">
<title>成功介面</title>
</head>
<body>

<h4>恭喜您成功了</h4>

</body>
</html>

5.建立helloworld類(包名com.shi.springmvc.handlers下):

package com.shi.springmvc.handlers;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorld {

    /**
     * 1. 使用RequestMapping註解來對映請求的URL 2. 返回值會通過檢視解析器解析為實際的物理檢視,
     * 對於InternalResourceViewResolver檢視解析器,會做如下解析 通過prefix+returnVal+suffix
     * 這樣的方式得到實際的物理檢視,然後會轉發操作 "/WEB-INF/views/success.jsp"
     * 
     * @return
     */
    @RequestMapping("/helloworld")
    public String hello() {
        System.out.println("hello world");
        return "success";
    }
}

注意:1. 首先要在類的前面新增“Controller”註解,表示是spring的控制器,這裡會寫一個方法hello()

   2. hello方法上方有一個@RequestMapping, 是用於匹配請求的路徑,比如這裡匹配的請求路徑就是“http://localhost:8080/MySpringMvc/helloworld”,即當tomcat服務啟動後,在瀏覽器輸入這個url時,如果在這個方法打斷點了,就會跳入該方法。

   3. 這個return的結果不是亂寫的,這個返回的字串就是與上面springmvc.xml中line15-18進行配合的,springmvc.xml中聲明瞭prefix和suffix,而夾在這兩者之間的就是這裡返回的字串,所以執行完這個方法後,我們可以得到這樣的請求資源路徑“/WEB-INF/views/success.jsp”,這個success.jsp是需要我們建立的。

-兩個值得注意的問題

  1. tomcat伺服器的新增

      從前面的介紹可以看出,我們的程式是通過瀏覽器發請求來獲取想要的頁面,那麼這裡就免不了要有一個web伺服器,這裡就是tomcat。

      首先你需要下載個tomcat,然後在eclipse->windows->preference->servers中繫結這個tomcat伺服器;

      其次你需要在你新建的spring mvc專案中新增tomcat的支援,否則在新建的jsp檔案中會提示報錯“The superclass javax.servlet.http.HttpServlet was not found on the Java Build Path”

      右鍵專案->build path->configure build path->add library->server runtime, 選擇你的tomcat即可
    新增tomcat

  2. spring mvc如何訪問靜態資源

關於使用spring mvc處理靜態資源,比如html(發現之前的springmvc.xml中定義為jsp結尾就可以成功跳轉,但是如果改為html並在web-inf下面新建了html檔案後,並將suffix這裡的”.jsp”改為”.html”,無法跳轉到想要的html頁面,並且給出404錯誤,同時console給出錯誤資訊為:No mapping found for HTTP request with URI [/springTest/WEB-INF/views/result.html] in DispatcherServ)

  最後發現是需要讓spring明確要處理靜態資源,原來的web.xml中只有

<servlet-mapping>
    <servlet-name>springDispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
 </servlet-mapping>

其匹配的都是controller中類似@RequestMapping(“/springmvc/helloworld”)這樣的註解配置的請求,而對於類似html/css/jpg等資源的訪問就會得不到,所以需要在web.xml中加入以下型別的支援

<servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>*.css</url-pattern>
</servlet-mapping>

<servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.gif</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>default</servlet-name>
     <url-pattern>*.png</url-pattern>
</servlet-mapping>

<servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>*.js</url-pattern>
</servlet-mapping>

<servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.html</url-pattern>
</servlet-mapping>

這樣就可以保證spring 能夠攔截並處理靜態資源了。
這裡將HelloWorld.java中的hello方法改為:

@RequestMapping("/helloworld")
    public String hello(){
        System.out.println("hello world");
        return "success";
}

Springmvc.xml改為:

class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name = "prefix" value="/WEB-INF/views/"></property>
            <property name = "suffix" value = ".png"></property>
</bean>

這樣我們就能夠訪問png靜態圖片資源了
開啟圖片

參考文章地址
最後附上整個demo的下載地址:戳我