學習SpringMVC——從HelloWorld開始

時間 2019-12-09

標籤學習 springmvc helloworld 開始欄目 Spring 简体版

原文原文鏈接

前言：

　　時隔十二年，中國女排最終過關斬將，用3:1的成績證實了本身的實力，霸氣奪冠，爲中國贏得了一枚意義很是的金牌。這是一次全民的狂歡，一場視聽盛宴，帶給咱們不只是熠熠生輝的金牌，更傳遞出的是一種女排精神。css

　　往往得分的時候，總能看到球員們歇斯底里的咆哮和歡呼，由於每一分都來的太不容易。html

　　其實碼農也是如此，往往解決掉一個bug的時候，心裏的舒暢和激動，好似經歷了沒有盡頭的爬坡，幾度已經快精疲力盡或是達到了精神崩潰的邊緣以後，陡然迎來了下坡，這種感受比如賽場上女將們得分後已經沒法用言語來表達心情，而只能靠咆哮來傳遞心裏的喜悅。java

　　話很少說，從今天起，準備好好審視並學習Spring mvc。web

　　雖然從學java的第一個程序——helloworld至今，已經有好幾個年頭了。當時本身找資料，看視頻，學習了java的輸入輸出流，多線程，網絡編程等等，而三大框架（Struts、Hibernate、Spring）基本只是開了個頭就出來實習了，尤爲對於Spring更是沒有進行系統的學習，雖然在實習的時候經過看項目，基本明白了spring mvc編程的框架是怎麼回事，遇到需求知道如何寫代碼，在哪寫代碼，可是仍是缺少一個系統的認識。對於涉及到一些spring的文件配置或工做原理的問題時，就顯得有些侷促。因此，最近準備好好來學習下現現在在企業級開發中大行其道的Spring MVC。spring

什麼是Spring MVC

　　Spring MVC屬於SpringFrameWork的後續產品，已經融合在Spring Web Flow裏面。Spring 框架提供了構建 Web 應用程序的全功能 MVC 模塊。使用 Spring 可插入的 MVC 架構，從而在使用Spring進行WEB開發時，能夠選擇使用Spring的SpringMVC框架或集成其餘MVC開發框架，如Struts1，Struts2等。express

　　今天先從寫一個Spring MVC的HelloWorld開始，讓咱們看看如何搭建起一個Spring mvc的環境並運行程序。編程

軟件參數

　　Eclipse：Mars.1 Release (4.5.1)windows

　　Tomcat： 8.0.36瀏覽器

　　JDK：1.8.0_60spring-mvc

　　Spring-framework： 4.0.4.RELEASE

新建項目

　　File-New-Other,選擇Dynamic web project

　　項目建好以後，目錄結構以下：

導入jar包

　　咱們基於Spring mvc框架進行開發，須要依賴一下的spring jar包：

spring-aop-4.0.4.RELEASE.jar
spring-beans-4.0.4.RELEASE.jar
spring-context-4.0.4.RELEASE.jar
spring-core-4.0.4.RELEASE.jar
spring-expression-4.0.4.RELEASE.jar
spring-web-4.0.4.RELEASE.jar
spring-webmvc-4.0.4.RELEASE.jar
commons-logging-1.1.1.jar（用來打印log）

　　在WEB-INF目錄下新建lib文件夾，並將上面的jar包放入其中。

　　jar包能夠點擊這裏下載。

配置文件及編寫代碼

web.xml（WEB-INF下）

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3     xmlns="http://java.sun.com/xml/ns/javaee"
 4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
 5     id="WebApp_ID" version="2.5">
 6     
 7     <!-- 配置DispatchcerServlet -->
 8     <servlet>
 9         <servlet-name>springDispatcherServlet</servlet-name>
10         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
11         <!-- 配置Spring mvc下的配置文件的位置和名稱 -->
12         <init-param>
13             <param-name>contextConfigLocation</param-name>
14             <param-value>classpath:springmvc.xml</param-value>
15         </init-param>
16         <load-on-startup>1</load-on-startup>
17     </servlet>
18     
19     <servlet-mapping>
20         <servlet-name>springDispatcherServlet</servlet-name>
21         <url-pattern>/</url-pattern>
22     </servlet-mapping>
23     
24 </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（scr下）

　　在src目錄下新建springmvc.xml

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4     xmlns:context="http://www.springframework.org/schema/context"
 5     xmlns:mvc="http://www.springframework.org/schema/mvc"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 7         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
 8         http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
 9         
10         
11         <!-- 配置自動掃描的包 -->
12         <context:component-scan base-package="com.jackie.springmvc"></context:component-scan>
13         
14         <!-- 配置視圖解析器 如何把handler 方法返回值解析爲實際的物理視圖 -->
15         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
16             <property name = "prefix" value="/WEB-INF/views/"></property>
17             <property name = "suffix" value = ".jsp"></property>
18         </bean>
19 </beans>

注意：1. line12表示spring監聽的範圍，這裏是在com.jackie.springmvc下

