【SpringMVC】3.REST表现层状态转换

最新推荐文章于 2023-10-16 13:38:11 发布
原创 最新推荐文章于 2023-10-16 13:38:11 发布 · 680 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#REST #表现层状态转换 #@PathVariable

本文深入解析REST架构风格及其在SpringMVC框架中的应用，涵盖@PathVariable注解详解，GET、POST、PUT、DELETE请求处理，以及HiddenHttpMethodFilter配置，适合初学者快速掌握RESTful API设计。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

注意！！！
此文章需要配置了SpringDispatcherServlet和InternalResourceViewResolver才能够使用，如果不会配置，请翻看我【SpringMVC】系列的第一篇文章《【SpringMVC】1. SpringMVC的第一个程序——HelloWorld》

一、什么是REST

表现层状态转换（REST，英文：Representational State Transfer）是Roy Thomas Fielding博士于2000年在他的博士论文[1] 中提出来的一种万维网软件架构风格，目的是便于不同软件/程序在网络（例如互联网）中互相传递信息。表现层状态转换（REST，英文：Representational State Transfer）是根基于超文本传输协议(HTTP)之上而确定的一组约束和属性，是一种设计提供万维网络服务的软件构建风格。匹配或兼容于这种架构风格(简称为 REST 或 RESTful)的网络服务，允许客户端发出以统一资源标识符访问和操作网络资源的请求，而与预先定义好的无状态操作集一致化。因此表现层状态转换提供了在互联网络的计算系统之间，彼此资源可交互使用的协作性质(interoperability)。相对于其它种类的网络服务，例如 SOAP服务则是以本身所定义的操作集，来访问网络上的资源。
—维基百科《表现层状态转换》

要点及标准

要注意的是，REST是设计风格而不是标准。REST通常基于使用HTTP，URI，和XML以及HTML这些现有的广泛流行的协议和标准。

  • 资源是由URI来指定。
  • 对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。
  • 通过操作资源的表现形式来操作资源。
  • 资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。
    这里写图片描述

更多内容请点击： 维基百科《表现层状态转换》进行了解


二、@PathVariable

在了解了什么是REST风格的地址后，我们可以了解下@PathVariable注解，这个注解是专门用来获取REST风格地址参数。

  • 带占位符的URL是Spring3.0 新增的功能，该功能在SpringMVC向REST 目标挺进发展过程中具有里程碑的意义
  • 通过 @PathVariable 可以将URL中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx}
    占位符可以通过@PathVariable("xxx")绑定到操作方法的入参中。


    ###（1）在com.springmvc.handlers中创建一个Handle类SpringMVCTest
package com.springmvc.handlers;

import java.io.IOException;
import java.io.Writer;
import java.util.Arrays;
import java.util.Date;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.CookieValue;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.SessionAttributes;
import org.springframework.web.servlet.ModelAndView;

import com.springmvc.entities.User;

@SessionAttributes(value = { "user" }, types = { String.class })
@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {

	private static final String SUCCESS = "success";
	
	/**
	 * @PathVariable 可以用来映射URL中的占位符到目标方法的参数
	 * @param id
	 * @return
	 */
	@RequestMapping(value = "/testPathVariable/{id}")
	public String testPathVariable(@PathVariable("id") Integer id) {
		System.out.println("testPathVariable id:" + id);
		return SUCCESS;
	}
}

（2）在WebRoot文件夹根目录创建index.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>

<title>My JSP 'index.jsp' starting page</title>
</head>

<body>
<a href="springmvc/testPathVariable/1">testPathVariable</a>
</body>

</html>

（3）在WEB-INF文件夹下创建views，并在views下创建success.jsp文件

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>success</title>
</head>

<body>
	<h1>Success page</h1>
</body>
</html>

（4）运行Tomcat，访问index.jsp

这里写图片描述
直接点击超链接testPathVariable即可，上面那些是我上一篇教程留下来的东西，不用去管。
点击超链接后跳转到Success页面，然后查看MyEclipse的控制台

这里写图片描述
发现id已经从链接http://localhost:8080/springmvc-1/springmvc/testPathVariable/1获取出来。


