一、MVC模式
1. MVC模型:一种软件架构模式
-
Model-View-Controller(模型-视图-控制器)模式,目标是将软件的用户界面(即前台页面)和业务逻辑分离,使代码具有更高的可扩展性、可复用性、可维护性以及灵活性。
-
MVC 模式将应用程序划分成模型(Model)、视图(View)、控制器(Controller)三层:
分层 | 描述 |
---|---|
Model(模型) | 它是应用程序的主体部分,主要由以下 2 部分组成:
一个模型可以为多个视图(View)提供数据,一套模型(Model)的代码只需写一次就可以被多个视图重用,有效地减少了代码的重复性,增加了代码的可复用性。 |
View(视图) | 指在应用程序中专门用来与浏览器进行交互,展示数据的资源。在 Web 应用中,View 就是我们常说的前台页面,通常由 HTML、JSP、CSS、JavaScript 等组成。 |
Controller(控制器) | 通常指的是,应用程序的 Servlet。它负责将用户的请求交给模型(Model)层进行处理,并将 Model 层处理完成的数据,返回给视图(View)渲染并展示给用户。 |
2. MVC模式 VS 三层架构
三层架构是由表示层(UI)、业务逻辑层(BLL)和数据访问层(DAL)三个层次构成。各层之间采用接口相互访问,并通过实体类作为数据传递的载体。不同的实体类一般对应于数据库中不同的数据表,且实体类的属性与数据库表的字段名一一对应 。
表示层(UI):用来实现与用户的交互,接收用户请求,并将请求交给业务逻辑层(BLL)和数据访问层(DAL)进行处理,最后将处理结果返回给用户。包含 HTML、JSP 等前台页面以及后台的 Servlet,相当于 MVC 模式中的 View 层 + Controller 层。
业务逻辑层(BLL):起到承上启下的作用,接收表示层传递来的请求,并针对业务对数据进行处理,以实现业务目标。包含了 Service 接口及其实现类(Servicelmpl)的代码,相当于 MVC 模式中 Model 层的一部分(Service部分)。
数据访问层(DAL):用于实现与数据库的交互和访问,例如从数据库中获取数据、保存或修改数据库中的数据等。包含了 Dao 接口及其实现类(DaoImpl)的代码,相当于 MVC 模式中 Model 层的一部分(Dao部分)。
3. MVC工作流程
用户发送请求到服务器;
在服务器中,请求被控制层(Controller)接收;
Controller 调用相应的 Model 层处理请求;
Model 层处理完毕将结果返回到 Controller;
Controller 再根据 Model 返回的请求处理结果,找到相应的 View 视图;
View 视图渲染数据后最终响应给浏览器。
4. MVC优点
- 降低代码耦合性:在 MVC 模式中,三层之间相互独立,各司其职。一旦某一层的需求发生了变化,我们就只需要更改相应层中的代码即可,而不会对其他层中的代码造成影响。
- 有利于分工合作:在 MVC 模式中,将应用系统划分成了三个不同的层次,可以更好地实现开发分工。例如,网页设计人员专注于视图(View)层的开发,而那些对业务熟悉的开发人员对 Model 层进行开发,其他对业务不熟悉的开发人员则可以对 Controller 层进行开发。
- 有利于组件的重用:在 MVC 中,多个视图(View)可以共享同一个模型(Model),大大提高了系统中代码的可重用性。
5. MVC缺点
- 增加了系统结构和实现的复杂性:对于简单的应用,如果也严格遵循 MVC 模式,按照模型、视图与控制器对系统进行划分,无疑会增加系统结构的复杂性,并可能产生过多的更新操作,降低运行效率。
- 视图与控制器间的联系过于紧密:虽然视图与控制器是相互分离的,但它们之间联系却是十分紧密的。视图没有控制器的存在,其应用是很有限的,反之亦然,这样就妨碍了它们的独立重用。
- 视图对模型数据的低效率访问:视图可能需要多次调用才能获得足够的显示数据。对未变化数据的不必要的频繁访问,也将损害操作性能。
MVC 并不适合小型甚至中型规模的项目,花费大量时间将 MVC 应用到规模并不是很大的应用程序中,通常会得不偿失,因此对于 MVC 设计模式的使用要根据具体的应用场景来决定。
二、Spring MVC
1. Spring Web MVC
Spring 框架提供的一款基于 MVC 模式的轻量级 Web 开发框架,是 Spring 为表示层(UI)开发提供的一整套完备的解决方案。
Spring MVC 各层的职责如下:
- Model:负责对请求进行处理,并将结果返回给 Controller;
- View:负责将请求的处理结果进行渲染,展示在客户端浏览器上;
- Controller:是 Model 和 View 交互的纽带;主要负责接收用户请求,并调用 Model 对请求处理,然后将 Model 的处理结果传递给 View。
Spring MVC 本质是对 Servlet 的进一步封装,最核心的组件是 DispatcherServlet,它是 Spring MVC 的前端控制器,主要负责对请求和响应的统一地处理和分发。Controller 接收到的请求就是 DispatcherServlet 根据一定的规则分发给它的。
Spring MVC 框架内部采用松耦合、可插拔的组件结构,具有高度可配置性,比起其他的 MVC 框架更具有扩展性和灵活性。此外,Spring MVC 的注解驱动(annotation-driven)和对 REST 风格的支持,也是它最具有特色的功能。
2. Spring MVC 的常用组件
组件 | 提供者 | 描述 |
---|---|---|
DispatcherServlet | 框架提供 | 前端控制器,它是整个 Spring MVC 流程控制中心,负责统一处理请求和响应,调用其他组件对用户请求进行处理。 |
HandlerMapping | 框架提供 | 处理器映射器,根据请求的 url、method 等信息查找相应的 Handler。 |
HandlerAdapter | 框架提供 | 处理器适配器,Handler执行业务方法前,需要进行一系列的操作,包括表单数据的验证,数据类型的转换,将表单数据封装到JavaBean等。DispatcherServlet通过HandlerAdapter执行不同的Handler。 |
Handler | 开发人员提供 | 处理器,通常被称为 Controller(控制器)。它可以在 DispatcherServlet 的控制下,处理具体的业务逻辑。 |
HandlerInterceptor | 处理器拦截器,是一个接口,若需要完成拦截处理,可以实现该接口。 | |
HandlerExecutionChain | 处理器执行链,包括Handler和HandlerInterceptor(系统有一个默认的HandlerInterceptor,如需额外拦截,可以添加拦截器)。 | |
ModelAndView | 装载模型数据和视图信息,作为Handler的处理结果,返回DispatcherServlet。 | |
ViewResolver | 框架提供 | 视图解析器,其职责是对视图进行解析,得到相应的视图对象。DispatcherServlet通过它将逻辑视图解析为物理视图。最终将渲染结果显示到客户端。常见的视图解析器有 ThymeleafViewResolver、InternalResourceViewResolver 等。 |
View | 开发人员提供 | 视图,它作用是将模型(Model)数据通过页面展示给用户。 |
3. Spring MVC工作流程
- 用户通过浏览器发起一个 HTTP 请求,该请求会被 DispatcherServlet(前端控制器)拦截;
- DispatcherServlet 调用 HandlerMapping(处理器映射器)找到具体的处理器(Handler)及拦截器,最后以 HandlerExecutionChain 执行链的形式返回给 DispatcherServlet。
- DispatcherServlet 将执行链返回的 Handler 信息发送给 HandlerAdapter(处理器适配器);
- HandlerAdapter 根据 Handler 信息找到并执行相应的 Handler(即 Controller 控制器)对请求进行处理;
- Handler 执行完毕后会返回给 HandlerAdapter 一个 ModelAndView 对象(Spring MVC 的底层对象,包括 Model 数据模型和 View 视图信息);
- HandlerAdapter 接收到 ModelAndView 对象后,将其返回给 DispatcherServlet ;
- DispatcherServlet 接收到 ModelAndView 对象后,会请求 ViewResolver(视图解析器)对视图进行解析;
- ViewResolver 解析完成后,会将 View 视图并返回给 DispatcherServlet;
- DispatcherServlet 接收到具体的 View 视图后,进行视图渲染,将 Model 中的模型数据填充到 View 视图中的 request 域,生成最终的 View(视图);
- 视图负责将结果显示到浏览器(客户端)。
4. Spring MVC 的特点
- Spring MVC 是 Spring 家族原生产品,可以与 IoC 容器等 Spring 基础设施无缝对接;
- Spring MVC 支持各种视图技术,例如 JSP、Thymeleaf、 JSP 和 FreeMaker 等。
- Spring MVC 基于原生的 Servlet 实现,通过功能强大的前端控制器 DispatcherServlet,对请求和响应进行统一处理;
- Spring MVC 对表示层各细分领域需要解决的问题全方位覆盖,并提供一整套全面的解决方案;
- 代码清新简洁,大幅度提升开发效率;
- 内部组件化程度高,可插拔式组件即插即用,想要使用什么功能,配置相应组件即可;
- 性能卓著,尤其适合现代大型、超大型互联网项目的开发。
三、@Controller 和 @RequestMapping注解
1. @Controller 注解:将普通 Java 类标识成控制器(Controller)类
package com.circle.controller;
import org.springframework.stereotype.Controller;
@Controller
public class IndexController {
// 处理请求的方法
}
Spring MVC 通过组件扫描机制查找应用中的控制器类的,为了保证控制器能够被 Spring MVC 扫描到,我们还需要在 Spring MVC 的配置文件中使用 <context:component-scan/>
标签,指定控制器类的基本包(请确保所有控制器类都在基本包及其子包下)
<!-- SpringMVC.xml -->
<!-- 使用扫描机制扫描控制器类,控制器类都在net.biancheng.controller包及其子包下 -->
<context:component-scan base-package="com.circle.controller" />
2. @RequestMapping 注解:标注在控制器方法上,负责将请求与处理请求的控制器方法关联起来,建立映射关系。
前端控制器(DispatcherServlet)拦截到用户发来的请求后,会通过 @RequestMapping 注解提供的映射信息找到对应的控制器方法,对这个请求进行处理。
@RequestMapping 既可以标注在控制器类上,也可以标注在控制器方法上。
2.1 修饰方法
当 @RequestMapping 注解被标注在方法上时,value 属性值就表示访问该方法的 URL 地址。当用户发送过来的请求想要访问该 Controller 下的控制器方法时,请求路径就必须与这个 value 值相同。
@Controller
public class HelloController {
@RequestMapping("/login")
public String welcome() {
return "login";
}
}
2.2 修饰类
当 @RequestMapping 注解标注在控制器类上时,value 属性的取值就是这个控制器类中的所有控制器方法 URL 地址的父路径。也就是说,访问这个 Controller 下的任意控制器方法都需要带上这个父路径。
@Controller
@RequestMapping(value = "/springmvc")
public class HelloController {
@RequestMapping("/login")
public String welcome() {
return "login";
}
}
用户想要访问 HelloController 中的 welcome() 方法,请求地址必须为“/springmvc/login”
2.3 @RequestMapping 注解的属性
2.3.1 value:设置控制器方法的请求映射地址
- 所有能够匹配到该请求映射地址的请求,都可以被该控制器方法处理
- 默认属性,只设置了一个 value 属性,则"value="可以被省略
- 当取值是一个字符串类型的数组,表示该控制器方法可以匹配多个请求地址
@RequestMapping( "/register")
@RequestMapping( value = {"/register", "/login"})
- 可以使用 Ant 风格的统配符
通配符 | 说明 | 请求映射举例 | 匹配的请求地址举例 |
---|---|---|---|
? | 表示任意的单个字符。 | @RequestMapping(value = "/test-user?") |
|
* | 表示任意的 0 个或多个字符。 | @RequestMapping(value = "/test-user*") |
|
** | 表示任意的一层或多层目录。 注意,在使用该通配符时,其使用方式只能是 "/**/xxx"。 | @RequestMapping(value = "/**/testuser") |
|
2.3.2 name:方法的注释
@RequestMapping(value = "toUser",name = "获取用户信息")
public String getUsers() {
……
}
2.3.3 method:设置控制器方法支持的请求方式
@RequestMapping(value = "/toUser",method = RequestMethod.GET)
- 常用的请求方式有 GET(查看)、POST(创建)、DELETE(删除)、PUT (更新或创建)等。http://t.csdnimg.cn/XfsY3
- 没设置method说明该控制器方法支持全部请求类型,可以处理所有类型的请求
- 也可以为同一个控制器方法指定支持多种类型的请求,取值是一个 RequestMethod 类型的数组
@RequestMapping(value = "/toUser",method = {RequestMethod.GET,RequestMethod.POST})
2.3.4 params:指定请求中的参数,只有当请求中携带了符合条件的参数时,控制器方法才会对该请求进行处理
表达式 | 含义 |
---|---|
"param" | 请求中必须携带名为 param 的参数 |
"!param" | 请求中不能携带名为 param 的参数 |
"param=value" | 请求中必须携带名为 param 的参数,且参数的取值必须为:value |
"param!=value" | 请求中不能携带参数:param = value。 |
当取值是一个字符串类型的数组,表示只有请求中同时携带了 params 属性指定的全部参数时,控制器方法才会对该请求进行处理。
2.3.5 headers:设置请求中请求头信息,只有当请求中携带指定的请求头信息时,控制器方法才会处理该请求。
表达式 | 含义 |
---|---|
"header" | 请求必须携带请求头信息:header |
"!header" | 请求中不能携带请求头信息:header |
"header=value" | 请求中必须携带请求头信息:header=value 。 |
"header!=value" | 请求中不能携带请求头信息:header=value。 |
3. @ResponseBody注解:直接响应客户端,不进行视图解析
4. @RestController
如果在每一个方法前都加@ResponseBody,则可以将类前的@Controller注解改为@RestController,功能一致。
四、获取请求参数
- 通过 HttpServletRequest 获取请求参数
- 通过控制器方法的形参获取请求参数
- 使用 @RequestParam 注解获取请求参数
- 通过实体类对象获取请求参数(推荐)
1. 通过 HttpServletRequest 获取请求参数
在控制器方法中设置一个 HttpServletRequest 类型的形参,Spring MVC 会自动将请求中携带的参数封装到 HttpServletRequest 形参中,然后我们就可以通过 HttpServletRequest 提供的 getParameter() 方法获取所需的请求参数。
@RequestMapping("/getRequestParam")
public String requestParam(HttpServletRequest request) {
String name = request.getParameter("name");
String url = request.getParameter("url");
System.out.println("name:" + name);
System.out.println("url:" + url);
return "index";
}
2. 通过控制器方法的形参获取请求参数
在 Controller 的控制器方法中设置与请求参数同名的形参,以获取请求中携带的参数。当浏览器发送的请求匹配到这个控制器方法时,Spring MVC 会自动将请求参数赋值给相应的方法形参。
当发送的请求的 url 为“http://localhost:8080/project/test?name=tom&language=java”时,那么处理该请求的控制器方法的代码如下。
@RequestMapping("/test") public String test(String name, String language) { System.out.println("name:" + name); System.out.println("language:" + language); return "success"; }
-
必须保证控制器方法的形参名称与请求中携带参数的名称完全一致(区分大小写),否则控制器方法接收到的请求参数值会是 null。
-
这种方式是无视参数的数据类型的,我们可以在控制器方法中使用 String 字符串类型的形参接收所有的请求参数,也可以根据实际情况在控制器方法中使用对应数据类型的参数来接收请求参数,而无须自行进行数据类型转换。
-
不适用于请求参数过多的请求
-
当请求中包含多个同名的请求参数时,通过以下 2 种类型的形参来获取请求参数
形参的数据类型 | 获取到的请求参数值 | 举例 |
---|---|---|
String(字符串) | 所有同名请求参数的值通过逗号(“,”)拼接在一起。 | "true,false,true" |
数组 | 由所有同名请求参数值组成的数组。 例如,如果所有同名请求参数的取值都是 true 或 false,那么我们就可以在控制器方法中使用 Boolean 类型数组的形参进行接收。 | {"true", "false", "true"} |
3. 使用 @RequestParam 注解获取请求参数
在控制器方法中通过 @RequestParam 注解,在请求参数与控制器方法的形参之间建立起映射关系,将它们绑定起来。这样即使请求参数与控制器方法中的形参名称不一致,我们也能获取到对应的请求参数值。
请求的地址为“http://localhost:8080/project/test?name=Java&pass=yyds”
@RequestMapping("/testRequestParam")
public String testRequestParam(@RequestParam("name") String username, @RequestParam("pass") String password) {
System.out.println(username + "," + password);
return "success";
}
属性 | 说明 |
---|---|
name | 请求中的参数名。 name 为 @RequestParam 注解 value 属性的别名,它与 value 属性完全等价。 |
value | 请求中的参数名。 value 为 @RequestParam 注解 name 属性的别名,它与 name 属性完全等价。 |
required | 该请求参数名是否必须,默认值为 true,即默认情况下请求中必须包含对应的请求参数名,否则就会抛出异常。 注意:required 属性是对请求参数名设置的规则,但并没有对该请求参数是否有值进行限制。也就是说,当 required 属性为 true 或没有设置 required 属性时,请求中就必须包含对应的参数名,至于该请求参数是否有值则无所谓。 |
defaultValue | 请求参数的默认值。如果请求中没有该值,则该值为默认值。 注意: defaultValue 属性会使 required ="true" 失效,即将 required 属性自动设置为 false。 |
4. 通过实体类对象获取请求参数(推荐)
在 Controller 控制器方法的形参中设置一个实体类形参,如果请求参数的参数名与实体类中的属性名一致,那么 Spring MVC 会自动将请求参数封装到该实体类对象中。此时我们就可以通过该实体类对象获取所需的请求参数了。
@Data
public class User {
private String UserId;
private String UserName;
private Integer age;
}
@Controller
public class UserController {
/**
* 通过实体类获取请求参数
*
* @param user
* @return
*/
@RequestMapping("/getUser")
public String getUser(User user) {
System.out.println("userId:" + user.getUserId());
System.out.println("userName:" + user.getUserName());
System.out.println("password:" + user.getPassword());
return "success";
}
}
5. 解决获取请求参数的乱码问题
当我们在 post 请求中传递的参数为中文时,控制器方法获取到的参数值会出现乱码的情况。
Spring MVC 默认提供了一个过滤器 CharacterEncodingFilter,我们只需要在 web.xml 中对该 Filter 进行简单的配置,即可解决请求和响应中的中文乱码问题。
<!--请求和响应的字符串过滤器-->
<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>
<!--设置响应的编码,这里我们可以省略-->
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
其他中文乱码:
-
在SpringMVC.xml文件中配置消息转换器:适用于异步请求
-
方法中形参HttpServletResponse:适用于同步请求
6. List
SpringMVC不支持List的直接转换,需对List进行包装
7. map
8. JSON
五、域对象共享数据
在 Spring MVC 中,控制器在接收到 DispatcherServlet 分发过来的请求后,会继续调用 Model 层对请求进行处理。Model 层处理完请求后的结果被称为模型数据,会将模型数据返回给 Controller。Controller 在接收到 Model 层返回的模型数据后,下一步就是将模型数据通过域对象共享的方式传递给 View 视图进行渲染,最终返回给客户端展示。
域对象是服务器在内存上创建的一块存储空间,主要用不同动态资源之间的数据传递和数据共享。在 Spring MVC 中,常用的域对象有 request 域对象、session 域对象、application 域对象等。
常用的域对象共享数据的方式如下:
- 使用 Servlet API 向 request 域对象中共享数据(不推荐)
- 使用 ModelAndView 向 request 域对象中共享数据:方法内new对象调用函数
model 负责数据共享,而 view 则主要用于设置视图,实现页面的跳转。
方法 说明 ModelAndView addObject(String attributeName, @Nullable Object attributeValue) 添加模型数据 ModelAndView addObject(Object attributeValue) ModelAndView addAllObjects(@Nullable Map<String, ?> modelMap) void setViewName(@Nullable String viewName) 设置视图
- 使用 Model 向 request 域对象中共享数据:在 Controller 控制器方法中设置一个 Model 类型的形参
@RequestMapping("/testModel") public String testModel(Model model) { model.addAttribute("testScope", "hello,Model"); return "success"; }
- 使用 Map 向 request 域对象中共享数据:在 Controller 控制器方法中设置一个 Map 类型的形参
@RequestMapping("/testMap") public String testMap(Map<String, Object> map) { map.put("testScope", "hello,Map"); return "success"; }
- 使用 ModelMap 向 request 域对象中共享数据:在 Controller 控制器方法中设置一个 ModelMap 类型的形参
@RequestMapping("/testModelMap") public String testModelMap(ModelMap modelMap) { modelMap.addAttribute("testScope", "hello,ModelMap"); return "success"; }
- 使用 Servlet API 向 session 域中共享数据:在控制器方法中设置一个 HttpSession 类型的形参
@RequestMapping("/testSession") public String testSession(HttpSession session) { session.setAttribute("testSessionScope", "hello,session"); return "success"; }
- 使用 Servlet API 向 application 域中共享数据:在控制器方法中设置一个 HttpSession 类型的形参
@RequestMapping("/testApplication") public String testApplication(HttpSession session) { ServletContext application = session.getServletContext(); application.setAttribute("testApplicationScope", "hello,application"); return "success"; }
详见:Spring MVC域对象共享数据
六、视图与视图解析器
未看,详见Spring MVC视图和视图解析器
七、转发(“forward:”)与重定向(“redirect:”)
1. 概念
实现页面的跳转有两种方式。
转发是由服务器端进行的页面跳转,是一种在服务器内部的资源跳转方式。是网络设备基于IP地址和端口号的决策来进行的,它是网络层或传输层的行为
重定向是将各种网络请求重新定个方向转到其它位置。是应用层的行为,通常由服务器根据HTTP协议实现,它涉及对请求的响应,改变请求的走向。
2. 请求转发
在控制器方法指定逻辑视图名(View Name)时,使用“forward:”关键字进行请求转发操作。当控制器方法中所设置的逻辑视图名称以“forward:”为前缀时,该逻辑视图名称不会被 Spring MVC 配置的视图解析器解析,而是会将前缀“forward:”去掉,以剩余部分作为最终路径通过转发的方式实现跳转。
2.1 通过 String 类型的返回值实现转发
@RequestMapping("/testDispatcher")
public String testDispatcher() {
return "forward:/login";
}
Spring MVC 会将“forward:”识别为转发指示符,而剩余的“/login”则会被当做转发的 URL,即路径“/testDispatcher”请求最终会被转发到 “/login”上进行处理。
2.2 通过 ModelAndView 实现转发
@RequestMapping("/testDispatcher")
public ModelAndView testDispatcher() {
ModelAndView modelAndView = new ModelAndView();
//设置逻辑视图名
modelAndView.setViewName("forward:/login");
return modelAndView;
}
3. 重定向
3.1 通过 String 类型的返回值实现重定向
@RequestMapping("/testRedirect")
public String testRedirect() {
return "redirect:/login";
}
3.2 通过 ModelAndView 实现重定向
@RequestMapping("/testRedirect")
public ModelAndView testDispatcher() {
ModelAndView modelAndView = new ModelAndView();
//设置逻辑视图名
modelAndView.setViewName("redirect:/login");
return modelAndView;
}
八、RESTful
1. 概念
RESTful(REST 风格)是一种当前比较流行的互联网软件架构模式,它充分利用 HTTP 协议的特性,为我们规定了一套统一的资源获取方式,以实现不同终端之间(客户端与服务端)的数据访问与交互。
RESTFul 提倡我们使用统一的风格来设计 URL,其规则如下。
1. URL 只用来标识和定位资源,不得包含任何与操作相关的动词。例如访问与用户(user)相关的资源时,其 URL 可以定义成以下形式。
http://localhost:8080/biancheng/user
2. 当请求中需要携带参数时,RESTFul 允许我们将参数通过斜杠(/)拼接到 URL 中,将其作为 URL 的一部分发送到服务器中,而不再像以前一样使用问号(?)拼接键值对的方式来携带参数,示例如下。
http://localhost:8080/biancheng/user/1
注:我们在 URL 的末尾通过 “/1”的形式传递了一个取值为 1 的参数。
3. HTTP 协议中有四个表示操作方式的动词:GET、POST、PUT 和 DELETE,它们分别对应了四种与资源相关的基本操作: GET 用来获取资源, POST 用来新建资源, PUT 用来更新资源, DELETE 用来删除资源。客户端通过这四个动词,即可实现对服务器端资源状态转移的描述。
资源操作 | 传统方式 URL | RESTFul URL | HTTP 请求方式 |
---|---|---|---|
获取资源(SELECT) | http://localhost:8080/biancheng/getUserById?id=1 | http://localhost:8080/biancheng/user/1 | GET |
保存或新增资源(INSERT) | http://localhost:8080/biancheng/saveUser | http://localhost:8080/biancheng/user | POST |
修改或更新资源(UPDATE) | http://localhost:8080/biancheng/updateUser | http://localhost:8080/biancheng/user | PUT |
删除资源(DELETE) | http://localhost:8080/biancheng/deleteUser?id=1 | http://localhost:8080/biancheng/user/1 | DELETE |
REST 实际上是 Resource Representational State Transfer 的缩写,翻译成中文就是“表现层资源表述状态转移”。
Resource(资源):工程中的所有内容在都可以被称为这个服务器中的资源,可以是一个类、一个 HTML 文件、一个 CSS 文件、一个 JS 文件、数据库中的一张表、一段文本、一张图片、一段音频等,服务器则可以看作是由许许多多离散的资源组成的。这些资源都有一个共同的特征,那就是它们都可以通过一个 URI(统一资源标识符) 进行标识,任何对于该资源的操作都不能改变其 URI。想要获取这个资源,只要访问它的 URI 即可。
Representation(资源的表述):资源在某个特定时刻的状态的描述,即资源的具体表现形式,它可以有多种格式,例如 HTML、XML、JSON、纯文本、图片、视频、音频等。通常情况下,服务端与客户端资源的表述所有使用的格式往往是不同的,例如在服务端资源可能是数据库中的一段纯文本、一个 XML 文件、或者是数据库中的一张表,而客户端则可能是表现为 HTML 页面、JSON、甚至是音频和视频。
State Transfer(状态转移):客户端与服务端进行交互时,资源从一种表现形式转换到另一种表现形式的过程。但是 HTTP 协议是一种无状态协议,它是无法保存任何状态的,因此如果客户端想要获取服务器上的某个资源,就必须通过某种手段让资源在服务器端发生“状态转化”,而这种状态转化又是建立在应用的表现层(UI)上的。这就是“表现层资源状态转移”的含义。
REST 实际上描述的是服务器与客户端的一种交互形式,REST 本身并不是一个实用的概念,真正实用的是如何设计 RESTFul(REST 风格)的接口,即我们到底通过什么样的手段让资源在服务器端发生状态转移。
2. 实现RESTful
通过 @RequestMapping +@PathVariable 注解的方式实现 RESTful 风格的请求。
2.1 通过@RequestMapping 注解的路径设置
当请求中携带的参数是通过请求路径传递到服务器中时,我们就可以在 @RequestMapping 注解的 value 属性中通过占位符 {xxx} 来表示传递的参数。且value 属性中占位符的位置应当与请求 URL 中参数的位置保持一致,否则会出现传错参数的情况。
@RequestMapping("/testRest/{id}/{username}")
2.2 通过 @PathVariable 注解绑定参数
在控制器方法的形参位置通过 @PathVariable 注解,将占位符 {xxx} 所表示的参数赋值给指定的形参。
@RequestMapping("/testRest/{id}/{username}")
public String testRest(@PathVariable("id") String id, @PathVariable("username")
String username) {
System.out.println("id:" + id + ",username:" + username);
return "success";
}
2.3 通过 HiddenHttpMethodFilter 对请求进行过滤
由于浏览器默认只支持发送 GET 和 POST 方法的请求,因此我们需要在 web.xml 中使用 Spring MVC 提供的 HiddenHttpMethodFilter 对请求进行过滤。这个过滤器可以帮助我们将 POST 请求转换为 PUT 或 DELETE 请求。
HiddenHttpMethodFilter 处理 PUT 和 DELETE 请求时,必须满足以下 2 个条件:
- 当前请求的请求方式必须为 POST;
- 当前请求必须传输请求参数 _method。
在满足了以上条件后,HiddenHttpMethodFilter 过滤器就会将当前请求的请求方式转换为请求参数 _method 的值,即请求参数 _method 的值才是最终的请求方式,因此我们需要在 POST 请求中携带一个名为 _method 的参数,参数值为 DELETE 或 PUT。
<!--来处理 PUT 和 DELETE 请求的过滤器-->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
若 web.xml 中同时存在 CharacterEncodingFilter 和 HiddenHttpMethodFilter 两个过滤器,必须先注册 CharacterEncodingFilter,再注册 HiddenHttpMethodFilter。
暂且如此!没学完!
参考:Spring MVC框架入门教程