　　　2. line15-18,是添加了一個視圖解析器，用於把在控制器中handler的結構解析爲實際的物理視圖，這個要配合controller類來解析，詳見下面。

HelloWorld.java（com.jackie.springmvc.handlers下）

1 package com.jackie.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 
 6 @Controller
 7 public class HelloWorld {
 8 
 9     /**
10      * 1. 使用RequestMapping註解來映射請求的URL
11      * 2. 返回值會經過視圖解析器解析爲實際的物理視圖, 對於InternalResourceViewResolver視圖解析器，會作以下解析
12      * 經過prefix+returnVal+suffix 這樣的方式獲得實際的物理視圖，而後會轉發操做
13      * "/WEB-INF/views/success.jsp"
14      * @return
15      */
16     @RequestMapping("/helloworld")
17     public String hello(){
18         System.out.println("hello world");
19         return "success";
20     }
21 }

注意：1. 首先要在類的前面添加「Controller」註解，表示是spring的控制器，這裏會寫一個方法hello（）

　　　2. hello方法上方有一個@RequestMapping，是用於匹配請求的路徑，好比這裏匹配的請求路徑就是「http://localhost:8080/springTest/springmvc/helloworld」，即當tomcat服務啓動後，在瀏覽器輸入這個url時，若是在這個方法打斷點了，就會跳入該方法。

　　　3. 這個return的結果不是亂寫的，這個返回的字符串就是與上面springmvc.xml中line15-18進行配合的，springmvc.xml中聲明瞭prefix和suffix，而夾在這二者之間的就是這裏返回的字符串，因此執行完這個方法後，咱們能夠獲得這樣的請求資源路徑「/WEB-INF/views/success.jsp」，這個success.jsp是須要咱們新建的

index.jsp（WebContent下）

　　在新建success.jsp以前，咱們須要有一個入口，也就是這裏的index.jsp

1 <%@ page language="java" contentType="text/html; charset=UTF-8"
 2     pageEncoding="UTF-8"%>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 4 <html>
 5 <head>
 6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 7 <title>Insert title here</title>
 8 </head>
 9 <body>
10 
11 <a href="helloworld">hello world</a>
12 
13 </body>
14 </html>

　　當訪問index.jsp時，頁面上會展現一個超連接，點擊超鏈後，url中的地址就會發生跳轉，由「http://localhost:8080/springTest/index.jsp」跳轉到「http://localhost:8080/springTest/helloworld」，而這個url請求就會進入HelloWorld中的hello方法，由於其與該方法上的「/helloworld」匹配。

success.jsp（WEB-INF/views下）

　　該頁面是做爲請求成功後的相應頁面

1 <%@ page language="java" contentType="text/html; charset=ISO-8859-1"
 2     pageEncoding="ISO-8859-1"%>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 4 <html>
 5 <head>
 6 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 7 <title>Insert title here</title>
 8 </head>
 9 <body>
10 
11 <h4>Success Page</h4>
12 
13 </body>
14 </html>

至此，咱們完成了基於Spring mvc框架的HelloWorld程序的開發，包括要依賴的jar包，配置的文件，控制器代碼的編寫和展現頁面的編寫等。

除此之外，再介紹下整個配置過程當中遇到的一些小問題：

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服務器，你就能夠在index.jsp上右鍵run on server,選擇你的tomcat服務器，這樣就能夠啓動tomcat服務，幫助你完成網頁的請求和響應操做。

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

　　關於使用spring mvc處理靜態資源，好比html（發現以前的springmvc.xml中<property name = "suffix" value = ".jsp"></property>定義爲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中只有

1 <servlet-mapping>
2     <servlet-name>springDispatcherServlet</servlet-name>
3     <url-pattern>/</url-pattern>
4 </servlet-mapping>

　　其匹配的都是controller中相似@RequestMapping("/springmvc/helloworld")這樣的註解配置的請求，而對於相似html/css/jpg等資源的訪問就會得不到，因此須要在web.xml中加入如下類型的支持

1 <servlet-mapping>
 2      <servlet-name>default</servlet-name>
 3      <url-pattern>*.css</url-pattern>
 4 </servlet-mapping>
 5 
 6 <servlet-mapping>
 7       <servlet-name>default</servlet-name>
 8       <url-pattern>*.gif</url-pattern>
 9 </servlet-mapping>
10 
11 <servlet-mapping>
12     <servlet-name>default</servlet-name>
13      <url-pattern>*.jpg</url-pattern>
14 </servlet-mapping>
15 
16 <servlet-mapping>
17      <servlet-name>default</servlet-name>
18      <url-pattern>*.js</url-pattern>
19 </servlet-mapping>
20 
21 <servlet-mapping>
22       <servlet-name>default</servlet-name>
23       <url-pattern>*.html</url-pattern>
24 </servlet-mapping>

　　這樣就能夠保證spring 可以攔截並處理靜態資源

　　這裏將HelloWorld.java中的hello方法改成：

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

　　Springmvc.xml改成：

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

　　表示咱們能夠訪問jpg靜態圖片資源了

看到圖片若有不適，請經過點贊來緩解症狀~~~