OpenStack设计与实现5——RESTful API和WSGI

简介:

转https://segmentfault.com/a/1190000004361778

Tips:文章为拜读@xingjiarong 后有感而做的分享,先对作者表示感谢,附原文地址:http://blog.csdn.net/xingjiarong

0. 引言

  • 在上一篇博客中我们提到过,OpenStack每个项目内部的服务进程之间是通过消息总线来通讯的,而在各个项目之间则是通过RESTful API来进行通讯的,在这一篇博客中,我们就来详细的讨论一下OpenStack各个项目之间的通讯。

1. 什么是RESTful

  • RESTful是目前最流行的一种互联网软件架构。REST(Representational State Transfer,表述性状态转移),如果一个架构符合REST原则,就称它为RESTful架构。

  • RESTful架构的核心概念就是“资源”,在RESTful的世界里,网络上的所有东西都是资源,比如一段文本,一张图片都可以看作是资源。每一个资源都对应着一个特定的URI(统一资源定位符)并用它进行标记。

  • 每一个资源都有多种表现形式,我们上网的过程,就是调用资源的URI,获取它不同表现形式的过程。也就是说,服务器保存了资源的各种表现形式,客户端可以使用HTTP的几个基本操作,包括GET、POST、PUT等使服务端上的资源发生“状态转化”,这就是为什么叫做“表述性状态转移”。

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

  • 我们以nova list命令为例来看一下具体的流程。

    1. 首先客户端使用http发送请求,说明要调用nova list命令了。

    2. Rails是OpenStack所使用的路由模块,收到HTTP请求后,将这个请求指派到对应的Controller,并且绑定一个action。

    3. 每个Controller都对应了一个RESTful资源,代表了对该资源的操作集合,其中包含了很多Action。因为Rails指定了要执行index的action,所以该Controller就调用index函数。

2. 什么是WSGI

  • RESTful只是设计风格而不是标准,而WSGI(Web Server Gateway Interface,Web 服务器网关接口)则是python语言中所定义的Web服务器和Web应用程序之间或框架之间的通用接口标准。

  • WSGI就是一座桥梁,桥梁的一端称为服务端或网关端,另一端称为应用端或者框架端,WSGI的作用就是在协议之间进行转化。

  • WSGI将Web组件分成了三类:Web 服务器(WSGI Server)、Web中间件(WSGI Middleware)与Web应用程序(WSGI Application)。

  • Web Server接收HTTP请求,封装一系列环境变量,按照WSGI接口标准调用注册的WSGI Application,最后将响应返回给客户端。

  • WSGI Application是一个可被调用的Python对象,它接受两个参数,通常为environ和start_response。比如:

    def application(environ, start_response):
    start_response('200 OK', [('Content-Type', 'text/plain')])
    yield 'Hello World\n'

  • 参数environ指向一个python字典,要求里面至少包含了一些在CGI中定义的环境变量已经WSGI所定义的环境变量,WSGI应用可以从environ中获取相对应的请求及其执行上下文的所有信息。

  • 参数start_response指向一个回调函数,回调函数负责执行客户端的请求并且返回结果。当有请求到来时,WSGI Server会准备好environ和start_response参数,然后调用WSGI Application获得对应请求的响应。

  • WSGI中间件同时实现了服务端和应用端的API,因此可以在两端之间起协调作用。从服务器看起来,中间件就是一个WSGI应用;从应用端看起来,中间件则是一个WSGI服务器。WSGI中间件可以将客户端的HTTP请求路由给不同的应用对象,然后将应用处理后的结果返回给客户端。我们可以将WSGI中间件理解为服务端和应用端交互的一层包装,经过不同中间件的包装,便具有不同的功能。

3. Paste和Webob

  • Paste和Webob是与OpenStack密切相关的两个组件。

3.1 Paste

  • OpenStack使用Paste的Deploy组件来完成WSGI服务器和应用的构建,每个项目源码etc目录下都有一个Paste配置文件,例如nova中的,如下图所示。

  • Paste配置文件分为过个section,每个section以type:name的格式命名,具体的可以参考官网源码。使用Paste Deploy的主要目的就是从配置文件中生成一个WSGI Application,有了配置文件之后,只需要使用下面的调用方式:

    wsgi_app = loadapp('config:/path/to/config.ini')

3.2 Webob

    • Webob通过对WSGI的请求与响应进行封装来简化WSGI应用的编写。Webob中两个最重要的对象,一是webob.Request,对WSGI请求的environ参数进行封装,一是webob.Response,包含了标准WSGI响应的所有要素。来看一个例子:

    • 原始的WSGI格式:
      app_iter = myfunc(environ, start_response)

    • 使用webob封装之后:
      def myfunc(req):
      return webob.Response('hey there')
      resp = myfunc(req)

