Rest(表述性状态转移)

本文的主要内容有：

1.了解Rest

2.了解RESTful WebService

3.使用SpringMvc实现RESTful

------------------------------我是华丽的分割线，下面是正文--------------------------------------------------

1，REST是什么

a，出身：由Roy Thomas Fielding博士于2000年提出

b，全称：Representational state Transfer,称为表象化状态转变，或者表述性状态转移

c，REST是Web服务的一种架构风格

d，使用HTTP、URI等广泛流行的标准和协议

e，轻量级、跨平台、跨语言的架构设计

那么，从上面5点总结来看，REST到底是个什么鬼呢？好了，下面要注意了，重点来了：REST是一种设计风格，它既不是一种标准，也不是一种软件，而是一种思想。它通常使用HTTP、URI和XML、json以及HTML这些现有的流行的协议和标准

2，我们来介绍RESTful是什么？

a，RESTful对应中文是REST式的

b，RESTful WebService 是一种常见的REST的应用，是遵守REST风格以及Web风格的Web服务

c，REST式的Web服务是一种ROA（(Resource-Oriented Architecture，面向资源架构）

2.1REST架构的主要原则

a，网络上的所有资源都可以被抽象为资源（Resource）

b，每个资源都有一个唯一的资源标识符（Resource identifier）

c，同一资源具有多种表现形式，例如xml，json

d，对资源的各种操作不会改变资源的标识符

e，所有的操作都是无状态的（stateless）[无状态：HTTP是无状态协议。无状态是指协议对于事务处理没有记忆能力，如果后续需要前面的信息，则它必须重传，这样可能导致每次连接传送的数据量增大]

f，符合REST原则的架构方式均可被称为RESTful

2.2REST对资源的操作

举例 http://example.com/users/

-GET：表示获取一个资源

-POST：表示创建一个新的资源

-PUT：表示修改一个资源的状态

-DELETE：表示删除一个资源

资源展现：-XML    -JSON

在这里我们回忆一下之前是怎么操作的呢：

http://example.com/users/query/1  GET 表示根据用户id查询用户数据

http://example.com/users/save POST表示新增用户

http://example.com/users/update POST修改用户用户信息

http://example.com/users/delete GET/POST 表示删除用户

请看RESTful的操作

http://example.com/users/1 GET表示根据用户id查询用户信息

http://example.com/users  POST表示新增用户信息

http://example.com/users  PUT 表示修改用户信息

http://example.com/users  DELETE表示删除用户信息

注意：在RESTful请求的路径上，没有资源操作的动词，资源操作的描述

2.3REST接口定义

2.4REST接口设计

首先介绍URL的组成

-网路协议，这里包含http、https

-服务器地址

-接口名称

-？参数列表

其次URL定义限定

-不要使用大写字母

-使用中线-代替下划线——

-参数列表应该被encode过

2.5响应设计

ContentBody仅仅用来传输数据

数据要做到拿来就用的原则，不需要“拆箱”的过程

用来描述数据或者请求的元数据放Header，例如x-Result-Fields

响应示例

2.6指定响应的属性字段

无状态服务器应该允许客户端对数据按需提取，在请求头使用x-result-fields指定数据返回的字段集合

例如：trade有trade_id,trade_name,created_at三个属性，客户端只需其中的trade_id,trade_name两个属性

Request Header

X-Result-Fields：trade_id,trade_name

2.7http常用的响应状态码

200 操作成功

201 对象创建成功

204 操作成功，但是没有响应体

404 资源不存在

500 后台代码错误，服务器内部错误

3.SpringMVC实现RESTful服务
SpringMVC原生态的支持REST风格的架构的设计

所涉及到注解：

-@RequestMapping

-@PathVariable

-@ResponseBody

………

3.1查询资源

3.2新增资源

3.3 更新资源

默认情况下，PUT请求是无法提交表单数据的，需要在web.xml中添加过滤器解决：

<!-- 解决PUT请求无法提交表单数据的问题 -->

<filter>

<filter-name>HttpMethodFilter</filter-name>

<filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>

</filter>

<filter-mapping>

<filter-name>HttpMethodFilter</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

3.4删除资源

需要在web.xml中添加过滤器解决DELETE请求无法提交表单数据的问题：

注意：表单提交的时候，仍然是Post 请求，但是需要多一个请求参数 _method=DELETE

<!--

将POST请求转化为DELETE或者是PUT

要用_method指定真正的请求参数

-->

<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>