是否有一份关于在服务器端使用不同基于python的REST框架来编写自己的RESTful api的推荐列表?最好有正反两面。

请随意在这里添加建议。:)


当前回答

我看不出有什么理由只用Django来公开REST api,有更轻、更灵活的解决方案。Django为表提供了许多其他的东西,这些东西并不总是需要的。如果您只想将某些代码公开为REST服务,则肯定不需要。

我个人的经验是,一旦你有了一个一刀切的框架,你就会开始使用它的ORM,它的插件等,因为它很简单,很快你就会有一个很难摆脱的依赖。

选择一个web框架是一个艰难的决定,我不会为了公开一个REST api而选择一个完整的堆栈解决方案。

现在,如果你真的需要/想要使用Django,那么对于Django应用来说,活塞是一个很好的REST框架。

也就是说,CherryPy看起来也很不错,但看起来更像是RPC而不是REST。

看看这些示例(我从未使用过),如果您只需要REST,那么web.py可能是最好和最干净的。

其他回答

在设计RESTful API时需要注意的是GET和POST的合并,就好像它们是同一件事一样。Django的基于函数的视图和CherryPy的默认分派器很容易犯这个错误,尽管这两个框架现在都提供了解决这个问题的方法(分别是基于类的视图和MethodDispatcher)。

http -动词在REST中非常重要,除非非常小心,否则最终会陷入REST反模式。

一些框架是正确的web.py, Flask和Bottle。当与mimerender库结合使用时(完全披露:它是我写的),它们允许你编写漂亮的RESTful webservices:

import web
import json
from mimerender import mimerender

render_xml = lambda message: '<message>%s</message>'%message
render_json = lambda **args: json.dumps(args)
render_html = lambda message: '<html><body>%s</body></html>'%message
render_txt = lambda message: message

urls = (
    '/(.*)', 'greet'
)
app = web.application(urls, globals())

class greet:
    @mimerender(
        default = 'html',
        html = render_html,
        xml  = render_xml,
        json = render_json,
        txt  = render_txt
    )
    def GET(self, name):
        if not name: 
            name = 'world'
        return {'message': 'Hello, ' + name + '!'}

if __name__ == "__main__":
    app.run()

服务的逻辑只实现一次,正确的表示选择(Accept报头)+分派到适当的呈现函数(或模板)以一种整洁、透明的方式完成。

$ curl localhost:8080/x
<html><body>Hello, x!</body></html>

$ curl -H "Accept: application/html" localhost:8080/x
<html><body>Hello, x!</body></html>

$ curl -H "Accept: application/xml" localhost:8080/x
<message>Hello, x!</message>

$ curl -H "Accept: application/json" localhost:8080/x
{'message':'Hello, x!'}

$ curl -H "Accept: text/plain" localhost:8080/x
Hello, x!

更新(2012年4月):增加了关于Django基于类的视图,CherryPy的MethodDispatcher和Flask和Bottle框架的信息。问这个问题的时候两者都不存在。

2010年,塔和repoze。bfg社区“联合起来”创建了Pyramid,这是一个基于repoze.bfg的web框架。它保留了其父框架的理念,可用于基于rest的服务。值得一看。

请参阅Python Web Frameworks wiki。

您可能不需要完整的堆栈框架,但剩下的列表仍然相当长。

没想到居然没人提到烧瓶。

from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return "Hello World!"

if __name__ == "__main__":
    app.run()

下面是CherryPy文档中关于REST的讨论:http://docs.cherrypy.org/dev/progguide/REST.html

它特别提到了一个内置的CherryPy dispatcher,称为MethodDispatcher,它基于http -动词标识符(GET, POST等…)调用方法。