简单介绍RESTful风格

---

前言

学完RESTful风格之后，一直想总结一下它的基本使用，下文以一个简单案例的形式，创建一个使用RESTful风格的基本场景。

---

一、RESTful风格是什么？

现在的大多数网页都在用RESTful风格，它是一种风格，而不是一种技术。利用这种风格设计路由比较简洁高效。

RESTful风格特点：

引自百度百科：
1、每一个URI代表1种资源；
2、客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源；
3、通过操作资源的表现形式来操作资源；
4、资源的表现形式是XML或者HTML；
5、客户端与服务端之间的交互在请求之间是无状态的，从客户端到服务端的每个请求都必须包含理解请求所必需的信息。

二、搭建环境：

非常简单，需要以下3个文件，前两个html个文件有用的代码只有一行。

1. get.html

顾名思义，这个html里面，使用get的方式，向Controller发起请求。

代码如下：

<a href="/demo" methods="get">查询操作</a>

里面执行的是查询（获取资源）操作

2. post.html

顾名思义，这个html里面，使用post的方式，向Controller提交表单。

代码如下：

<form action="/demo" method="post">
	<!--里面是一个表单，只需要记住这是一个添加/更新操作就行了-->
</form>

里面执行的是新建（更新）资源的操作

3. Controller.java

顾名思义，这个Java就是Controller层。它负责用不同的方式（@GetMapping和@PostMapping）来接收同一个链接

    @GetMapping("/demo")
    public String query(){
        //接收get.html里面的get请求，执行查询（获取资源）操作
    }
    @PostMapping("/demo")
    public String add(){
		//接收post.html里面的post请求，执行新建（更新）资源的操作
    }

可以看到这两个方法，共用一个链接, 但是却是不同的业务。

这两个方法上面的注解，还可以用下面这种写法：

@RequestMapping(name= "/demo", method = RequestMethod.GET);
@RequestMapping(name= "/demo", method = RequestMethod.POST);

通过这种方法也可以显式地说明要接收的类型。

除了使用get和post，其实还有以下几种注解适用于RESTful风格：

@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
@PatchMapping

看完这些，再重新理解一下这段话：

客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源；


通过操作资源的表现形式来操作资源；

这就是最简单应用RESTful风格的场景。

三、@PathVariable简单介绍

在一些描述RESTful风格的文章中，我们经常在形参列表中发现@PathVariable这么个注解。顺便做个记录吧。要说起它来，建议和@RequestParam对比学习。下面有一篇文章链接，详细说明了@RequestParam和@PathVariable的区别

@RequestParam和@PathVariable的用法与区别

简单说来, PathVariable英文直译是路径变量, 它可以接收请求路径中占位符的值，
RequestParam就负责接收前端传来的形如 name=value 的键值对。

以上是我的个人见解，欢迎大家讨论，指正。