關於Spring MVC的教程和例子?

最近在學Spring MVC,感覺網上搜出來的都是很老的資料,感覺現在主流應該是基於Annotation來用。看了一些官方的文檔和文章,英文不好略吃力。希望找一些新的比較體系化的教程,還有完整的案例。能否推薦一下。


最近剛剛做了一個Spring MVC實戰入門訓練,以一個博客系統為例,將Spring MVC的核心知識融入到實戰當中,完全脫水的乾貨:

Spring MVC實戰入門訓練

第1課 創建Spring Boot項目

第2課 URL路由:@Controller和@RequestMapping

第3課 @PathVariable

第4課 @RequestParam

第5課 模板渲染

第6課 分頁處理

第7課 表單提交

第8課 表單驗證

第9課 Flash Attribute

第10課 攔截器Interceptor

第11課 處理PUT和DELETE請求

第12課 文件上傳

第13課 異常處理

第14課 @ResponseBody與@RequestBody

十分鐘快速入門可以戳這裡:Spring MVC快速入門

環境準備

  • 一個稱手的文本編輯器(例如Vim、Emacs、Sublime Text)或者IDE(Eclipse、Idea Intellij)
  • Java環境(JDK 1.7或以上版本)
  • Maven 3.0+(Eclipse和Idea IntelliJ內置,如果使用IDE並且不使用命令行工具可以不安裝)

一個最簡單的Web應用

使用Spring Boot框架可以大大加速Web應用的開發過程,首先在Maven項目依賴中引入spring-boot-starter-web:

pom.xml

&
&
&4.0.0&

&com.tianmaying&
&spring-web-demo&
&0.0.1-SNAPSHOT&
&

jar&

&spring-web-demo&
&Demo project for Spring WebMvc&

&


&org.springframework.boot&
&spring-boot-starter-parent&
&1.2.5.RELEASE&
&
&

&


&

UTF-8& &1.8&
&

&
&
&org.springframework.boot&
&spring-boot-starter-web&
&

&

&
&


&


&org.springframework.boot&
&spring-boot-maven-plugin&
& & &

&

接下來創建src/main/java/Application.java:

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class Application {

@RequestMapping("/")
public String greeting() {
return "Hello World!";
}

public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}

運行應用:mvn spring-boot:run或在IDE中運行main()方法,在瀏覽器中訪問http://localhost:8080,Hello World!就出現在了頁面中。只用了區區十幾行Java代碼,一個Hello World應用就可以正確運行了,那麼這段代碼究竟做了什麼呢?我們從程序的入口SpringApplication.run(Application.class, args);開始分析:

  1. SpringApplication是Spring Boot框架中描述Spring應用的類,它的run()方法會創建一個Spring應用上下文(Application Context)。另一方面它會掃描當前應用類路徑上的依賴,例如本例中發現spring-webmvc(由 spring-boot-starter-web傳遞引入)在類路徑中,那麼Spring Boot會判斷這是一個Web應用,並啟動一個內嵌的Servlet容器(默認是Tomcat)用於處理HTTP請求。

  2. Spring WebMvc框架會將Servlet容器里收到的HTTP請求根據路徑分發給對應的@Controller類進行處理,@RestController是一類特殊的@Controller,它的返回值直接作為HTTP Response的Body部分返回給瀏覽器。

  3. @RequestMapping註解表明該方法處理那些URL對應的HTTP請求,也就是我們常說的URL路由(routing),請求的分發工作是有Spring完成的。例如上面的代碼中http://localhost:8080/根路徑就被路由至greeting()方法進行處理。如果訪問http://localhost:8080/hello,則會出現404 Not Found錯誤,因為我們並沒有編寫任何方法來處理/hello請求。

使用@Controller實現URL路由

現代Web應用往往包括很多頁面,不同的頁面也對應著不同的URL。對於不同的URL,通常需要不同的方法進行處理並返回不同的內容。

匹配多個URL

@RestController
public class Application {

@RequestMapping("/")
public String index() {
return "Index Page";
}

@RequestMapping("/hello")
public String hello() {
return "Hello World!";
}
}

@RequestMapping可以註解@Controller類:

@RestController
@RequestMapping("/classPath")
public class Application {
@RequestMapping("/methodPath")
public String method() {
return "mapping url is /classPath/methodPath";
}
}

method方法匹配的URL是/classPath/methodPath"。

提示

可以定義多個@Controller將不同URL的處理方法分散在不同的類中。

URL中的變數——PathVariable

在Web應用中URL通常不是一成不變的,例如微博兩個不同用戶的個人主頁對應兩個不同的URL。我們不可能對於每一個用戶都編寫一個被@RequestMapping註解的方法來處理其請求,Spring MVC提供了一套機制來處理這種情況:

@RequestMapping("/users/{username}")
public String userProfile(@PathVariable("username") String username) {
return String.format("user %s", username);
}

@RequestMapping("/posts/{id}")
public String post(@PathVariable("id") int id) {
return String.format("post %d", id);
}

在上述例子中,URL中的變數可以用{variableName}來表示,同時在方法的參數中加上@PathVariable("variableName"),那麼當請求被轉發給該方法處理時,對應的URL中的變數會被自動賦值給被@PathVariable註解的參數(能夠自動根據參數類型賦值,例如上例中的int)。