三、使用GET、POST、PUT 与DELETE 请求

HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：

  1. GET 用来获取资源
  2. POST 用来新建资源
  3. PUT 用来更新资源
  4. DELETE 用来删除资源。

如何发送PUT请求和DELETE请求？
1.需要配置HiddenHttpMethodFilter
2.请求页面需要发送POST请求
3.需要在发送POST请求时携带一个name="_method"的隐藏域，值为DELETE，或PUT

（1）在web.xml中配置HiddenHttpMethodFilter

使用HiddenHttpMethodFilter指定HTTP的请求类型：浏览器 form 表单只支持GET与POST请求，而DELETE、PUT 等 method 并不支持，Spring3.0 添加了一个过滤器，可以将这些请求转换为标准的 http 方法，使得支持 GET、POST、PUT 与DELETE 请求。

<!-- 配置org.springframework.web.filter.HiddenHttpMethodFilter 可以把POST请求转换为DELETE或者POST请求 -->
	<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>

### （2）在`com.springmvc.handlers`中创建Handler类`SpringMVC` 并且写入相关的请求方法 
package com.springmvc.handlers;

import java.io.IOException;
import java.io.Writer;
import java.util.Arrays;
import java.util.Date;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.CookieValue;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestHeader;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.SessionAttributes;
import org.springframework.web.servlet.ModelAndView;

import com.springmvc.entities.User;

@SessionAttributes(value = { "user" }, types = { String.class })
@RequestMapping("/springmvc")
@Controller
public class SpringMVCTest {
	/*
	 * REST风格的URL 以CRUD为例： 
	 * 新增：/order POST 
	 * 修改：/order/1 PUT 
	 * update?id=1
	 * 获取：/order/1 GET get?id=1 
	 * 删除：/order/1 DELETE delete?id=1
	 * 
	 * 如何发送PUT请求和DELETE请求？ 
	 * 1.需要配置HiddenHttpMethodFilter 
	 * 2.需要发送POST请求
	 * 3.需要在发送POST请求时携带一个name="_method"的隐藏域，值为DELETE，或PUT
	 * 
	 * 在SpringMVC的目标方法中如何获得id？ 使用@PathVariable注解
	 */
	@RequestMapping(value = "/testRest/{id}", method = RequestMethod.GET)
	public String testRest(@PathVariable("id") Integer id) {
		System.out.println("testRest id:" + id);
		return SUCCESS;
	}

	@RequestMapping(value = "/testRest", method = RequestMethod.POST)
	public String testRest() {
		System.out.println("testRest POST");
		return SUCCESS;
	}

	@RequestMapping(value = "/testRest/{id}", method = RequestMethod.DELETE)
	@ResponseBody
	public String testRestDelete(@PathVariable("id") Integer id) {
		System.out.println("testRest Delete:" + id);
		return SUCCESS;
	}

	@RequestMapping(value = "/testRest/{id}", method = RequestMethod.PUT)
	@ResponseBody
	public String testRestPut(@PathVariable("id") Integer id) {
		System.out.println("testRest put:" + id);
		return SUCCESS;
	}
}

（3）在WebRoot的根目录下创建index.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>

<title>My JSP 'index.jsp' starting page</title>
</head>

<body>
<a href="springmvc/testRest/1">TestRest Get</a>
	<br>
	<br>
	<form action="springmvc/testRest" method="post">
		<input type="submit" value="TestRest POST"/>
	</form>
	<br>
	<br>
	<form action="springmvc/testRest/1" method="post">
		<input type="hidden" name="_method" value="DELETE"/> 
		<input type="submit" value="TestRest DELETE"/>
	</form>
	<br>
	<br>
	<form action="springmvc/testRest/1" method="post">
		<input type="hidden" name="_method" value="PUT"/> 
		<input type="submit" value="TestRest PUT"/>
	</form>
	</body>

</html>

（4）效果展示

启动TomCat服务器后，访问index主页：http://localhost:8080/springmvc-1/index.jsp
这里写图片描述

由于我的index页面包含前几篇文章的代码，所以多出了几个超链接，只需关注红框位置就好

1.测试超链接TestRestGet

这里写图片描述

