当前位置: 首页 > 工具软件 > rest-hapi > 使用案例 >

第8章-使用Express.js和Hapi构建Node.js-REST-API服务-8.1.REST(表述性状态传递)Representational State Transfer

夏炎彬
2023-12-01

REST:
即表述性状态传递(英文:Representational State Transfer,简称REST)是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。它是一种针对网络应用的设计和开发方式,可以降低开发的复杂性,提高系统的可伸缩性。目前在三种主流的Web服务实现方案中,因为REST模式的Web服务与复杂的SOAP和XML-RPC对比来讲明显的更加简洁,越来越多的web服务开始采用REST风格设计和实现。例如,Amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。

在当下的Web开发中,瘦客户端和瘦服务端的架构变得越来越流行,
瘦客户端一般基于Backbone.js、Anglers JS、Ember.js等框架构建,
而瘦服务端通常代表着REST风格的Web API服务。
这种模式现在越来越流行,已经有Parse.com等不少网站选择尝试把后端建成服务的形式。

一、优点

1.只需要一套REST API接口,便可以同时为多种客户端提供服务,其中也包括Web应用(还有移动端以及第三方应用等)
2.把客户端和服务分离开还有一点好处,以后更换客户端时不会影响到核心的业务逻辑,同样,更换服务端也不会。
3.由于用户界面(UI/UX)本身是难以进行自动化测试的,尤其是使用了事件驱动的用户界面以及单页面应用等,同时跨浏览器情形更加大了测试的难度。但是,当我们把业务逻辑分开成不同的后端API之后,对逻辑部分的测试(无论是功能测试还是单元测试)就变得十分容易了。

因此,现在许多新项目都选择使用REST API加客户端的方式进行开发。虽然有些项目开发初期只需要Web端,但是开发者应该会预见到,当项目需要再开发新的客户端时,他们可以省去不少重复性的工作。

二、RESTful API基础

分布式系统的逐渐增多,促进了RESTful API的流行,因为在分布式系统中,每次请求都需要携带关于客户端的足够的信息。
从某种意义上讲,RESTful是无状态的,因为没有任何关于客户端状态的信息被存储在服务器上,这样也就保证了每次请求都能够被任意服务器处理,而得到相同的结果。

RESTful的独立特性包括以下几种(换句话说,如果API是RESTful的,他通常会遵循这些原则):
1.RESTful API具有更好的可扩展性的支持,因为不同的组件可以独立部署到不同的服务器上
2.他使用简单的动作和内容替换SOAP(Simple Object Access Protocol)协议
3.他使用不同的HTTP请求方式,如GET、POST、DELETE、PUT、OPTIONS等
4.JSON并不是唯一可选的内容格式(不过他是最流行的)、可选的格式还有可扩展标记语言(Extensible Markup Language,XML)、逗号分割值(comma-separated values,CSV)等。这一点不同于SOAP,后者是一种协议,而RESTful作为一种设计风格,在内容格式的选择上更加灵活

REST API风格的CURD操作示例:
请求方法
URL
含义
GET
/message.json
以JSON格式返回消息列表
PUT
/message.json
更新全部消息,并以JSON格式返回操作结果
POST
/message.json
新建消息,并以JSON格式返回消息ID
GET
/message.json/{id}.json
以JSON格式返回ID为{id}的消息
PUT
/message.json/{id}.json
更新ID为{id}的消息,如果消息不存在则创建他
DELETE
/message.json/{id}.json
删除ID为{id}的消息,并以JSON格式返回操作结果

REST并不是一种协议,他是一种架构,相比我们熟悉的SOAP等协议,他更加灵活。
REST API的地址可以类似这种/messages/list.html或者这种/messages/list.xml,他取决于我们期望使用的内容格式。

GET、PUT和DELETE请求是幂等的,换句话说,当服务器收到多条相同的请求时,均能得到相同的结果。
POST请求是非幂等的,所以重复请求可能会引发状态改变或其他未知异常。

我们实现REST API服务器时利用Express.js中间件的app.param()和app.use()方法,执行CURD操作。
所以,我们的应用需要能够处理以下几种地址格式的请求,并返回JSON格式的数据(collectionName代表了集合,如消息、评论、用户等)
1.POST:/collections/{collectionName}:请求创建一个对象,返回新建对象的ID
2.GET:/collections/{collectionName}/{id}:根据请求ID返回查询到的对象
3.GET:/collections/{collectionName}/:请求返回集合中的全部元素,在这个例子中,限制最多返回10个元素,并根据ID排序
4.PUT:/collections/{collectionName}/{id}:根据请求ID更新相应的对象
5.DELETE:/collections/{collectionName}/{id}:根据请求ID删除相应的对象

 类似资料: