python Eve RESTFul 尝试笔记 python, 项目

我是MT

0.前言最近重点研究了yeelink平台的原理和使用，yeelink平台和多数云平台设计一样应用了RESTFul框架。嵌入式侧（或者是客服端侧）的相关技术研究的比较充分（个人这么认为），是不是该弄弄服务器侧的技术了！实现RESTFul的框架有很多，在这里我选择python的Eve框架，先从该框架入手学起。
Eve是一款Python的REST API框架，用于构建和部署高可定制的、全功能的RESTful的Web服务。Eve是一个开源项目，遵循BSD开源协议，已在Python 2.6、2.7以及Python 3.3版本下进行了非常全面的测试。（来自CSDN）


0.1 前提条件使用Eve框架之前，需要安装python、cURL、MongoDB等工具，并且需要保证MongoDB处于运行状态。python和cURL的安装请google或百度查找相关资料。


1.安装esay_installEve框架的安装可使用pip工具或者easy_install，本文选择easy_install。安装esay_install可至以下网址下载ez_setup.py
复制ez_setup.py至硬盘中的某位置，例如保存至E:\temp。然后运行运行便执行整个下载和安装过程，最后会在D:\Python27\Scripts出现easy_install.exe。(注意使用CD命令之前，需要修改盘符，修改盘符可输入E:或F
【如果安装过程出现问题尤其是网络问题，请参考博文再尝试一下】

图1.1 运行ez_setup.py

a）假设python已安装于D:\Python27，若要添加该目录至环境变量。
b）easy_install.exe位于D:\Python27\Scripts目录，同样需要添加该目录至环境变量。

图1.2 修改环境变量

最后在控制台中输入命令便可完成Eve框架的安装
easy_install eve


2.安装MongoDBEve框架需要MongoDB的支持，MongoDB的安装和初步使用可【参考博文】
请注意为了更方便的使用MongoDB可把MongoDB的bin目录加入环境变量。
启动MongoDB时刻指定数据目录，例如数据目录位于D:\MongoDB\data，可通过dbpath参数设置。
mongod --dbpath D:\MongoDB\data

图2.1 启动mongoDB服务

3.快速开始新建一个名为run.py的文件，具体代码如下：
[python] view plaincopy

• from eve import Eve  
• app = Eve()  
• if __name__ == '__main__':  
•     app.run()  

再新建一个名为settings.py的文件，和run.py存放与同一个路径下，具体代码如下：
[cpp] view plaincopy

• SERVER_NAME = '127.0.0.1:5000'
  
• DOMAIN = {  
•     'people': {},  
• }  

虽然现在还无法理解Eve框架的种种细节，但是至少从settings代码中可以发现，现在的RESTFul服务主机为localhost，端口号为5000。运行run.py（注意运行run.py之前一定要开启mongoDB服务，请参考上一小节内容）

图3.1 Eve框架开始运行

此时若使用cURL工具测试当前的RESTFul API。请注意要使用cURL工具时需要重新打开一个windows控制台，MongoDB 服务和Eve RESTFul服务的控制台均需要保持打开状态。可以输入：

curl -i http://127.0.0.1:5000

图3.2 cURL请求和返回结果

该例子的返回结果并没有特殊的含义，而返回的内容中包括可选的HATEOAS（该部分还需要研究，计算机或者互联网往往充斥着非常多的概念）。


4.总结虽然例子没有什么特别的含义，但是可以看出MongoDB和Eve的RESTFul服务已经运行成功。未来几天还将总结一些简单的例子，希望本篇博文对各位有帮助。