Eve是一款Python的REST API框架，用于构建和部署高可定制的、全功能的RESTful的Web服务。Eve是一个开源项目，遵循BSD开源协议，已在Python 2.6、2.7以及Python 3.3版本下进行了非常全面的测试。
特色
强调REST
非常全面的CRUD操作
可自定义的资源端点
自定义多个项目端点
筛选和排序
分页
HATEOAS
JSON和XML渲染
条件请求
数据完整性和并发控制
多个添加操作
数据验证
可扩展的数据验证
资源级缓存控制
版本
验证
CORS跨地资源共享
默认情况下只读
默认值
预定义的数据库过滤器
预测
事件关联
速率限制
MongoDB支持
和别的框架一样，咱们需要安装eve的模块
直接yum安装吧，我自己选择mongodb的时候，都会用10gen的。
cat /etc/yum.repos.d/10gen.repo
|
1
2
3
4
|
[10gen]
name=10gen Repository
baseurl=http:
//downloads-distro.mongodb.org/repo/redhat/os/x86_64
gpgcheck=
0
|
开始安装吧~
好了，咱们现在就测试下吧：
启动server.py还需要做的就是配上一个数据库、配置文件（默认是settings.py）、启动脚本来让API可以在线使用。总之，你会发现，配置和调优API是一件非常简单的事情。
server端
客户端
官方还推荐了一个eve demo
https://github.com/nicolaiarocci/eve-demo
demo里面有几个实例 ~
返回是可以定义的：
xml
|
1
|
curl -H
"Accept: application/xml"
-i
"http://127.0.0.1:5000/"
|
json
|
1
|
curl
-
H
"Accept: application/json"
-
i
"http://127.0.0.1:5000/"
|
在这定义规则啥的 ~
Here is how the complete people definition looks in our updated settings.pyfile:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
people = {
#
'title'
tag used
in
item links. Defaults to the resource title minus
# the
final
, plural
's'
(works fine
in
most cases but not
for
'people'
)
'item_title'
:
'person'
,
# by
default
the standard item entry point
is
defined
as
#
'/people/<ObjectId>'
. We leave it untouched, and we also enable an
# additional read-only entry point. This way consumers can also perform
# GET requests at
'/people/<lastname>'
.
'additional_lookup'
: {
'url'
:
'[\w]+'
,
'field'
:
'lastname'
},
# We choose to
override
global cache-control directives
for
this
resource.
'cache_control'
:
'max-age=10,must-revalidate'
,
'cache_expires'
:
10
,
# most global settings can be overridden at resource level
'resource_methods'
: [
'GET'
,
'POST'
],
'schema'
: schema
}
|
插入数据~
|
1
|
curl -d
'[{"firstname": "rui", "lastname": "fengyun"}, {"firstname": "li", "lastname": "liying"}]'
-H
'Content-Type: application/json'
http:
//127.0.0.1:5000/people
|
查询数据~
|
1
|
curl
-
i http:
/
/
eve
-
demo.herokuapp.com
/
people?where
=
{
"lastname"
:
"liying"
}
|
我们从mongo的cli中瞅瞅,看看数据
In the above response, a Last-Modified header is included. It can be used later to retrieve only the items that have changed since:
|
1
|
curl -H
"If-Modified-Since: Wed, 05 Dec 2012 09:53:07 UTC"
-i http:
//127.0.0.1:5000/people/
|
eve 其实在一定程度上可以理解为mongodb的http接口 就是redis的webdis一样的
类似mysql的取出lastname字段为Doe的数据
$ curl -i http://eve-demo.herokuapp.com/people?where={"lastname": "Doe"}
and the native Python syntax:
$ curl -i http://eve-demo.herokuapp.com/people?where=lastname=="Doe"
排序的方式
$ curl -i http://eve-demo.herokuapp.com/people?sort=[("lastname", -1)]
可以做出mongodb limit 的效果
$ curl -i http://eve-demo.herokuapp.com/people/?where={"lastaname": "Doe"}&sort=[("firstname",1)]&page=5
多次插入数据
$ curl -d 'item1={"firstname": "barack", "lastname": "obama"}' -d 'item2={"firstname": "mitt", "lastname": "romney"}' http://127.0.0.1/people
Response:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
{
[
"status"
:
"OK"
,
"updated"
:
"Thu, 22 Nov 2012 15:22:27 UTC"
,
"_id"
:
"50ae43339fa12500024def5b"
,
"_links"
: {
"self"
: {
"href"
:
"eve-demo.herokuapp.com/people/50ae43339fa12500024def5b"
,
"title"
:
"person"
}}
],
[
"status"
:
"OK"
,
"updated"
:
"Thu, 22 Nov 2012 15:22:27 UTC"
,
"_id"
:
"50ae43339fa12500024def5c"
,
"_links"
: {
"self"
: {
"href"
:
"eve-demo.herokuapp.com/people/50ae43339fa12500024def5c"
,
"title"
:
"person"
}}
]
}
|
总结： eve是个强大又可以扩展res框架，也可以把他用为mongodb的http接口 ~
我对他的理解还是有些片面，有时间再好好看看。
