Administrator
发布于 2022-10-10 / 57 阅读
0
0

SpringMVC+REST风格

简介

REST即表述性状态传递(英文:Representational State Transfer,简称REST)
是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。

它是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。

目前在三种主流的Web服务实现方案中,因为REST模式的Web服务与复杂的SOAP
和XML-RPC对比来讲明显的更加简洁,越来越多的web服务开始采用REST风格设计和实现。

例如,Amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。

REST风格是什么?

①REST:即 Representational State Transfer。(资源)表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用

资源(Resources):网络上的一个实体,或者说是网络上的一个具体信息。
它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。

可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的 URI 。

获取这个资源,访问它的URI就可以,因此 URI 即为每一个资源的独一无二的识别符。

表现层(Representation):把资源具体呈现出来的形式,叫做它的表现层(Representation)。比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。

状态转化(State Transfer):每发出一个请求,就代表了客户端和服务器的一次交互过程。HTTP协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生“状态转化”(State Transfer)。

而这种转化是建立在表现层之上的,所以就是 “表现层状态转化”。

具体说,就是 HTTP 协议里面,四个表示操作方式的动词:GET、POST、PUT、DELETE。
它们分别对应四种基本操作:GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE 用来删除

请求url  请求方式 表示含义
/book/1 GET:   查询1号图书
/book/1 DELETE:删除1号图书
/book/1 PUT:   更新1号图书
/book   POST:  添加1号图书
从页面发起PUT、DELETE形式的请求
 -->

别的理解

比如我们要访问一个 http 接口:http://localhost:8080/springboot/order?id=1021&status=1

采用 RESTFul 风格则 http 地址为:http://localhost:8080/springboot/order/1021/1
如此其实就是要依赖于@PathVariable注解

在这个方面觉得很奇怪;@PathVariable注解是一直有使用的,或者说都是这么用的
如果只是这样的话那肯定不能体现restful风格。
所以对应的请求方式就显得重要了。

eg:

@DeleteMapping(value = "/xxxx/{id}/detail/{phone}")
    public Object (@PathVariable("id") Integer id,
                           @PathVariable("phone") Integer phone) {
}

写配置

前提:

 浏览器 form 表单只支持 GET 与 POST 请求,而DELETE、PUT 等 method 并不支持,

  Spring3.0 添加了一个过滤器HiddenHttpMethodFilter,可以将这些请求转换为标准的 http 方法,
  使得支持 GET、POST、PUT 与 DELETE 请求。

配置HiddenHttpMethodFilter过滤器

<!-- 支持REST风格的过滤器:可以将POST请求转换为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>

以上只针对表单提交:

<form action="/rest01" method="post">
    <input type="hidden" name="_method" value="put">
    <input type="submit" value="put">
</form><br>
<form action="/rest01" method="post">
    <input type="hidden" name="_method" value="delete">
    <input type="submit" value="delete">
</form>
<br>

//为什么请求隐含参数名称必须叫做”_method”
//在源码中
//public static final String DEFAULT_METHOD_PARAM = "_method";

对应的controller

 @RequestMapping(value = "/rest01",method = RequestMethod.DELETE)
    public String restController03(){
        return "rest03";
    }

    @RequestMapping(value = "/rest01",method = RequestMethod.PUT)
    public String restController04(){
        return "rest04";
    }

一些问题:

  method = RequestMethod.PUT
  一定要以上面的方式写吗?		不一定
  Spring有几个新的注解:
  1.@RequestMapping(常用)
  2.@GetMapping
  3.@PostMapping
  4.@PutMapping				对应method = RequestMethod.PUT
    @PutMapping(value = "/rest01")
  5.@DeleteMapping
  
  在MVC/SpringBoot项目中,使用上面两种表达方式都是可以的
  至于所谓的拦截器配置,目前在学习中看来,只是用在表单提交方面。
  在使用postman进行测试时,是可以选择提交方式的,此时哪怕没有配置拦截器,只要注解使用得当,也能实现对应请求方式。

ps:注意:高版本Tomcat;Rest支持有点问题
解决方式:
image-1665392929207


评论