RESTful介绍

最新推荐文章于 2024-02-22 09:55:18 发布

原创最新推荐文章于 2024-02-22 09:55:18 发布 · 332 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#RESTful

Openstack 专栏收录该内容

262 篇文章

订阅专栏

本文介绍了RESTful架构的基本概念，解释了资源与表述的概念，并详细阐述了如何通过HTTP操作实现资源的状态转移。此外还介绍了OpenStack中RESTful API的设计与实现方式。

一什么是RESTful

RESTful是目前最流行的一种互联网软件架构。REST（Representational State Transfer，表述性状态转移）一词是由Roy Thomas Fielding在他2000年博士论文中提出，定义了他对互联网软件的架构原则，如果一个架构符合REST原则，则称它为RESTful架构。

RESTful架构一个核心概念是“资源”（Resource）。从RESTful的角度看，网络里的任何东西都是资源，它可以是一段文本、一张图片、一首歌曲、一种服务等，每个资源都对应一个特定的URI（统一资源定位符），并用它进行标示，访问这个URI就可以获得这个资源。

资源可以有多种表现形式，也就是资源的“表述”（Representation），比如一张图片可以使用JPEG格式也可以使用PNG格式。URI只是代表了资源的实体，并不能代表它的表现形式。

互联网中，客户端和服务端之间的互动传递的就只是资源的表述，我们上网的过程，就是调用资源的URI，获取它不同表现形式的过程。这种互动只能使用无状态协议HTTP，也就是说，服务端必须保存所有的状态，客户端可以使用HTTP的几个基本操作，包括GET（获取）、POST（创建）、PUT（更新）与DELETE（删除），使得服务端上的资源发生“状态转化”（State Transfer），也就是所谓的“表述性状态转移”。

二 RESTful路由

Openstack各个项目都提供了RESTful架构的API作为对外提供的接口，而RESTful架构的核心是资源与资源上的操作，Openstack定义了很多资源，并实现了针对这些资源的各种操作函数。Openstack的API服务进程接受到客户端的HTTP请求时，一个所谓的“路由”模块会将请求的URL转换成相应的资源，并路由到合适的操作函数上。

Openstack中所用的路由模块Routes源自于对Rails路由的重新实现。Rails（Ruby on Rails）是Ruby语言的Web开发框架，采用MVC模式，收到HTTP请求后，Rails路由系统会将这个请求指派到对应的Controller。

每个Controller都对应了一个RESTful资源，代表了对该资源的操作集合，其中包含了很多个Action（函数或者说操作），比如index、show、create，destroy等，每个Action都对应着一个HTTP的请求和回应，比如执行“nova list”命令，Nova客户端（novaclient）将这个命令转换成HTTP请求发给Nova的API服务进程，然后被路由到下面的“index”操作。

#nova/api/openstack/compute/servers.py
class Controller(wsgi.Controller):
    @wsgi.serializers(xml=MinimalServersTemplate)
    def index(self, req):
        """给指定用户返回虚拟机的列表."""
        try:
            servers = self._get_servers(req, is_detail=False)
        except exception.Invalid as err:
            raise exc.HTTPBadRequest(explanation=err.format_message())
        return servers