本文转自茄子_2008博客园博客,原文链接:http://www.cnblogs.com/xd502djj/p/7570786.html,如需转载请自行联系原作者。

目录
相关文章
|
XML JSON API
识别这些API接口定义(http,https,api,RPC,webservice,Restful api ,OpenAPI)
本内容介绍了API相关的术语分类,包括传输协议(HTTP/HTTPS)、接口风格(RESTful、WebService、RPC)及开放程度(API、OpenAPI),帮助理解各类API的特点与应用场景。
|
缓存 安全 API
RESTful与GraphQL:电商API接口设计的技术细节与适用场景
本文对比了RESTful与GraphQL这两种主流电商API接口设计方案。RESTful通过资源与HTTP方法定义操作,简单直观但可能引发过度或欠获取数据问题;GraphQL允许客户端精确指定所需字段,提高灵活性和传输效率,但面临深度查询攻击等安全挑战。从性能、灵活性、安全性及适用场景多维度分析,RESTful适合资源导向场景,GraphQL则适用于复杂数据需求。实际开发中需根据业务特点选择合适方案,或结合两者优势,以优化用户体验与系统性能。
|
JSON 编解码 API
Go语言网络编程:使用 net/http 构建 RESTful API
本章介绍如何使用 Go 语言的 `net/http` 标准库构建 RESTful API。内容涵盖 RESTful API 的基本概念及规范,包括 GET、POST、PUT 和 DELETE 方法的实现。通过定义用户数据结构和模拟数据库,逐步实现获取用户列表、创建用户、更新用户、删除用户的 HTTP 路由处理函数。同时提供辅助函数用于路径参数解析,并展示如何设置路由器启动服务。最后通过 curl 或 Postman 测试接口功能。章节总结了路由分发、JSON 编解码、方法区分、并发安全管理和路径参数解析等关键点,为更复杂需求推荐第三方框架如 Gin、Echo 和 Chi。
|
缓存 边缘计算 前端开发
从业务需求到技术栈:电商API选型RESTful还是GraphQL?这5个维度帮你决策
在数字经济时代,电商平台的竞争已延伸至用户体验与系统效能。作为连接前后端及各类服务的核心,API接口的架构设计至关重要。本文对比RESTful与GraphQL两大主流方案,从电商场景出发,分析两者的技术特性、适用场景与选型逻辑,帮助开发者根据业务需求做出最优选择。
|
XML JSON API
Understanding RESTful API and Web Services: Key Differences and Use Cases
在现代软件开发中,RESTful API和Web服务均用于实现系统间通信,但各有特点。RESTful API遵循REST原则,主要使用HTTP/HTTPS协议,数据格式多为JSON或XML,适用于无状态通信;而Web服务包括SOAP和REST,常用于基于网络的API,采用标准化方法如WSDL或OpenAPI。理解两者区别有助于选择适合应用需求的解决方案,构建高效、可扩展的应用程序。
|
机器学习/深度学习 设计模式 API
Python 高级编程与实战:构建 RESTful API
本文深入探讨了使用 Python 构建 RESTful API 的方法,涵盖 Flask、Django REST Framework 和 FastAPI 三个主流框架。通过实战项目示例,详细讲解了如何处理 GET、POST 请求,并返回相应数据。学习这些技术将帮助你掌握构建高效、可靠的 Web API。
|
JSON JavaScript 前端开发
深入浅出Node.js:从零开始构建RESTful API
在数字化时代的浪潮中,后端开发作为连接用户与数据的桥梁,扮演着至关重要的角色。本文将引导您步入Node.js的奇妙世界,通过实践操作,掌握如何使用这一强大的JavaScript运行时环境构建高效、可扩展的RESTful API。我们将一同探索Express框架的使用,学习如何设计API端点,处理数据请求,并实现身份验证机制,最终部署我们的成果到云服务器上。无论您是初学者还是有一定基础的开发者,这篇文章都将为您打开一扇通往后端开发深层知识的大门。
539 12
|
API Java 运维
优秀API设计的十大原则
优秀API设计的十大原则 2015-09-23    分类:编程开发、设计模式、首页精华暂无人评论 分享到:更多4 二十万年薪PHP工程师培养计划 成为被疯抢的Android牛人 风中叶讲Java重难点 Linux运维基础课程 本文由码农网 – 小峰原创翻译,转载请看清文末的转载要求,欢迎加入技术翻译小组! 每个软件开发人员都使用API。
1307 0