超链接 TestRestGet能够正常访问



2.测试表单提交按钮TestRestPOST
这里写图片描述
按钮 TestRestPOST能够正常访问

这里写图片描述


3.测试表单提交按钮TestRestDELETE
这里写图片描述
这里写图片描述
按钮 TestRestDELETE能够正常访问



4.测试表单提交按钮TestRestPUT
这里写图片描述
这里写图片描述
按钮 TestRestPUT能够正常访问

SpringMVC4.X:Spring MVC 4.X REST JSON示例
05-20
在IT行业中，SpringMVC是Java企业级应用开发的一个重要框架，它为构建Web应用程序提供了模型-视图-控制器（MVC）架构。SpringMVC 4.X版本引入了对RESTful服务的强大支持，使得开发者可以轻松地创建JSON格式的数据...
SpringMVC.rar
08-18
在SpringMVC中，模型通常由JavaBean对象表示，这些对象处理业务逻辑并存储状态信息。 **视图（View）**：视图负责呈现模型中的数据。它可以是HTML页面、JSP、FreeMarker或其他模板技术。视图不直接与模型交互，而是...
SpringMVC_3 REST风格
mango
08-23 170
REST 是什么 1）REST：即 Representational State Transfer。（资源）表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用 ①资源（Resources）：网络上的一个实体，或者说是网络上的一个具体信息。 它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。 可以用一个 URI（统一资源定位符）指向它，每种资源对应一个特定的 URI 。 获取这个资源，访问它的 URI 就可以，因此
spring mvc3 REST中的一个注意点
jackyrongvip的专栏
06-02 118
spring mvc3 REST中的一个注意点，比如： @RequestMapping(value = "/addarticle/{name}", method = RequestMethod.POST) public ModelAndView addArticleCategoriesForName(@PathVariable String name) { ...
网络通信和IO（7）：RESTfull梗概 / RESTfull和RPC的区别
qq_40373699的博客
06-19 498
RESTfull梗概 RESTFULL不是规范，也不是所谓的封装，RESTFULL是一种网络应用程序的设计风格和开发方式，基于HTTP，可以使用XML格式定义或JSON格式定义。将http协议用的更彻底了，比如http的put,delete提交方式，更加深刻了面向资源的概念，每一种URI代表一种资源并且支持get\post\put\delete动词。 RESTFUL特点包括： 1、每一个URI代表1种资源； 2、客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GE
REST资源的表述性、状态和转化
最新发布
qq_40427481的博客
10-16 139
通过资源的转化，我们可以实现资源的复用和共享，提高系统的灵活性和可扩展性。只有在不断学习和应用REST的基本原则和设计理念的基础上，我们才能够构建出具有高性能和可扩展性的系统，满足不断发展的互联网应用的需求。通过状态码，我们可以了解资源的当前状态，根据不同的状态做出相应的处理，从而实现对资源的有效管理和控制。通过合理选择资源的表述形式、理解资源的状态以及实现资源的转化，我们可以构建出高效、灵活和可扩展的系统。在REST中，资源是系统的核心概念，而资源的表述性、状态和转化则是实现资源交互和共享的关键要素。
es中的Rest层
多看多听多总结
05-14 706
1、概述 RestHandler作为rest层的处理器，是es接收请求的处理抽象。 2、Rest层相关抽象 2.1 RestHandler 处理rest的处理器，作为函数接口，其方法有 方法 说明 void handleRequest(RestRequest request, RestChannel channel, NodeClient client) 处理rest请求 boolean canTripCircuitBreaker() 是否可以断路，默认返回true
SpringMVC单词.docx
12-14
3. **Representational**：在Web开发中，Representational State Transfer（REST）是一种网络应用程序的设计风格和开发方式，它强调资源的表述状态转移。这里的"representational"指的是通过HTTP响应返回的资源的...
基于springMVC3.2的REST源码，结合了jquery和json
04-28
4. **JSON序列化和反序列化**：SpringMVC默认支持Jackson库进行JSON转换，通过`@ResponseBody`注解将方法返回值直接转换为JSON响应。对于请求参数，可以使用`@RequestBody`注解将JSON请求体解析为Java对象。 5. **...
SpringMVC互联网软件架构REST使用详解
08-31
本文主要介绍了SpringMVC互联网软件架构REST的相关知识点，涵盖REST的定义、资源、表现层、状态转化、HTTP协议、GET、POST、PUT、DELETE请求等概念，以及如何使用HiddenHttpMethodFilter过滤器来实现REST风格的访问...
REST与RPC区别
热门推荐
zhaizhai的博客
05-26 2万+
OSI网络七层模型 第一层：应用层。定义了用于在网络中进行通信和传输数据的接口； 第二层：表示层。定义不同的系统中数据的传输格式，编码和解码规范等； 第三层：会话层。管理用户的会话，控制用户间逻辑连接的建立和中断； 第四层：传输层。管理着网络中的端到端的数据传输； 第五层：网络层。定义网络设备间如何传输数据； 第六层：链路层。将上面的网络层的数据包封装成数据帧，便于物理层传输； 第七...
SpringMVC: 对Controller或RestController配置路径进行统一修改
amadeus_liu2的博客
02-03 923
mvc
避免自己写的 url 被diss！建议看看这篇RESTful API简明教程！
weixin_46329358的博客
03-25 325
RESTful API 是每个程序员都应该了解并掌握的基本知识，我们在开发过程中设计 API 的时候也应该至少要满足 RESTful API 的最基本的要求（比如接口中尽量使用名词，使用 POST 请求创建资源，DELETE 请求删除资源等等，示例：GET /notes/id：获取某个指定 id 的笔记的信息）。 如果你看 RESTful API 相关的文章的话一般都比较晦涩难懂，包括...
restful深入浅出
weixin_40719943的博客
07-08 355
restful架构 如果一个架构符合REST原则，就称之为RESTful架构 REST：Representation State Transfer，表现层状态转化，省略了主语，Resource，准确的说应该是是：资源的表现层转化 资源(Resource) 资源，指的是网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一种服务，总之是一个具体的存在。可以用一个URI（统一资源定位符）指向它，每种资源对应一个特定的URI。要想获取这个资源，访问它的URI就可以，因此URI就成了每一个资
理解RESTful架构
优快云advancer的博客
02-15 317
RESTful是什么 RESTful架构，就是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。对于这个概念比较抽象不具体，实际上对于RESTful我更愿意把它称为web开发中表现层的设计模式或者一直设计风格。而要理解RESTful则要看RESTful的英文名（Representational State Transfer），中文的翻译是“表现...
REST和RESTful API
answer3lin的博客
01-14 4554
定义 REST即表述性状态传递（英文：Representational State Transfer，简称REST）是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格(software architecture style)。它是一种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩性。 REST密切相关的两个名词：资源和状态。可以说，资源是RE...
REST 表现层状态转换 架构说明
三心草的博客
10-09 2422
http://www.ruanyifeng.com/blog/2011/09/restful.html1、REST（Representational State Transfer）表现层状态转化，是Fielding对互联网软件的架构原则，REST的名称”表现层状态转化”中，省略了主语。”表现层”其实指的是”资源”（Resources）的”表现层”。2、资源（Reources），所谓“资源”就是网络上
REST-表现层状态转换
Veritas_C的博客
02-17 835
REST，Representational State Transfer，即表现层状态转换，指的是一种为了让信息在互联网上顺利传递而设计的软件架构风格，即一种采用标准URI进行调用的方案。 REST的核心原则是将API拆分为逻辑上的资源，REST 的核心要素包括资源、表现层和状态转换这三个部分。 REST 是一种设计风格，而非协议或标准。而HTTP/HTTPS、HTML、XML等协议是 REST ...
{定义介绍}什么是REST
享受心情平静
10-30 1万+
REST架构风格是全新的针对Web应用的开发风格，是当今世界最成功的互联网超媒体分布式系统架构，它使得人们真正理解了Http协议本来面貌。随着 REST架构成为主流技术，一种全新的互联网网络应用开发的思维方式开始流行。      REST是什么     REST是英文Representational State Transfer的缩写，中文翻译为“表述性状态转移”，他是由Roy Th
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值