MVC 設計概述
在早期 Java Web 的開發中,統一把顯示層、控制層、數據層的操作全部交給 JSP 或者 JavaBean 來進行處理,我們稱之為 Model1:
- 出現的弊端:
- JSP 和 Java Bean 之間嚴重耦合,Java 代碼和 HTML 代碼也耦合在了一起
- 要求開發者不僅要掌握 Java ,還要有高超的前端水平
- 前端和后端相互依賴,前端需要等待后端完成,后端也依賴前端完成,才能進行有效的測試
- 代碼難以復用
正因為上面的種種弊端,所以很快這種方式就被 Servlet + JSP + Java Bean 所替代了,早期的 MVC 模型(Model2)就像下圖這樣:
首先用戶的請求會到達 Servlet,然后根據請求調用相應的 Java Bean,并把所有的顯示結果交給 JSP 去完成,這樣的模式我們就稱為 MVC 模式。
-
M 代表 模型(Model)
模型是什么呢? 模型就是數據,就是 dao,bean -
V 代表 視圖(View)
視圖是什么呢? 就是網頁, JSP,用來展示模型中的數據 -
C 代表 控制器(controller)
控制器是什么? 控制器的作用就是把不同的數據(Model),顯示在不同的視圖(View)上,Servlet 扮演的就是這樣的角色。
擴展閱讀:Web開發模式
Spring MVC 的架構
為解決持久層中一直未處理好的數據庫事務的編程,又為了迎合 NoSQL 的強勢崛起,Spring MVC 給出了方案:
傳統的模型層被拆分為了業務層(Service)和數據訪問層(DAO,Data Access Object)。 在 Service 下可以通過 Spring 的聲明式事務操作數據訪問層,而在業務層上還允許我們訪問 NoSQL ,這樣就能夠滿足異軍突起的 NoSQL 的使用了,它可以大大提高互聯網系統的性能。
-
特點:
結構松散,幾乎可以在 Spring MVC 中使用各類視圖
松耦合,各個模塊分離
與 Spring 無縫集成
Hello Spring MVC
讓我們來寫一下我們的第一個 Spring MVC 程序:
第一步:在 IDEA 中新建 Spring MVC 項目
并且取名為 【HelloSpringMVC】,點擊【Finish】:
IDEA 會自動幫我們下載好必要的 jar 包,并且為我們創建好一些默認的目錄和文件,創建好以后項目結構如下:
第二步:修改 web.xml
我們打開 web.xml ,按照下圖完成修改:
把<url-pattern>
元素的值改為 / ,表示要攔截所有的請求,并交由Spring MVC的后臺控制器來處理,改完之后:
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
第三步:編輯 dispatcher-servlet.xml
這個文件名的開頭 dispatcher 與上面 web.xml 中的 <servlet-name>
元素配置的 dispatcher 對應,這是 Spring MVC 的映射配置文件(xxx-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"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="simpleUrlHandlerMapping"
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<!-- /hello 路徑的請求交給 id 為 helloController 的控制器處理-->
<prop key="/hello">helloController</prop>
</props>
</property>
</bean>
<bean id="helloController" class="controller.HelloController"></bean>
</beans>
第四步:編寫 HelloController
在 Package【controller】下創建 【HelloController】類,并實現 org.springframework.web.servlet.mvc.Controller 接口:
package controller;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
public class HelloController implements Controller{
@Override
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
return null;
}
}
- 出現了問題: javax.servlet 包找不到
- 解決: 將本地 Tomcat 服務器的目錄下【lib】文件夾下的 servlet-api.jar 包拷貝到工程【lib】文件夾下,添加依賴
Spring MVC 通過 ModelAndView 對象把模型和視圖結合在一起
ModelAndView mav = new ModelAndView("index.jsp");
mav.addObject("message", "Hello Spring MVC");
這里表示視圖的是index.jsp
模型數據的是 message,內容是 “Hello Spring MVC”
package controller;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
public class HelloController implements Controller {
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
ModelAndView mav = new ModelAndView("index.jsp");
mav.addObject("message", "Hello Spring MVC");
return mav;
}
}
第五步:準備 index.jsp
將 index.jsp 的內容修改為:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" isELIgnored="false"%>
<h1>${message}</h1>
內容很簡單,用El表達式顯示 message 的內容。
第六步:部署 Tomcat 及相關環境
在【Run】菜單項下找到【Edit Configurations】
配置 Tomcat 環境:
選擇好本地的 Tomcat 服務器,并改好名字:
在 Deployment 標簽頁下完成如下操作:
點擊 OK 就好了,我們點擊右上角的三角形將 Tomcat 服務器運行起來。
- 出現的問題: Tomcat 服務器無法正常啟動
- 原因: Tomcat 服務器找不到相關的 jar 包
- 解決方法: 將【lib】文件夾整個剪貼到【WEB-INF】下,并重新建立依賴:
第七步:重啟服務器
重啟服務器,輸入地址:localhost/hello
跟蹤 Spring MVC 的請求
每當用戶在 Web 瀏覽器中點擊鏈接或者提交表單的時候,請求就開始工作了,像是郵遞員一樣,從離開瀏覽器開始到獲取響應返回,它會經歷很多站點,在每一個站點都會留下一些信息同時也會帶上其他信息,下圖為 Spring MVC 的請求流程:
第一站:DispatcherServlet
從請求離開瀏覽器以后,第一站到達的就是 DispatcherServlet,看名字這是一個 Servlet,通過 J2EE 的學習,我們知道 Servlet 可以攔截并處理 HTTP 請求,DispatcherServlet 會攔截所有的請求,并且將這些請求發送給 Spring MVC 控制器。
<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>/</url-pattern>
</servlet-mapping>
- DispatcherServlet 的任務就是攔截請求發送給 Spring MVC 控制器。
第二站:處理器映射(HandlerMapping)
- 問題: 典型的應用程序中可能會有多個控制器,這些請求到底應該發給哪一個控制器呢?
所以 DispatcherServlet 會查詢一個或多個處理器映射來確定請求的下一站在哪里,處理器映射會根據請求所攜帶的 URL 信息來進行決策,例如上面的例子中,我們通過配置 simpleUrlHandlerMapping 來將 /hello 地址交給 helloController 處理:
<bean id="simpleUrlHandlerMapping"
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<!-- /hello 路徑的請求交給 id 為 helloController 的控制器處理-->
<prop key="/hello">helloController</prop>
</props>
</property>
</bean>
<bean id="helloController" class="controller.HelloController"></bean>
第三站:控制器
一旦選擇了合適的控制器, DispatcherServlet 會將請求發送給選中的控制器,到了控制器,請求會卸下其負載(用戶提交的請求)等待控制器處理完這些信息:
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
// 處理邏輯
....
}
第四站:返回 DispatcherServlet
當控制器在完成邏輯處理后,通常會產生一些信息,這些信息就是需要返回給用戶并在瀏覽器上顯示的信息,它們被稱為模型(Model)。僅僅返回原始的信息時不夠的——這些信息需要以用戶友好的方式進行格式化,一般會是 HTML,所以,信息需要發送給一個視圖(view),通常會是 JSP。
控制器所做的最后一件事就是將模型數據打包,并且表示出用于渲染輸出的視圖名(邏輯視圖名)。它接下來會將請求連同模型和視圖名發送回 DispatcherServlet。
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
// 處理邏輯
....
// 返回給 DispatcherServlet
return mav;
}
第五站:視圖解析器
這樣以來,控制器就不會和特定的視圖相耦合,傳遞給 DispatcherServlet 的視圖名并不直接表示某個特定的 JSP。(實際上,它甚至不能確定視圖就是 JSP)相反,它傳遞的僅僅是一個邏輯名稱,這個名稱將會用來查找產生結果的真正視圖。
DispatcherServlet 將會使用視圖解析器(view resolver)來將邏輯視圖名匹配為一個特定的視圖實現,它可能是也可能不是 JSP
上面的例子是直接綁定到了 index.jsp 視圖
第六站:視圖
既然 DispatcherServlet 已經知道由哪個視圖渲染結果了,那請求的任務基本上也就完成了。
它的最后一站是視圖的實現,在這里它交付模型數據,請求的任務也就完成了。視圖使用模型數據渲染出結果,這個輸出結果會通過響應對象傳遞給客戶端。
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" isELIgnored="false"%>
<h1>${message}</h1>
使用注解配置 Spring MVC
上面我們已經對 Spring MVC 有了一定的了解,并且通過 XML 配置的方式創建了第一個 Spring MVC 程序,我們來看看基于注解應該怎么完成上述程序的配置:
第一步:為 HelloController 添加注解
package controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class HelloController{
@RequestMapping("/hello")
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
ModelAndView mav = new ModelAndView("index.jsp");
mav.addObject("message", "Hello Spring MVC");
return mav;
}
}
把實現的接口也給去掉。
- 簡單解釋一下:
-
@Controller
注解:
很明顯,這個注解是用來聲明控制器的,但實際上這個注解對 Spring MVC 本身的影響并不大。(Spring 實戰說它僅僅是輔助實現組件掃描,可以用@Component
注解代替,但我自己嘗試了一下并不行,因為上述例子沒有配置 JSP 視圖解析器我還自己配了一個仍沒有成功...) -
@RequestMapping
注解:
很顯然,這就表示路徑/hello
會映射到該方法上
第二步:取消之前的 XML 注釋
在 dispatcher-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:context="http://www.springframework.org/schema/context"
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.xsd">
<!--<bean id="simpleUrlHandlerMapping"-->
<!--class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">-->
<!--<property name="mappings">-->
<!--<props>-->
<!--<!– /hello 路徑的請求交給 id 為 helloController 的控制器處理–>-->
<!--<prop key="/hello">helloController</prop>-->
<!--</props>-->
<!--</property>-->
<!--</bean>-->
<!--<bean id="helloController" class="controller.HelloController"></bean>-->
<!-- 掃描controller下的組件 -->
<context:component-scan base-package="controller"/>
</beans>
第三步:重啟服務器
當配置完成,重新啟動服務器,輸入 localhost/hello
地址仍然能看到效果:
@RequestMapping 注解細節
如果 @RequestMapping
作用在類上,那么就相當于是給該類所有配置的映射地址前加上了一個地址,例如:
@Controller
@RequestMapping("/wmyskxz")
public class HelloController {
@RequestMapping("/hello")
public ModelAndView handleRequest(....) throws Exception {
....
}
}
- 則訪問地址:
localhost/wmyskxz/hello
配置視圖解析器
還記得我們 Spring MVC 的請求流程嗎,視圖解析器負責定位視圖,它接受一個由 DispaterServlet 傳遞過來的邏輯視圖名來匹配一個特定的視圖。
- 需求: 有一些頁面我們不希望用戶用戶直接訪問到,例如有重要數據的頁面,例如有模型數據支撐的頁面。
-
造成的問題:
我們可以在【web】根目錄下放置一個【test.jsp】模擬一個重要數據的頁面,我們什么都不用做,重新啟動服務器,網頁中輸入localhost/test.jsp
就能夠直接訪問到了,這會造成數據泄露...
另外我們可以直接輸入localhost/index.jsp
試試,根據我們上面的程序,這會是一個空白的頁面,因為并沒有獲取到${message}
參數就直接訪問了,這會影響用戶體驗
解決方案
我們將我們的 JSP 文件配置在【WEB-INF】文件夾中的【page】文件夾下,【WEB-INF】是 Java Web 中默認的安全目錄,是不允許用戶直接訪問的(也就是你說你通過 localhost/WEB-INF/
這樣的方式是永遠訪問不到的)
但是我們需要將這告訴給視圖解析器,我們在 dispatcher-servlet.xml 文件中做如下配置:
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/page/" />
<property name="suffix" value=".jsp" />
</bean>
這里配置了一個 Spring MVC 內置的一個視圖解析器,該解析器是遵循著一種約定:會在視圖名上添加前綴和后綴,進而確定一個 Web 應用中視圖資源的物理路徑的。讓我們實際來看看效果:
第一步:修改 HelloController
我們將代碼修改一下:
第二步:配置視圖解析器:
按照上述的配置,完成:
<?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"
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.xsd">
<!--<bean id="simpleUrlHandlerMapping"-->
<!--class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">-->
<!--<property name="mappings">-->
<!--<props>-->
<!--<!– /hello 路徑的請求交給 id 為 helloController 的控制器處理–>-->
<!--<prop key="/hello">helloController</prop>-->
<!--</props>-->
<!--</property>-->
<!--</bean>-->
<!--<bean id="helloController" class="controller.HelloController"></bean>-->
<!-- 掃描controller下的組件 -->
<context:component-scan base-package="controller"/>
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/page/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
第三步:剪貼 index.jsp 文件
在【WEB-INF】文件夾下新建一個【page】文件夾,并將【index.jsp】文件剪貼到里面:
第四步:更新資源重啟服務器
訪問 localhost/hello
路徑,看到正確效果:
- 原理:
我們傳入的邏輯視圖名為 index ,再加上 “/WEB-INF/page/
” 前綴和 “.jsp
” 后綴,就能確定物理視圖的路徑了,這樣我們以后就可以將所有的視圖放入【page】文件夾下了!
- 注意:此時的配置僅是 dispatcher-servlet.xml 下的
控制器接收請求數據
使用控制器接收參數往往是 Spring MVC 開發業務邏輯的第一步,為探索 Spring MVC 的傳參方式,為此我們先來創建一個簡單的表單用于提交數據:
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" import="java.util.*" isELIgnored="false"%>
<html>
<head>
<meta charset="utf-8">
<title>Spring MVC 傳參方式</title>
</head>
<body>
<form action="/param" role="form">
用戶名:<input type="text" name="userName"><br/>
密碼:<input type="text" name="password"><br/>
<input type="submit" value="提 交">
</form>
</body>
</html>
丑就丑點兒吧,我們就是來測試一下:
使用 Servlet 原生 API 實現:
我們很容易知道,表單會提交到 /param
這個目錄,我們先來使用 Servlet 原生的 API 來看看能不能獲取到數據:
@RequestMapping("/param")
public ModelAndView getParam(HttpServletRequest request,
HttpServletResponse response) {
String userName = request.getParameter("userName");
String password = request.getParameter("password");
System.out.println(userName);
System.out.println(password);
return null;
}
測試成功:
使用同名匹配規則
我們可以把方法定義的形參名字設置成和前臺傳入參數名一樣的方法,來獲取到數據(同名匹配規則):
@RequestMapping("/param")
public ModelAndView getParam(String userName,
String password) {
System.out.println(userName);
System.out.println(password);
return null;
}
測試成功:
- 問題: 這樣又會和前臺產生很強的耦合,這是我們不希望的
-
解決: 使用
@RequestParam("前臺參數名")
來注入:
-
@RequestParam
注解細節:
該注解有三個變量:value
、required
、defaultvalue
-
value
:指定name
屬性的名稱是什么,value
屬性都可以默認不寫 -
required
:是否必須要有該參數,可以設置為【true】或者【false】 -
defaultvalue
:設置默認值
使用模型傳參
- 要求: 前臺參數名字必須和模型中的字段名一樣
讓我們先來為我們的表單創建一個 User 模型:
package pojo;
public class User {
String userName;
String password;
/* getter and setter */
}
然后測試仍然成功:
中文亂碼問題
- 注意: 跟 Servlet 中的一樣,該方法只對 POST 方法有效(因為是直接處理的 request)
我們可以通過配置 Spring MVC 字符編碼過濾器來完成,在 web.xml 中添加:
<filter>
<filter-name>CharacterEncodingFilter</filter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<!-- 設置編碼格式 -->
<param-value>utf-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
控制器回顯數據
通過上面,我們知道了怎么接受請求數據,并能解決 POST 亂碼的問題,那么我們怎么回顯數據呢?為此我們在【page】下創建一個【test2.jsp】:
<!DOCTYPE html>
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8" import="java.util.*" isELIgnored="false" %>
<html>
<head>
<title>Spring MVC 數據回顯</title>
</head>
<body>
<h1>回顯數據:${message}</h1>
</body>
</html>
使用 Servlet 原生 API 來實現
我們先來測試一下 Servlet 原生的 API 是否能完成這個任務:
@RequestMapping("/value")
public ModelAndView handleRequest(HttpServletRequest request,
HttpServletResponse response) {
request.setAttribute("message","成功!");
return new ModelAndView("test1");
}
在瀏覽器地址欄中輸入:localhost/value
測試
使用 Spring MVC 所提供的 ModelAndView 對象
使用 Model 對象
在 Spring MVC 中,我們通常都是使用這樣的方式來綁定數據,
- 使用
@ModelAttribute
注解:
@ModelAttribute
public void model(Model model) {
model.addAttribute("message", "注解成功");
}
@RequestMapping("/value")
public String handleRequest() {
return "test1";
}
這樣寫就會在訪問控制器方法 handleRequest() 時,會首先調用 model() 方法將 message
添加進頁面參數中去,在視圖中可以直接調用,但是這樣寫會導致該控制器所有的方法都會首先調用 model() 方法,但同樣的也很方便,因為可以加入各種各樣的數據。
客戶端跳轉
前面不管是地址 /hello
跳轉到 index.jsp 還是 /test
跳轉到 test.jsp,這些都是服務端的跳轉,也就是 request.getRequestDispatcher("地址").forward(request, response);
那我們如何進行客戶端跳轉呢?我們繼續在 HelloController 中編寫:
@RequestMapping("/hello")
public ModelAndView handleRequest(javax.servlet.http.HttpServletRequest httpServletRequest, javax.servlet.http.HttpServletResponse httpServletResponse) throws Exception {
ModelAndView mav = new ModelAndView("index");
mav.addObject("message", "Hello Spring MVC");
return mav;
}
@RequestMapping("/jump")
public ModelAndView jump() {
ModelAndView mav = new ModelAndView("redirect:/hello");
return mav;
}
我們使用 redirect:/hello
就表示我們要跳轉到 /hello
這個路徑,我們重啟服務器,在地址欄中輸入:localhost/jump
,會自動跳轉到 /hello
路徑下:
也可以這樣用:
@RequestMapping("/jump")
public String jump() {
return "redirect: ./hello";
}
文件上傳
我們先來回顧一下傳統的文件上傳和下載:這里
我們再來看一下在 Spring MVC 中如何實現文件的上傳和下載
-
注意: 需要先導入
commons-io-1.3.2.jar
和commons-fileupload-1.2.1.jar
兩個包
第一步:配置上傳解析器
在 dispatcher-servlet.xml 中新增一句:
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/>
開啟對上傳功能的支持
第二步:編寫 JSP
文件名為 upload.jsp,仍創建在【page】下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>測試文件上傳</title>
</head>
<body>
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="picture">
<input type="submit" value="上 傳">
</form>
</body>
</html>
第三步:編寫控制器
在 Package【controller】下新建【UploadController】類:
package controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class UploadController {
@RequestMapping("/upload")
public void upload(@RequestParam("picture") MultipartFile picture) throws Exception {
System.out.println(picture.getOriginalFilename());
}
@RequestMapping("/test2")
public ModelAndView upload() {
return new ModelAndView("upload");
}
}
第四步:測試
在瀏覽器地址欄中輸入:localhost/test2
,選擇文件點擊上傳,測試成功:
參考資料:
- 《Java EE 互聯網輕量級框架整合開發》
- 《Spring 實戰》
- How2j Spring MVC 系列教程
- 全能的百度和萬能的大腦
歡迎轉載,轉載請注明出處!
簡書ID:@我沒有三顆心臟
github:wmyskxz
歡迎關注公眾微信號:wmyskxz
分享自己的學習 & 學習資料 & 生活
想要交流的朋友也可以加qq群:3382693