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

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接口 ~

我对他的理解还是有些片面，有时间再好好看看。