支持HTTP方法

對於HTTP請求除了其URL,還需要注意它的方法(Method)。例如我們在瀏覽器中訪問一個頁面通常是GET方法,而表單的提交一般是POST方法。@Controller中的方法同樣需要對其進行區分:

@RequestMapping(value = "/login", method = RequestMethod.GET)
public String loginGet() {
return "Login Page";
}

@RequestMapping(value = "/login", method = RequestMethod.POST)
public String loginPost() {
return "Login Post Request";
}

Spring MVC最新的版本中提供了一種更加簡潔的配置HTTP方法的方式,增加了四個標註:

  • @PutMapping
  • @GetMapping
  • @PostMapping
  • @DeleteMapping

在Web應用中常用的HTTP方法有四種:

  • PUT方法用來添加的資源
  • GET方法用來獲取已有的資源
  • POST方法用來對資源進行狀態轉換
  • DELETE方法用來刪除已有的資源

這四個方法可以對應到CRUD操作(Create、Read、Update和Delete),比如博客的創建操作,按照REST風格設計URL就應該使用PUT方法,讀取博客使用GET方法,更新博客使用POST方法,刪除博客使用DELETE方法。

每一個Web請求都是屬於其中一種,在Spring MVC中如果不特殊指定的話,默認是GET請求。

比如@RequestMapping("/")和@RequestMapping("/hello")和對應的Web請求是:

  • GET /
  • GET /hello

實際上@RequestMapping("/")是@RequestMapping("/", method = RequestMethod.GET)的簡寫,即可以通過method屬性,設置請求的HTTP方法。

比如PUT /hello請求,對應於@RequestMapping("/hello", method = RequestMethod.PUT)

基於新的標註@RequestMapping("/hello", method = RequestMethod.PUT)可以簡寫為@PutMapping("/hello")。@RequestMapping("/hello")與GetMapping("/hello")等價。

模板渲染

在之前所有的@RequestMapping註解的方法中,返回值字元串都被直接傳送到瀏覽器端並顯示給用戶。但是為了能夠呈現更加豐富、美觀的頁面,我們需要將HTML代碼返回給瀏覽器,瀏覽器再進行頁面的渲染、顯示。

一種很直觀的方法是在處理請求的方法中,直接返回HTML代碼,但是這樣做的問題在於——一個複雜的頁面HTML代碼往往也非常複雜,並且嵌入在Java代碼中十分不利於維護。更好的做法是將頁面的HTML代碼寫在模板文件中,渲染後再返回給用戶。為了能夠進行模板渲染,需要將@RestController改成@Controller:

import org.springframework.ui.Model;

@Controller
public class HelloController {

@RequestMapping("/hello/{name}")
public String hello(@PathVariable("name") String name, Model model) {
model.addAttribute("name", name);
return "hello"
}
}

在上述例子中,返回值"hello"並非直接將字元串返回給瀏覽器,而是尋找名字為hello的模板進行渲染,我們使用Thymeleaf模板引擎進行模板渲染,需要引入依賴:

&
&org.springframework.boot&
&spring-boot-starter-thymeleaf&
&

接下來需要在默認的模板文件夾src/main/resources/templates/目錄下添加一個模板文件hello.html:

&
&
&
&Getting Started: Serving Web Content&
&
&

&
&


&
&

th:text=""Hello, " + ${name} + "!""也就是將我們之前在@Controller方法里添加至Model的屬性name進行渲染,並放入&

標籤中(因為th:text是&

標籤的屬性)。模板渲染還有更多的用法,請參考Thymeleaf官方文檔。

處理靜態文件

瀏覽器頁面使用HTML作為描述語言,那麼必然也脫離不了CSS以及JavaScript。為了能夠瀏覽器能夠正確載入類似/css/style.css, /js/main.js等資源,默認情況下我們只需要在src/main/resources/static目錄下添加css/style.css和js/main.js文件後,Spring MVC能夠自動將他們發布,通過訪問/css/style.css, /js/main.js也就可以正確載入這些資源。


強烈推薦 專欄:Spring Boot 學習


開源項目是最好的學習資料

youzan/bugCatcher

之前是供公司開發人員自測使用的,今天開源了,技術棧:Spring+Spring MVC+Mybatis,並使用Spring Security做許可權控制,可以離線使用或者學習,當然了,歡迎貢獻代碼


官方文檔永遠是最好的教程,其實不需要特別多的英文能力,先看官方的guide,結合裡面的知識點去看官方文檔,效果會好很多。再遇到不懂的問題,就只能去Google啦。這裡貼一個官方guide的鏈接,可以先嘗試一下:

Getting Started ?? Building an Application with Spring Boot


我最近在看 java web輕量級開發面試教程,發現裡面的Spring MVC案例雖然簡單,但很能上手。

其中除了講開發技巧外,還講了Spring MVC 等的面試技巧,感覺有些幫助。


兩個很簡單的例子:https://github.com/hot13399/spring-mvc-mini

https://github.com/hot13399/spring-mvc-REST

先把代碼下載下來,跑起來。再慢慢看吧。


推薦閱讀:

TAG:Spring | SpringMVC框架 | SpringBoot |